Em nossa versão de abril de 2022, fizemos algumas alterações nos grupos para resolver problemas com tempos limite enquanto os grupos estavam sendo criados no Brightspace. As alterações que fizemos significaram que a criação de categorias de grupo, seus grupos filho e quaisquer registros agora são processados por uma tarefa em segundo plano, garantindo que os grupos sejam sempre criados com êxito e que seus registros sejam processados conforme o esperado todas as vezes. Anteriormente, você pode ter visto falhas ao criar categorias de grupo, tornando o método mais antigo de criação não confiável. No momento, essas alterações são aplicadas apenas à criação de grupos na interface do Brightspace – na ferramenta Grupos.
Em nossa versão de junho de 2022, ou 20.22.06, faremos a mesma alteração em nossas APIs de criação de grupo para fornecer os mesmos benefícios a esse meio de criação de grupo. A partir de junho, quando você usar a rota da API 'POST /d2l/api/lp/(version)/(orgUnitId)/groupcategories/' para criar uma nova categoria de grupo em uma unidade organizacional, você receberá uma resposta de código de status diferente – um 202 Aceito – que indicaria que sua solicitação foi aceita, mas ainda não foi concluída. Em seguida, você poderá usar uma nova rota de API para verificar o status da solicitação de criação da categoria de grupo para garantir que ela tenha sido concluída com êxito. Os usuários que postam nessa API normalmente teriam visto uma mensagem de status 200 OK se a ação tivesse sido bem-sucedida.
Quaisquer rotas de API, como chamadas PUT, POST ou DELETE na criação da categoria de grupo atualmente em processamento, falhariam com uma nova resposta de código de status – um Conflito 409 – indicando que a criação da categoria de grupo ainda não foi concluída e nenhuma alteração pode ser feita na categoria de grupo no momento.
Por que estamos fazendo essa mudança?
Para que possamos mudar para um meio mais robusto de criar grupos e fornecer os benefícios que o novo método de criação em segundo plano nos oferece, precisamos garantir que essa alteração seja aplicada a todos os métodos de criação de grupos, tanto na interface do usuário quanto por meio de nossas APIs no momento.
O que isso significa para mim?
Se você usar nossa API de categoria de grupo como parte de seu processo para criar grupos dentro de unidades organizacionais, precisará esperar uma resposta de código de status diferente e ser capaz de lidar com isso com sucesso.