Criar organizationalBrandingLocalization
Namespace: microsoft.graph
Crie um novo objeto organizationalBrandingLocalization . Isso cria uma identidade visual localizada e, ao mesmo tempo, a identidade visual padrão se ela não existir.
A marca padrão é criada apenas uma vez. Ele é carregado quando uma marca localizada não é configurada para o idioma do navegador do usuário. Para recuperar a identidade visual padrão, consulte Obter identidade visual.
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
Tipo de permissão | Permissões menos privilegiadas | Permissões privilegiadas mais altas |
---|---|---|
Delegado (conta corporativa ou de estudante) | OrganizationalBranding.ReadWrite.All | Organization.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Application | OrganizationalBranding.ReadWrite.All | Organization.ReadWrite.All |
Para cenários delegados, somente usuários com a função Oragnizational Branding AdministratorMicrosoft Entra podem gerenciar totalmente a identidade visual da organização.
Solicitação HTTP
Essa solicitação cria uma nova marca de localização e uma identidade visual padrão se uma ainda não existir.
POST /organization/{organizationId}/branding/localizations
Cabeçalhos de solicitação
Nome | Descrição |
---|---|
Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Content-Type | application/json. Obrigatório. |
Corpo da solicitação
A tabela a seguir lista as propriedades necessárias ao criar o objeto organizationalBrandingLocalization .
Propriedade | Tipo | Descrição |
---|---|---|
id | Cadeia de caracteres | Um identificador que representa a localidade especificada usando nomes de cultura. Os nomes de cultura seguem o padrão RFC 1766 no formato "languagecode2-country/regioncode2", em que "languagecode2" é um código de duas letras minúscula derivado do ISO 639-1 e "country/regioncode2" é um código maiúsculo de duas letras derivado do ISO 3166. Por exemplo, o inglês dos EUA é en-US . Você não pode criar a identidade visual padrão definindo o valor da id para os tipos de cadeia de caracteres 0 ou default . NOTA: No momento, não há suporte para várias marcas para uma única localidade. |
Resposta
Se for bem-sucedido, esse método retornará um 201 Created
código de resposta e um objeto organizationalBrandingLocalization no corpo da resposta.
Exemplos
O exemplo a seguir cria uma localização de identidade visual para localização francesa (fr-FR
). Quaisquer propriedades não especificadas do tipo String herdam do valor no objeto de identidade visual padrão. Por exemplo, se o signInPageText no objeto de identidade visual padrão for null
, o signInPageText para a fr-FR
marca criada nesta solicitação também será null
. Para substituir um null
valor sem nenhum texto, use uma cadeia de caracteres que contém apenas whitespace.
Solicitação
O exemplo a seguir mostra uma solicitação.
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": " "
}
Resposta
O exemplo a seguir mostra a resposta.
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": ""
}
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários