Partilhar via

tipo de recurso contact

  • Artigo

Namespace: microsoft.graph

Um contato é um item no Outlook no qual você pode organizar e salvar informações sobre as pessoas e organizações com quem se comunica. Os contatos estão contidos em pastas de contatos.

Esse recurso permite:

Métodos

Método Tipo de retorno Descrição
Obter contato contact Leia as propriedades e as relações do objeto contact.
Criar contato contato Adicione um contato na pasta de Contatos raiz ou no ponto de extremidade de contatos de outra pasta de contatos.
Atualizar contato contact Atualize o objeto contact.
Excluir contato Nenhuma Exclua um objeto contact.
Obter intervalo de contato Coleção Contact Obtenha um conjunto de contatos que foram adicionados, excluídos ou atualizados em uma pasta especificada.
Extensões abertas
Criar extensão aberta openTypeExtension Criar uma extensão aberta e adicionar propriedades personalizadas em uma instância nova ou existente de um recurso.
Obter extensão aberta Coleção openTypeExtension Obter um ou mais objetos de extensão ou identificados por nome ou nome totalmente qualificado.
Propriedades estendidas
Criar uma propriedade de valor único contact Criar uma ou mais propriedades estendidas de valor único em um contato novo ou existente.
Obter uma propriedade de valor único contact Obter contatos que contenham uma propriedade estendida de valor único usando $expand ou $filter.
Criar propriedade com múltiplos valores contact Criar uma ou mais propriedades estendidas de vários valores em um contato novo ou existente.
Obter propriedade de múltiplos valores contact Obter um contato que contenha uma propriedade estendida de vários valores usando $expand.

Propriedades

Propriedade Tipo Descrição
assistantName String O nome do assistente do contato.
birthday DateTimeOffset O aniversário do contato. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z
businessAddress PhysicalAddress O endereço comercial do contato.
businessHomePage String A home page comercial do contato.
businessPhones Coleção de cadeias de caracteres Os números de telefone comerciais do contato.
categories Coleção de cadeias de caracteres As categorias associadas ao contato.
changeKey String Identifica a versão do contato. Toda vez que o contato muda, a ChangeKey também muda. Isso permite que o Exchange aplique alterações na versão correta do objeto.
children Coleção de cadeias de caracteres Os nomes dos filhos do contato.
nomeDaEmpresa String O nome da empresa do contato.
createdDateTime DateTimeOffset A hora em que o contato foi criado. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z
department String O departamento do contato.
displayName String O nome para exibição do contato. Você pode especificar o nome de exibição em uma operação criar ou atualizar. Observe que atualizações posteriores em outras propriedades podem fazer com que um valor gerado automaticamente sobrescreva o valor de displayName que você especificou. Para preservar a um valor preexistente, inclua-o como o displayName na operação atualizar.
emailAddresses Coleção EmailAddress Os endereços de email do contato.
fileAs String O nome com o qual o contato está arquivado.
generation String O sufixo do contacto.
givenName String O nome do contato.
homeAddress PhysicalAddress O endereço residencial do contato.
homePhones Coleção de cadeias de caracteres Os números de telefone residenciais do contato.
id String O identificador exclusivo do contato. Por padrão, esse valor muda quando o item é transferido de um contêiner (como uma pasta ou calendário) para outro. Para alterar esse comportamento, use o cabeçalho Prefer: IdType="ImmutableId". Para obter mais informações, consulte o artigo Obter identificadores imutáveis para recursos do Outlook. Somente leitura.
imAddresses Coleção de cadeias de caracteres Os endereços de mensagens instantâneas do contato.
initials String As iniciais do contato.
jobTitle String O cargo do contato.
lastModifiedDateTime DateTimeOffset A hora em que o contato foi modificado. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z
manager String O nome do gerente do contato.
middleName String O nome do meio do contato.
mobilePhone String O número de celular do contato.
nickName String O apelido do contato.
officeLocation String O local do escritório do contato.
otherAddress PhysicalAddress Outros endereços do contato.
parentFolderId String A ID da pasta pai do contato.
personalNotes String As anotações do usuário sobre o contato.
profession String A profissão do contato.
spouseName String O nome do cônjuge/parceiro do contato.
surname String O sobrenome do contato.
title String O título do contato.
yomiCompanyName String O nome de empresa japonês fonético do contato.
yomiGivenName String O nome japonês fonético do contato.
yomiSurname String O sobrenome japonês fonético (apelido) do contacto.

Relações

Relação Tipo Descrição
extensions Coleção extension A coleção de extensões abertas definidas para o contacto. Somente leitura. Anulável.
multiValueExtendedProperties Coleção multiValueLegacyExtendedProperty A coleção de propriedades estendidas de vários valores definidas para o contato. Somente leitura. Anulável.
photo profilePhoto Imagem de contato opcional. Você pode obter ou definir uma foto de um contato.
singleValueExtendedProperties Coleção singleValueLegacyExtendedProperty A coleção de propriedades estendidas de valor único definidas para o contato. Somente leitura. Anulável.

Representação JSON

A representação JSON seguinte mostra o tipo de recurso.

{
  "assistantName": "string",
  "birthday": "String (timestamp)",
  "businessAddress": {"@odata.type": "microsoft.graph.physicalAddress"},
  "businessHomePage": "string",
  "businessPhones": ["string"],
  "categories": ["string"],
  "changeKey": "string",
  "children": ["string"],
  "companyName": "string",
  "createdDateTime": "String (timestamp)",
  "department": "string",
  "displayName": "string",
  "emailAddresses": [{"@odata.type": "microsoft.graph.emailAddress"}],
  "fileAs": "string",
  "generation": "string",
  "givenName": "string",
  "homeAddress": {"@odata.type": "microsoft.graph.physicalAddress"},
  "homePhones": ["string"],
  "id": "string (identifier)",
  "imAddresses": ["string"],
  "initials": "string",
  "jobTitle": "string",
  "lastModifiedDateTime": "String (timestamp)",
  "manager": "string",
  "middleName": "string",
  "mobilePhone": "string",
  "nickName": "string",
  "officeLocation": "string",
  "otherAddress": {"@odata.type": "microsoft.graph.physicalAddress"},
  "parentFolderId": "string",
  "personalNotes": "string",
  "photo": { "@odata.type": "microsoft.graph.profilePhoto" },
  "profession": "string",
  "spouseName": "string",
  "surname": "string",
  "title": "string",
  "yomiCompanyName": "string",
  "yomiGivenName": "string",
  "yomiSurname": "string"
}

Conteúdo relacionado