Sprache erstellen oder aktualisieren

Namespace: microsoft.graph

Diese Methode wird verwendet, um eine benutzerdefinierte Sprache in einem Azure AD B2C-Benutzerflow zu erstellen oder zu aktualisieren.

Hinweis: Sie müssen die Sprachanpassung im Azure AD B2C-Benutzerflow aktivieren, bevor Sie eine benutzerdefinierte Sprache erstellen können. Weitere Informationen finden Sie unter Aktualisieren von b2cIdentityUserFlow.

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) IdentityUserFlow.ReadWrite.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application IdentityUserFlow.ReadWrite.All Nicht verfügbar.

Wichtig

Für den delegierten Zugriff mit Geschäfts-, Schul- oder Unikonten muss dem angemeldeten Benutzer eine unterstützte Microsoft Entra-Rolle oder eine benutzerdefinierte Rolle zugewiesen werden, die die für diesen Vorgang erforderlichen Berechtigungen gewährt. External ID User Flow Administrator ist die Rolle mit den geringsten Berechtigungen, die für diesen Vorgang unterstützt wird.

HTTP-Anforderung

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

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des userFlowLanguageConfiguration-Objekts an.

Die folgende Tabelle zeigt die Eigenschaften, die optional beim Erstellen der userFlowLanguageConfiguration bereitgestellt werden können.

Eigenschaft Typ Beschreibung
id Zeichenfolge Der Bezeichner der Sprache. Dieses Feld ist mit dem Sprach-ID-Tag RFC 5646 kompatibel und muss eine dokumentierte Sprach-ID sein. Wenn im Anforderungstext angegeben, muss er mit dem in der Anforderungs-URL angegebenen Identifikator übereinstimmen.
isEnabled Boolescher Wert Gibt an, ob die Sprache im Benutzerfluss aktiviert ist. Wenn Sie in der Anforderung keinen Wert für diese Eigenschaft angeben, wird isEnabled auf "true" festgelegt.

Antwort

Bei erfolgreicher Ausführung gibt diese Methode einen 201 Created Antwortcode und ein userFlowLanguageConfiguration-Objekt im Antworttext zurück.

Beispiele

Beispiel 1: Erstellen einer benutzerdefinierten Sprache in einem Azure AD B2C-Benutzerflow

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

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

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

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

Beispiel 2: Aktualisieren einer benutzerdefinierten Sprache in einem Azure AD B2C-Benutzerablauf

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

{
  "isEnabled": false
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content
  • Zuletzt aktualisiert um