Créer organizationalBrandingLocalization
Espace de noms: microsoft.graph
Créez un objet organizationalBrandingLocalization . Cela crée une personnalisation localisée et, en même temps, la personnalisation par défaut si elle n’existe pas.
La personnalisation par défaut n’est créée qu’une seule fois. Il est chargé lorsqu’une personnalisation localisée n’est pas configurée pour la langue du navigateur de l’utilisateur. Pour récupérer la personnalisation par défaut, consultez Obtenir la personnalisation.
Cette API est disponible dans les déploiements de cloud national suivants.
Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Autorisations
Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.
Type d’autorisation | Autorisations avec privilèges minimum | Autorisations privilégiées plus élevées |
---|---|---|
Déléguée (compte professionnel ou scolaire) | OrganizationalBranding.ReadWrite.All | Organization.ReadWrite.All |
Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
Application | OrganizationalBranding.ReadWrite.All | Organization.ReadWrite.All |
Pour les scénarios délégués, seuls les utilisateurs disposant du rôle Administrateur de personnalisation oragnizationalMicrosoft Entra peuvent gérer entièrement la personnalisation de l’organization.
Requête HTTP
Cette demande crée une personnalisation de localisation et une personnalisation par défaut si elle n’existe pas déjà.
POST /organization/{organizationId}/branding/localizations
En-têtes de demande
Nom | Description |
---|---|
Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
Content-Type | application/json. Obligatoire. |
Corps de la demande
Le tableau suivant répertorie les propriétés requises lorsque vous créez l’objet organizationalBrandingLocalization .
Propriété | Type | Description |
---|---|---|
id | Chaîne | Identificateur qui représente les paramètres régionaux spécifiés à l’aide de noms de culture. Les noms de culture suivent la norme RFC 1766 au format « languagecode2-country/regioncode2 », où « languagecode2 » est un code à deux lettres minuscules dérivé de la norme ISO 639-1 et « country/regioncode2 » est un code majuscule à deux lettres dérivé de la norme ISO 3166. Par exemple, l’anglais américain est en-US . Vous ne pouvez pas créer la personnalisation par défaut en définissant la valeur d’id sur types de 0 chaîne ou default . NOTE: Les personnalisations multiples pour un seul paramètre régional ne sont actuellement pas prises en charge. |
Réponse
Si elle réussit, cette méthode renvoie un 201 Created
code de réponse et un objet organizationalBrandingLocalization dans le corps de la réponse.
Exemples
L’exemple suivant crée une localisation de personnalisation pour Français (fr-FR
). Toutes les propriétés non spécifiées du type String héritent de la valeur dans l’objet de personnalisation par défaut. Par exemple, si signInPageText dans l’objet de personnalisation par défaut est null
, le signInPageText pour la fr-FR
personnalisation créée dans cette requête sera null
également . Pour remplacer une null
valeur sans texte, utilisez une chaîne contenant uniquement des espaces blancs.
Demande
L’exemple suivant illustre une demande.
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": " "
}
Réponse
L’exemple suivant illustre la réponse.
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": ""
}
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour