Erstellen von organizationalBrandingLocalization
Namespace: microsoft.graph
Erstellen Sie ein neues organizationalBrandingLocalization-Objekt . Dadurch wird ein lokalisiertes Branding und gleichzeitig das Standardbranding erstellt, wenn es nicht vorhanden ist.
Das Standardbranding wird nur einmal erstellt. Es wird geladen, wenn kein lokalisiertes Branding für die Browsersprache des Benutzers konfiguriert ist. Informationen zum Abrufen des Standardbrandings finden Sie unter Abrufen von Branding.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. 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) | OrganizationalBranding.ReadWrite.All | Organization.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | OrganizationalBranding.ReadWrite.All | Organization.ReadWrite.All |
In delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten muss dem angemeldeten Benutzer eine unterstützte Microsoft Entra-Rolle oder eine benutzerdefinierte Rolle mit einer unterstützten Rollenberechtigung zugewiesen werden. Der Organisationsbrandingadministrator ist die Rolle mit den geringsten Berechtigungen, die für diesen Vorgang unterstützt wird.
HTTP-Anforderung
Diese Anforderung erstellt ein neues Lokalisierungsbranding und ein Standardbranding, falls noch keins vorhanden ist.
POST /organization/{organizationId}/branding/localizations
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Content-Type | application/json. Erforderlich. |
Anforderungstext
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen des organizationalBrandingLocalization-Objekts erforderlich sind.
Eigenschaft | Typ | Beschreibung |
---|---|---|
id | Zeichenfolge | Ein Bezeichner, der das mithilfe von Kulturnamen angegebene Gebietsschema darstellt. Kulturnamen folgen dem RFC 1766-Standard im Format "languagecode2-country/regioncode2", wobei "languagecode2" ein aus ISO 639-1 abgeleiteter Kleinbuchstabencode ist und "country/regioncode2" ein aus ISO 3166 abgeleiteter Code in Großbuchstaben ist. Beispielsweise ist en-US US-Englisch . Sie können das Standardbranding nicht erstellen, indem Sie den Wert von id auf die Zeichenfolgentypen 0 oder default festlegen. ANMERKUNG: Mehrere Brandings für ein einzelnes Gebietsschema werden derzeit nicht unterstützt. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode den 201 Created
Antwortcode und ein organizationalBrandingLocalization-Objekt im Antworttext zurück.
Beispiele
Im folgenden Beispiel wird eine Brandinglokalisierung für die Französische Lokalisierung (fr-FR
) erstellt. Alle nicht angegebenen Eigenschaften des String-Typs erben vom Wert im Standardbrandingobjekt. Wenn der signInPageText im Standardbrandingobjekt beispielsweise ist, lautet null
der signInPageText für das fr-FR
in dieser Anforderung erstellte Branding ebenfalls null
. Um einen null
Wert ohne Text zu überschreiben, verwenden Sie eine Zeichenfolge, die nur Leerzeichen enthält.
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
POST https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations
Content-Type: application/json
{
"backgroundColor":"#00000F",
"id": "fr-FR",
"signInPageText": " "
}
Antwort
Das folgende Beispiel zeigt die Antwort.
HTTP/1.1 201 Created
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#organization('d69179bf-f4a4-41a9-a9de-249c0f2efb1d')/branding/localizations/$entity",
"@odata.id": "https://graph.microsoft.com/v2/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/directoryObjects/$/Microsoft.DirectoryServices.Organization('d69179bf-f4a4-41a9-a9de-249c0f2efb1d')//localizations/fr-FR",
"id": "fr-FR",
"backgroundColor": "",
"backgroundImageRelativeUrl": null,
"bannerLogoRelativeUrl": null,
"cdnList": [],
"signInPageText": " ",
"squareLogoRelativeUrl": null,
"usernameHintText": ""
}