Adicionar propriedades adicionais ao cartão de perfil usando a API do cartão de perfil no Microsoft Graph (visualização)Add additional properties to the profile card using the profile card API in Microsoft Graph (preview)

No cartão de perfil no Microsoft 365, você pode encontrar informações sobre os usuários armazenados e mantidos pela sua organização, por exemplo Título do cargo ou Local do escritório.On the profile card in Microsoft 365, you can find information about users that is stored and maintained by your organization, for example Job title or Office location.

Use o recurso profileCardProperty para mostrar propriedades adicionais do Microsoft Azure Active Directory em cartões de perfil de uma organização:Use the profileCardProperty resource to show additional properties from Azure AD on profile cards for an organization, by:

  • Tornando visíveis atributos adicionaisMaking additional attributes visible

  • Adicionando atributos personalizadosAdding custom attributes

As propriedades adicionais serão exibidas na seção Contato do cartão de perfil no Microsoft 365.Additional properties will display in the Contact section of the profile card in Microsoft 365.

Observação

Operações no recurso profileCardProperty que usam permissões delegadas exigem que o usuário conectado tenha um administrador de locatários ou uma função de administrador global.Operations on the profileCardProperty resource that use delegated permissions requires the signed-in user to have a tenant administrator or global administrator role.

Torne visíveis atributos adicionaisMake additional attributes visible

Você pode fazer os seguintes atributos do Azure Active Directory (Azure AD) visíveis nos cartões de perfil do usuário.You can make the following attributes from Azure Active Directory (Azure AD) visible on users' profile cards. Esses atributos não diferenciam maiúsculas de minúsculas:These attributes are not case-sensitive:

  • UserPrincipalName
  • Fax
  • StreetAddress
  • PostalCode
  • StateOrProvince
  • Alias

A tabela a seguir mostra como os atributos do Azure AD correspondem com as propriedades da entidade user do Microsoft Graph.The following table shows how the Azure AD attributes correspond with properties of the Microsoft Graph user entity.

Atributo do Microsoft Azure Active DirectoryAzure AD attribute Propriedade da entidade UserUser entity property
UserPrincipalNameUserPrincipalName userPrincipalNameuserPrincipalName
FaxFax faxNumberfaxNumber
StreetAddressStreetAddress streetAddressstreetAddress
PostalCodePostalCode postalCodepostalCode
StateOrProvinceStateOrProvince estadostate
AliasAlias mailNicknamemailNickname

Você pode adicionar qualquer um desses atributos ao cartão de perfil, configurando as configurações da organização e adicionando o atributo como a propriedade directoryPropertyName* de um profileCardProperty no Microsoft Graph.You can add any of these attributes to the profile card by configuring your organization settings and adding the attribute as the directoryPropertyName* property of a profileCardProperty in Microsoft Graph. Ao tornar visíveis atributos adicionais, você deve usar os nomes de propriedades para en-us.When you make additional attributes visible, you must use the property names for en-us. Não é necessário adicionar valores localizados.You don't have to add localized values. As propriedades adicionais serão exibidas automaticamente nas configurações de idioma especificadas para o Microsoft 365.The additional properties will automatically be shown in the language settings that the user has specified for Microsoft 365.

Importante

Ao adicionar um atributo ao cartão de perfil, leva até 24 horas para que a adição seja exibida.When adding an attribute to profile card, it takes up to 24 hours for the addition to be displayed.

ExemploExample

O exemplo a seguir exibe o atributo Alias no cartão de perfil:The following example displays the Alias attribute on the profile card:

POST https://graph.microsoft.com/beta/organization/{tenantid}/settings/profileCardProperties
Content-Type: application/json

{
  "directoryPropertyName": "Alias"
}

Se bem-sucedido, este método retorna um 201 OK código de resposta e um objeto profileCardProperty no corpo da resposta.If successful, the response returns a 201 OK response code and a profileCardProperty object in the response body. O valor do atributo Alias seria exibido no cartão de perfil de um usuário.The value for the Alias attribute would be displayed on a user's profile card.

HTTP/1.1 201 OK
Content-type: application/json

{
  "directoryPropertyName": "Alias",
  "annotations": []
}

Adicionando atributos personalizadosAdding custom attributes

Você pode adicionar qualquer um dos 15 atributos de extensão personalizada do Azure AD aos cartões de perfil do usuário, definindo as configurações da sua organização e adicionando o valor correspondente como um profileCardProperty no Microsoft Graph.You can add any of the 15 Azure AD custom extension attributes to users' profile cards by configuring your organization settings and adding the corresponding value as a profileCardProperty in Microsoft Graph. Você pode adicionar um recurso profileCardProperty por vez.You can add one profileCardProperty resource at a time.

São necessárias até 24 horas para que as alterações sejam mostradas em cartões de perfil.It takes up to 24 hours for the changes to show on profile cards.

As propriedades personalizadas não podem ser pesquisadas e não podem ser usadas para pesquisar pessoas em serviços e aplicativos da Microsoft.Custom properties are not searchable and can't be used to search for people across Microsoft apps and services.

A tabela a seguir mostra como os nomes de atributos de extensão personalizada do Microsoft Azure Active Directory correspondem aos valores com suporte para a propriedade directoryPropertyName do recurso profileCardProperty.The following table shows how the Azure AD custom extension attribute names correspond to the supported values for the directoryPropertyName property of the profileCardProperty resource. Esses nomes de atributos de extensão personalizada do Microsoft Azure Active Directory não fazem distinção entre maiúsculas e minúsculas:These Azure AD custom extension attribute names are not case-sensitive:

Atributo de extensão personalizada do Microsoft Azure Active DirectoryAzure AD custom extension attribute Valor para especificar como directoryPropertyNameValue to specify as directoryPropertyName
extensionAttribute1extensionAttribute1 customAttribute1customAttribute1
extensionAttribute2extensionAttribute2 customAttribute2customAttribute2
extensionAttribute3extensionAttribute3 customAttribute3customAttribute3
extensionAttribute4extensionAttribute4 customAttribute4customAttribute4
extensionAttribute5extensionAttribute5 customAttribute5customAttribute5
extensionAttribute6extensionAttribute6 customAttribute6customAttribute6
extensionAttribute7extensionAttribute7 customAttribute7customAttribute7
extensionAttribute8extensionAttribute8 customAttribute8customAttribute8
extensionAttribute9extensionAttribute9 customAttribute9customAttribute9
extensionAttribute10extensionAttribute10 customAttribute10customAttribute10
extensionAttribute11extensionAttribute11 customAttribute11customAttribute11
extensionAttribute12extensionAttribute12 customAttribute12customAttribute12
extensionAttribute13extensionAttribute13 customAttribute13customAttribute13
extensionAttribute14extensionAttribute14 customAttribute14customAttribute14
extensionAttribute15extensionAttribute15 customAttribute15customAttribute15

ExemploExample

O exemplo a seguir adiciona o primeiro atributo de extensão personalizada do Microsoft Azure Active Directory para o cartão de perfil, usando o nome de exibição Centro de custos.The following example adds the first Azure AD custom extension attribute to the profile card, using the display name Cost center. Para os usuários que definiram as configurações de idioma para o alemão, o nome de exibição será Kostenstelle.For users that have set their language settings to German, the display name will be Kostenstelle.

POST https://graph.microsoft.com/beta/organization/{tenantid}/settings/profileCardProperties
Content-Type: application/json

{
  "directoryPropertyName": "customAttribute1",
  "annotations": [
    {
      "displayName": "Cost center",
      "localizations": [
        {
          "languageTag": "de",
          "displayName": "Kostenstelle"
        }
      ]
    }
  ]
}

Se não houver suporte a um idioma, o nome da propriedade será mostrado com o valor padrão.If a language is not supported, the property name will be shown with the default value.

Se bem-sucedido, este método retorna um 201 OK código de resposta e um objeto profileCardProperty no corpo da resposta.If successful, the response returns a 201 OK response code and a profileCardProperty object in the response body. Neste exemplo, você pode supor que o cartão de perfil exiba Kostenstelle para todos os usuários que definiram as configurações de idioma para o alemão no cartão de perfil.In this example you can assume that the profile card displays Kostenstelle for all users that have set their language settings to German on the profile card. Para todos os outros usuários, Centro de custos será exibido no cartão de perfil.For all other users, Cost center will be displayed on the profile card.

HTTP/1.1 201 OK
Content-type: application/json

{
  "directoryPropertyName": "customAttribute1",
  "annotations": [
    {
      "displayName": "Cost center",
      "localizations": [
        {
          "languageTag": "de",
          "displayName": "Kostenstelle"
        }
      ]
    }
  ]
}

Confira tambémSee also

Localizar sua ID de locatário do Microsoft 365Find your Microsoft 365 tenant ID

Tipo de recurso onPremisesExtensionAttributesonPremisesExtensionAttributes resource type

Tipo de recurso de usuárioUser resource type

Explorador do GraphGraph Explorer

Obter profileCardPropertyGet profileCardProperty