Compartilhar via


Criar perfilCardProperty

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Crie um novo perfilCardProperty para uma organização. A nova propriedade é identificada pela respetiva propriedade directoryPropertyName .

Para obter mais informações sobre como adicionar propriedades ao perfil card de uma organização, consulte Adicionar ou remover atributos personalizados num perfil card utilizar o perfil card API.

Observação

As propriedades de card de perfil correspondem a atributos no Microsoft Entra ID. Adicionar um atributo como perfilCardProperty à coleção profileCardProperties para uma organização configura cartões de perfil para apresentar o valor do atributo. Eliminar o perfilCardProperty da coleção não elimina o atributo de Microsoft Entra ID; elimina a configuração para que os cartões de perfil deixem de apresentar o valor do atributo.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante) PeopleSettings.ReadWrite.All Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo Sem suporte. Sem suporte.

Nota: A utilização de permissões delegadas para esta operação requer que o utilizador com sessão iniciada tenha uma função de Administrador Inquilino.

Solicitação HTTP

POST /admin/people/profileCardProperties

Observação: o caminho /organization/{organizationId}/settings foi preterido. Daqui em diante, use o caminho /admin/people.

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.

Nota: Para evitar problemas de codificação que malformam o payload, utilize Content-Type: application/json; charset=utf-8.

Corpo da solicitação

No corpo do pedido, forneça uma representação JSON de um objeto profileCardProperty .

Pode especificar as seguintes propriedades quando cria um perfilCardProperty para uma organização.

Propriedade Tipo Descrição
anotações coleção profileCardAnnotation Quaisquer etiquetas alternativas ou localizadas que um administrador tenha optado por especificar.
directoryPropertyName Cadeia de caracteres O nome da propriedade do diretório que se destina a surgir no perfil card.

Resposta

Se for bem-sucedido, este método devolve um 201 Created código de resposta e um novo objeto profileCardProperty no corpo da resposta.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/beta/admin/people/profileCardProperties
Content-type: application/json; charset=utf-8

{
  "directoryPropertyName": "CustomAttribute1",
  "annotations": [
    {
      "displayName": "Cost Center",
      "localizations": [
        {
          "languageTag": "ru",
          "displayName": "центр затрат"
        }
      ]
    }
  ]
}

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 201 Created
Content-type: application/json; charset=utf-8

{
  "directoryPropertyName": "CustomAttribute1",
  "annotations": [
    {
      "displayName": "Cost Center",
      "localizations": [
        {
          "languageTag": "ru",
          "displayName": "центр затрат"
        }
      ]
    }
  ]
}