言語の作成または更新

名前空間: microsoft.graph

このメソッドは、Azure AD B2C ユーザー フローでカスタム言語を作成または更新するために使用されます。

手記： カスタム言語を作成する前に、Azure AD B2C ユーザー フローで言語のカスタマイズを有効にする必要があります。 詳細については、「 Update b2cIdentityUserFlow」を参照してください。

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

職場または学校アカウントを使用した委任されたシナリオでは、サインインしているユーザーに、サポートされている Microsoft Entra ロール またはサポートされているロールのアクセス許可を持つカスタム ロールを割り当てる必要があります。 外部 ID ユーザー フロー管理者 は、この操作でサポートされる最小限の特権ロールです。

HTTP 要求

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

要求ヘッダー

要求本文

要求本文で、 userFlowLanguageConfiguration オブジェクトの JSON 表現を指定します。

次の表は、 userFlowLanguageConfiguration を作成するときに必要に応じて指定できるプロパティを示しています。

応答

成功した場合、このメソッドは応答コード 201 Created と、応答本文に userFlowLanguageConfiguration オブジェクトを返します。

例

例 1: Azure AD B2C ユーザー フローでカスタム言語を作成する

要求

次の例は要求を示しています。

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

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

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);

応答

次の例は応答を示しています。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

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)"
}

例 2: Azure AD B2C ユーザー フローでカスタム言語を更新する

要求

次の例は要求を示しています。

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

{
  "isEnabled": false
}

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);

応答

次の例は応答を示しています。

HTTP/1.1 204 No Content