tipo de recurso contactcontact resource type

Namespace: microsoft.graphNamespace: 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.A contact is an item in Outlook where you can organize and save information about the people and organizations you communicate with. Contacts are contained in contact folders.

Esse recurso permite:This resource supports:

MétodosMethods

MétodoMethod Tipo de retornoReturn Type DescriçãoDescription
Obter contatoGet contact contactcontact Leia as propriedades e as relações do objeto contact.Read properties and relationships of contact object.
CreateCreate contactcontact Adicione um contato na pasta de Contatos raiz ou no ponto de extremidade de contatos de outra pasta de contatos.Add a contact to the root Contacts folder or to the contacts endpoint of another contact folder.
UpdateUpdate contactcontact Atualize o objeto contact.Update contact object.
DeleteDelete NenhumaNone Exclua um objeto contact.Delete contact object.
deltadelta Coleção Contactcontact collection Obtenha um conjunto de contatos que foram adicionados, excluídos ou atualizados em uma pasta especificada.Get a set of contacts that have been added, deleted, or updated in a specified folder.
Extensões abertasOpen extensions
Criar extensão abertaCreate open extension openTypeExtensionopenTypeExtension Criar uma extensão aberta e adicionar propriedades personalizadas em uma instância nova ou existente de um recurso.Create an open extension and add custom properties in a new or existing instance of a resource.
Obter extensão abertaGet open extension Coleção openTypeExtensionopenTypeExtension collection Obter um ou mais objetos de extensão ou identificados por nome ou nome totalmente qualificado.Get an open extension object or objects identified by name or fully qualified name.
Extensões de esquemaSchema extensions
Adicionar valores de extensões de esquemaAdd schema extension values Cria uma definição para a extensão de esquema e usa-a para adicionar dados digitados personalizados a um recurso.Create a schema extension definition and then use it to add custom typed data to a resource.
Propriedades estendidasExtended properties
Criar uma propriedade estendida de valor únicoCreate single-value extended property contactcontact Criar uma ou mais propriedades estendidas de valor único em um contato novo ou existente.Create one or more single-value extended properties in a new or existing contact.
Obter contato com propriedade estendida com valor únicoGet contact with single-value extended property contactcontact Obter contatos que contenham uma propriedade estendida de valor único usando $expand ou $filter.Get contacts that contain a single-value extended property by using $expand or $filter.
Criar propriedade estendida de vários valoresCreate multi-value extended property contactcontact Criar uma ou mais propriedades estendidas de vários valores em um contato novo ou existente.Create one or more multi-value extended properties in a new or existing contact.
Obter contato com propriedade estendida de vários valoresGet contact with multi-value extended property contactcontact Obter um contato que contenha uma propriedade estendida de vários valores usando $expand.Get a contact that contains a multi-value extended property by using $expand.

PropriedadesProperties

PropriedadeProperty TipoType DescriçãoDescription
assistantNameassistantName StringString O nome do assistente do contato.The name of the contact's assistant.
birthdaybirthday DateTimeOffsetDateTimeOffset O aniversário do contato.The contact's birthday. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00ZFor example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
businessAddressbusinessAddress PhysicalAddressPhysicalAddress O endereço comercial do contato.The contact's business address.
businessHomePagebusinessHomePage StringString A home page comercial do contato.The business home page of the contact.
businessPhonesbusinessPhones Coleção de cadeias de caracteresString collection Os números de telefone comerciais do contato.The contact's business phone numbers.
categoriescategories Coleção de cadeias de caracteresString collection As categorias associadas ao contato.The categories associated with the contact.
changeKeychangeKey StringString 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.Identifies the version of the contact. Every time the contact is changed, ChangeKey changes as well. This allows Exchange to apply changes to the correct version of the object.
childrenchildren Coleção de cadeias de caracteresString collection Os nomes dos filhos do contato.The names of the contact's children.
nomeDaEmpresacompanyName StringString O nome da empresa do contato.The name of the contact's company.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset A hora em que o contato foi criado.The time the contact was created. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00ZFor example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
departmentdepartment StringString O departamento do contato.The contact's department.
displayNamedisplayName StringString O nome para exibição do contato.The contact's display name. Você pode especificar o nome de exibição em uma operação criar ou atualizar.You can specify the display name in a create or update operation. Observe que atualizações posteriores em outras propriedades podem fazer com que um valor gerado automaticamente sobrescreva o valor de displayName que você especificou.Note that later updates to other properties may cause an automatically generated value to overwrite the displayName value you have specified. Para preservar a um valor preexistente, inclua-o como o displayName na operação atualizar.To preserve a pre-existing value, always include it as displayName in an update operation.
emailAddressesemailAddresses Coleção EmailAddressEmailAddress collection Os endereços de email do contato.The contact's email addresses.
fileAsfileAs StringString O nome com o qual o contato está arquivado.The name the contact is filed under.
generationgeneration StringString A geração do contato.The contact's generation.
givenNamegivenName StringString O nome do contato.The contact's given name.
homeAddresshomeAddress PhysicalAddressPhysicalAddress O endereço residencial do contato.The contact's home address.
homePhoneshomePhones Coleção de cadeias de caracteresString collection Os números de telefone residenciais do contato.The contact's home phone numbers.
idid StringString O identificador exclusivo do contato. Somente leitura.The contact's unique identifier. Read-only.
imAddressesimAddresses Coleção de cadeias de caracteresString collection Os endereços de mensagens instantâneas do contato.The contact's instant messaging (IM) addresses.
initialsinitials StringString As iniciais do contato.The contact's initials.
jobTitlejobTitle StringString O cargo do contato.The contact’s job title.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset A hora em que o contato foi modificado.The time the contact was modified. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00ZFor example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
managermanager StringString O nome do gerente do contato.The name of the contact's manager.
middleNamemiddleName StringString O nome do meio do contato.The contact's middle name.
mobilePhonemobilePhone StringString O número de celular do contato.The contact's mobile phone number.
nickNamenickName StringString O apelido do contato.The contact's nickname.
officeLocationofficeLocation StringString O local do escritório do contato.The location of the contact's office.
otherAddressotherAddress PhysicalAddressPhysicalAddress Outros endereços do contato.Other addresses for the contact.
parentFolderIdparentFolderId StringString A ID da pasta pai do contato.The ID of the contact's parent folder.
personalNotespersonalNotes StringString As anotações do usuário sobre o contato.The user's notes about the contact.
professionprofession StringString A profissão do contato.The contact's profession.
spouseNamespouseName StringString O nome do cônjuge/parceiro do contato.The name of the contact's spouse/partner.
surnamesurname StringString O sobrenome do contato.The contact's surname.
titletitle StringString O título do contato.The contact's title.
yomiCompanyNameyomiCompanyName StringString O nome de empresa japonês fonético do contato.The phonetic Japanese company name of the contact.
yomiGivenNameyomiGivenName StringString O nome japonês fonético do contato.The phonetic Japanese given name (first name) of the contact.
yomiSurnameyomiSurname StringString O sobrenome japonês fonético do contato.The phonetic Japanese surname (last name) of the contact.

RelaçõesRelationships

RelaçãoRelationship TipoType DescriçãoDescription
extensionsextensions Coleção extensionextension collection A coleção de extensões abertas definidas para o contato. Somente leitura. Anulável.The collection of open extensions defined for the contact. Read-only. Nullable.
multiValueExtendedPropertiesmultiValueExtendedProperties Coleção multiValueLegacyExtendedPropertymultiValueLegacyExtendedProperty collection A coleção de propriedades estendidas de vários valores definidas para o contato. Somente leitura. Anulável.The collection of multi-value extended properties defined for the contact. Read-only. Nullable.
Fotophoto profilePhotoprofilePhoto Imagem de contato opcional. Você pode obter ou definir uma foto de um contato.Optional contact picture. You can get or set a photo for a contact.
singleValueExtendedPropertiessingleValueExtendedProperties Coleção singleValueLegacyExtendedPropertysingleValueLegacyExtendedProperty collection A coleção de propriedades estendidas de valor único definidas para o contato. Somente leitura. Anulável.The collection of single-value extended properties defined for the contact. Read-only. Nullable.

Representação JSONJSON representation

Veja a seguir uma representação JSON do recursoHere is a JSON representation of the resource

{
  "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",
  "profession": "string",
  "spouseName": "string",
  "surname": "string",
  "title": "string",
  "yomiCompanyName": "string",
  "yomiGivenName": "string",
  "yomiSurname": "string",

  "photo": { "@odata.type": "microsoft.graph.profilePhoto" }
}

Confira tambémSee also