Criar profileCardProperty

Namespace: microsoft.graph

Crie um novo profileCardProperty para uma organização. A nova propriedade é identificada por sua propriedade directoryPropertyName .

Para obter mais informações sobre como adicionar propriedades ao profile card de uma organização, consulte Adicionar ou remover atributos personalizados em um card de perfil usando a API do card de perfil.

Observação

As propriedades do card de perfil correspondem aos atributos no Microsoft Entra ID. Adicionar um atributo como um profileCardProperty à coleção profileCardProperties de uma organização configura cartões de perfil para exibir o valor do atributo. Excluir o profileCardProperty da coleção não exclui o atributo do Microsoft Entra ID; exclui a configuração para que os cartões de perfil não exibam mais o valor do atributo.

Essa API está disponível nas seguintes implantações de nuvem nacional.

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

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos 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 com privilégios mais elevados
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.

Importante

Para acesso delegado usando contas corporativas ou de estudante, o administrador deve receber uma função do Microsoft Entra com suporte. People Administrator é a função menos privilegiada com suporte para esta operação.

Solicitação HTTP

POST /admin/people/profileCardProperties

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.

Observação: Para evitar problemas de codificação que malformatam o conteúdo, use Content-Type: application/json; charset=utf-8.

Corpo da solicitação

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

Você pode especificar as propriedades a seguir ao criar um profileCardProperty para uma organização.

Propriedade Tipo Descrição
anotações Coleção profileCardAnnotation Quaisquer rótulos alternativos ou localizados que um administrador optou por especificar. Opcional.
directoryPropertyName Cadeia de caracteres O nome da propriedade de diretório que se destina a aparecer no card de perfil. Obrigatório.
isVisible Booliano Indica se a propriedade de diretório determinada deve ser mostrada no card de perfil de um usuário. Opcional.

Resposta

Se for bem-sucedido, esse método retornará um código de 201 Created 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/v1.0/admin/people/profileCardProperties
Content-type: application/json; charset=utf-8

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

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

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