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-USUS-Englisch . Sie können das Standardbranding nicht erstellen, indem Sie den Wert von id auf die Zeichenfolgentypen 0 oder defaultfestlegen.

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 nullder 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": ""
}