Crear organizationalBrandingLocalization
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta
de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Cree un nuevo objeto organizationalBrandingLocalization . Esto crea una personalización de marca localizada y, al mismo tiempo, la personalización de marca predeterminada si no existe.
La personalización de marca predeterminada solo se crea una vez. Se carga cuando no se configura una personalización de marca localizada para el idioma del explorador del usuario. Para recuperar la personalización de marca predeterminada, consulte Obtención de personalización de marca.
Esta API está disponible en las siguientes implementaciones nacionales de nube.
Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
Tipo de permiso | Permisos con privilegios mínimos | Permisos con privilegios más altos |
---|---|---|
Delegado (cuenta profesional o educativa) | OrganizationalBranding.ReadWrite.All | Organization.ReadWrite.All |
Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
Aplicación | OrganizationalBranding.ReadWrite.All | Organization.ReadWrite.All |
En escenarios delegados, solo los usuarios con el rol Administrador de personalización de marca de la organizaciónMicrosoft Entra pueden administrar completamente la personalización de marca de la organización.
Solicitud HTTP
Esta solicitud crea una nueva personalización de marca de localización y una personalización de marca predeterminada si aún no existe una.
POST /organization/{organizationId}/branding/localizations
Encabezados de solicitud
Nombre | Descripción |
---|---|
Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Content-Type | application/json. Obligatorio. |
Cuerpo de la solicitud
En la tabla siguiente se enumeran las propiedades necesarias al crear el objeto organizationalBrandingLocalization .
Propiedad | Tipo | Descripción |
---|---|---|
id | Cadena | Identificador que representa la configuración regional especificada mediante nombres de referencia cultural. Los nombres de referencia cultural siguen el estándar RFC 1766 con el formato "languagecode2-country/regioncode2". La parte "languagecode2" es un código de dos letras en minúsculas derivado de ISO 639-1 y "country/regioncode2" es un código de dos letras mayúsculas derivado de ISO 3166. Por ejemplo, el inglés de EE. UU. es en-US . No se puede crear la personalización de marca predeterminada estableciendo el valor de id en los tipos 0 String o default . NOTA: Actualmente no se admite la personalización de marca de varias configuraciones regionales. |
Respuesta
Si se ejecuta correctamente, este método devuelve un 201 Created
código de respuesta y un objeto organizationalBrandingLocalization en el cuerpo de la respuesta.
Ejemplos
En el ejemplo siguiente se crea una localización de personalización de marca para la localización en francés (fr-FR
). Las propiedades no especificadas del tipo String heredan del valor del objeto de personalización de marca predeterminado. Por ejemplo, si signInPageText en el objeto de personalización de marca predeterminado es null
, signInPageText para la fr-FR
personalización de marca creada en esta solicitud también será null
. Para invalidar un null
valor sin texto, use una cadena que contenga solo espacios en blanco.
Solicitud
En el ejemplo siguiente se muestra la solicitud.
POST https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations
Content-Type: application/json
{
"backgroundColor":"#00000F",
"id": "fr-FR",
"signInPageText": " "
}
Respuesta
En el ejemplo siguiente se muestra la respuesta.
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": " "
}
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de