Tipo de recurso organizationalBrandingPropertiesorganizationalBrandingProperties resource type

Importante

Las API de la /beta versión de Microsoft Graph están sujetas a cambios.APIs under the /beta version in Microsoft Graph are subject to change. No se admite el uso de estas API en aplicaciones de producción.Use of these APIs in production applications is not supported. Para determinar si una API está disponible en v1.0, usa el selector de versiones.To determine whether an API is available in v1.0, use the Version selector.

Nota

Agregar personalización de marca requiere que use las ediciones Azure Active Directory Premium 1, Premium 2 o Basic, o que tenga una licencia de Microsoft 365.Adding custom branding requires you to use Azure Active Directory Premium 1, Premium 2, or Basic editions, or to have a Microsoft 365 license. Para obtener más información acerca de las licencias y las ediciones, consulta Registrarse en Azure AD Premium.For more information about licensing and editions, see Sign up for Azure AD Premium.

Las ediciones Azure AD Premium y Basic están disponibles para los clientes de China que usan la instancia mundial de Azure Active Directory.Azure AD Premium and Basic editions are available for customers in China using the worldwide instance of Azure Active Directory. Las ediciones Azure AD Premium y Basic no se admiten actualmente en el servicio de Azure operado por 21Vianet en China.Azure AD Premium and Basic editions aren't currently supported in the Azure service operated by 21Vianet in China. Para obtener más información, hable con nosotros mediante el Foro de Azure Active Directory.For more information, talk to us using the Azure Active Directory Forum.

Contiene detalles sobre la personalción de marca de la organización.Contains details about the organization's branding.

Las organizaciones pueden personalizar sus páginas de inicio de sesión de Azure AD que aparecen cuando los usuarios inician sesión en las aplicaciones específicas del inquilino de su organización, o cuando Azure AD identifica el inquilino del usuario desde su nombre de usuario.Organizations can customize their Azure AD sign-in pages which appear when users sign in to their organization's tenant-specific apps, or when Azure AD identifies the user's tenant from their username. Un desarrollador también puede leer la información de personalización de marca de la empresa y personalizar su experiencia de aplicación para adaptarla específicamente al usuario que ha iniciado sesión con la personalización de marca de su empresa.A developer can also read the company's branding information and customize their app experience to tailor it specifically for the signed-in user using their company's branding.

Las empresas pueden agregar diferentes marcas en función de la configuración regional.Companies can add different branding based on locale. La configuración regional sirve como clave en todas las solicitudes.Locale serves as a key in all requests.

Nota: La personalización de marca se expone como una propiedad dentro de la organización con una colección de localizaciones específicas de la configuración regional.Note: Branding is exposed as a property under organization with a collection of locale-specific localizations. organizationalBrandingProperties es una clase abstracta que define las propiedades de organizationalBranding.organizationalBrandingProperties is an abstract class which defines properties for organizationalBranding.

MétodosMethods

MétodoMethod Tipo de valor devueltoReturn Type DescripciónDescription
CrearCreate organizationalBrandingPropertiesorganizationalBrandingProperties Crear la marca de la organización con el objeto organizationalBrandingProperties.Create organizational branding with organizationalBrandingProperties object.
GetGet organizationalBrandingPropertiesorganizationalBrandingProperties Lea las propiedades y las relaciones del objeto organizationalBrandingProperties.Read properties and relationships of organizationalBrandingProperties object.
ActualizarUpdate organizationalBrandingPropertiesorganizationalBrandingProperties Actualice el objeto organizationalBrandingProperties.Update organizationalBrandingProperties object.
EliminarDelete NoneNone Elimine el objeto organizationalBrandingProperties.Delete organizationalBrandingProperties object.

PropiedadesProperties

PropiedadProperty TipoType DescriptionDescription
backgroundColorbackgroundColor StringString Color que aparecerá en lugar de la imagen de fondo en conexiones de ancho de banda bajo.Color that will appear in place of the background image in low-bandwidth connections. Se recomienda usar aquí el color principal del logotipo de banner o de la organización.The primary color of your banner logo or your organization color is recommended to be used here. Especifique esto en hexadecimal (por ejemplo, blanco es #FFFFFF).Specify this in hexadecimal (for example, white is #FFFFFF).
backgroundImagebackgroundImage StreamStream Imagen que aparece como fondo de la página de inicio de sesión.Image that appears as the background of the sign in page. .png o .jpg no superior a 1920 x 1080 y menor de 300 kb..png or .jpg not larger than 1920x1080 and smaller than 300kb. Una imagen más pequeña reducirá los requisitos de ancho de banda y hará que las cargas de página se realicen con mayor rendimiento.A smaller image will reduce bandwidth requirements and make page loads more performant.
bannerLogobannerLogo StreamStream Una versión de banner del logotipo de su empresa que aparece en la página de inicio de sesión.A banner version of your company logo which appears appears on the sign-in page. .png o .jpg no superior a 36 x 245 píxeles..png or .jpg no larger than 36x245px. Se recomienda usar una imagen transparente sin relleno alrededor del logotipo.We recommend using a transparent image with no padding around the logo.
idid StringString Este es un identificador, heredado de microsoft.graph.entity, es la configuración regional que especifica el estándar ISO 639 para el idioma, por ejemplo, el inglés es "en-us" o "en".This is an id, inherited from microsoft.graph.entity, is the locale specifying the ISO 639 standard for language, for example English is "en-us" or "en". En el futuro, si exponemos la funcionalidad para que tenga varias marcas para una configuración regional, esto se puede cambiar.Going forward if we expose functionality to have multiple brandings for one locale, this can be changed. Tenga en cuenta que el identificador de la personalidad de marca predeterminada siempre es "und" hasta que haya singletons sin clave.Note that id for Default /branding is always 'und' until we have keyless singletons. Solo lectura.Read-only.
signInPageTextsignInPageText StringString Texto que aparece en la parte inferior del cuadro de inicio de sesión.Text that appears at the bottom of the sign-in box. Puede usarlo para comunicar información adicional, como el número de teléfono al servicio de asistencia o una declaración legal.You can use this to communicate additional information, such as the phone number to your help desk or a legal statement. Este texto debe ser Unicode y no superar los 1024 caracteres.This text must be Unicode and not exceed 1024 characters.
squareLogosquareLogo StreamStream Versión cuadrada del logotipo de la compañía.Square version of your company logo. Esto aparece en las experiencias de configuración rápida (OOBE) de Windows 10 y cuando Windows Autopilot está habilitado para la implementación.This appears in Windows 10 out-of-box (OOBE) experiences and when Windows Autopilot is enabled for deployment. .png o .jpg no superior a 240 x 240 píxeles y no más de 10 kb de tamaño..png or .jpg no larger than 240x240px and no more than 10kb in size. Se recomienda usar una imagen transparente sin relleno alrededor del logotipo.We recommend using a transparent image with no padding around the logo.
usernameHintTextusernameHintText StringString Cadena que se muestra como sugerencia en el cuadro de texto de nombre de usuario en la pantalla de inicio de sesión.String that shows as the hint in the username textbox on the sign in screen. Este texto debe ser Unicode, sin vínculos o código, y no puede superar los 64 caracteres.This text must be Unicode, without links or code, and can't exceed 64 characters.

RelacionesRelationships

NingunoNone

Representación JSONJSON representation

La siguiente es una representación JSON del recursoThe following is a JSON representation of the resource.

{
  "backgroundColor": "String",
  "backgroundImage": "Stream",
  "bannerLogo": "Stream",
  "id": "String (identifier)",
  "signInPageText": "String",
  "squareLogo": "Stream",
  "usernameHintText": "String"
}