Erstellen von organizationalBrandingLocalization
Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta
Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
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 können nur Benutzer mit der Rolle OrganisationsbrandingadministratorMicrosoft Entra das Branding des organization vollständig verwalten.
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 | String | Ein Bezeichner, der das mithilfe von Kulturnamen angegebene Gebietsschema darstellt. Kulturnamen folgen dem RFC 1766-Standard im Format "languagecode2-country/regioncode2". Der Teil "languagecode2" ist ein aus ISO 639-1 abgeleiteter Kleinbuchstabencode aus zwei Buchstaben, und "country/regioncode2" ist ein aus ISO 3166 abgeleiteter Code in Großbuchstaben. 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. HINWEIS: 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/beta/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/beta/$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,
"squareLogoDarkRelativeUrl": null,
"usernameHintText": " "
}
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für