Criar ou atualizar idioma

Namespace: microsoft.graph

Esse método é usado para criar ou atualizar um idioma personalizado em um fluxo de usuário do Azure AD B2C.

Observação: Você deve habilitar a personalização de idioma no fluxo de usuário do Azure AD B2C antes de criar um idioma personalizado. Para obter mais informações, consulte Atualizar b2cIdentityUserFlow.

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissões menos privilegiadas Permissões com privilégios mais elevados
Delegado (conta corporativa ou de estudante) IdentityUserFlow.ReadWrite.All Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application IdentityUserFlow.ReadWrite.All Indisponível.

Importante

Para acesso delegado usando contas corporativas ou de estudante, o usuário conectado deve receber uma função do Microsoft Entra com suporte ou uma função personalizada que conceda as permissões necessárias para esta operação. O Administrador de fluxo de usuário de ID externa é a função com menos privilégios com suporte para essa operação.

Solicitação HTTP

PUT /identity/b2cUserFlows/{id}/languages/{id}

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON do objeto userFlowLanguageConfiguration .

A tabela a seguir mostra as propriedades que podem ser fornecidas opcionalmente quando você cria o userFlowLanguageConfiguration.

Propriedade Tipo Descrição
id Cadeia de caracteres O identificador do idioma. Este campo é compatível com a marca de ID de idioma RFC 5646 e deve ser uma ID de idioma documentada. Se fornecido no corpo da solicitação, ele deverá corresponder ao identificador fornecido na URL da solicitação.
isEnabled Booliano Indica se o idioma está habilitado no fluxo do usuário. Se você não especificar um valor para essa propriedade na solicitação, isEnabled será definido como "true".

Resposta

Se for bem-sucedido, esse método retornará um código de 201 Created resposta e um objeto userFlowLanguageConfiguration no corpo da resposta.

Exemplos

Exemplo 1: Criar um idioma personalizado em um fluxo de usuário do Azure AD B2C

Solicitação

O exemplo a seguir mostra uma solicitação.

PUT https://graph.microsoft.com/beta/identity/b2cUserFlows/B2C_1_CustomerSignUp/languages/es-ES
Content-Type: application/json

{
  "id": "es-ES",
  "isEnabled": true
}

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#identity/b2cUserFlows('B2C_1_CustomerSignUp')/languages/$entity",
  "id": "es-ES",
  "isEnabled": true,
  "displayName": "Spanish (Spain)"
}

Exemplo 2: Atualizar um idioma personalizado em um fluxo de usuário do B2C do Azure AD

Solicitação

O exemplo a seguir mostra uma solicitação.

PUT https://graph.microsoft.com/beta/identity/b2cUserFlows/B2C_1_CustomerSignUp/languages/es-ES
Content-Type: application/json

{
  "isEnabled": false
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content
  • Última atualização em