Criar ou atualizar o idioma

Namespace: microsoft.graph

Esse método é usado para criar ou atualizar uma linguagem personalizada em uma Azure AD fluxo de usuário B2C.

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

Permissões

Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas 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 privilegiadas mais altas
Delegado (conta corporativa ou de estudante)	IdentityUserFlow.ReadWrite.All	Indisponível.
Delegado (conta pessoal da Microsoft)	Sem suporte.	Sem suporte.
Aplicativo	IdentityUserFlow.ReadWrite.All	Indisponível.

A conta corporativa ou de estudante precisa pertencer ao menos à função Administrador de Fluxo de Usuário de ID ExternaMicrosoft Entra funçã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 Linguagem documentada. Se fornecido no corpo da solicitação, ele deverá corresponder ao identifer fornecido na URL de solicitação.
isEnabled	Booliano	Indica se o idioma está habilitado no fluxo de 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 201 Created código de resposta e um objeto userFlowLanguageConfiguration no corpo da resposta.

Exemplos

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

Solicitação

O exemplo a seguir mostra uma solicitação.

HTTP

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

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

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const userFlowLanguageConfiguration = {
  id: 'es-ES',
  isEnabled: true
};

await client.api('/identity/b2cUserFlows/B2C_1_CustomerSignUp/languages/es-ES')
	.version('beta')
	.put(userFlowLanguageConfiguration);

Importante

Os SDKs do Microsoft Graph usam a versão v1.0 da API por padrão e não oferecem suporte a todos os tipos, propriedades e APIs disponíveis na versão beta. Para obter detalhes sobre como acessar a API beta com o SDK, consulte Usar os SDKs do Microsoft Graph com a API beta.

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

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 B2C Azure AD

Solicitação

O exemplo a seguir mostra uma solicitação.

HTTP

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

{
  "isEnabled": false
}

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const userFlowLanguageConfiguration = {
  isEnabled: false
};

await client.api('/identity/b2cUserFlows/B2C_1_CustomerSignUp/languages/es-ES')
	.version('beta')
	.put(userFlowLanguageConfiguration);

Importante

Os SDKs do Microsoft Graph usam a versão v1.0 da API por padrão e não oferecem suporte a todos os tipos, propriedades e APIs disponíveis na versão beta. Para obter detalhes sobre como acessar a API beta com o SDK, consulte Usar os SDKs do Microsoft Graph com a API beta.

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content