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.
Weltweiter Service | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
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) | OrganizationalBranding.ReadWrite.All | Organization.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | OrganizationalBranding.ReadWrite.All | Organization.ReadWrite.All |
Wichtig
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 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", 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": ""
}