Elementos de contatos compartilhados

A API Domain Shared Contacts usa os elementos padrão da API Google Data e elementos específicos para contatos compartilhados.

Uma entrada de contato assume a forma de um tipo de contato estendido, representando uma pessoa, um local (como um clube ou um restaurante) ou uma organização. O tipo de contato aparece em XML como um elemento <atom:entry> que contém vários elementos de extensão do namespace Google Data.

O elemento category que indica que a entrada é um contato tem esta aparência:

<atom:category scheme="http://schemas.google.com/g/2005#kind"
  term="http://schemas.google.com/contact/2008#contact"/>

Na API Domain Shared Contacts, vários elementos são um pouco mais restritivos do que o tipo de contato. Para os elementos a seguir, forneça um atributo rel ou label, mas não os dois:

  • gd:email
  • gd:im
  • gd:organization
  • gd:phoneNumber
  • gd:structuredPostalAddress

Ao criar ou atualizar um contato compartilhado, se você fornecer rel e label, ou nenhum dos dois, para qualquer um desses elementos, o servidor vai rejeitar a entrada.

Suporte do Google Fotos

Junto com os valores de propriedades padrão, como "self" ou "edit", você pode usar valores rel para elementos atom:link. Ao usar links de fotos, é necessário especificar o token de autorização no cabeçalho HTTP. Para mais informações, consulte Saiba mais sobre autenticação e autorização.

  • Com um comando GET, o rel="http://schemas.google.com/contacts/2008/rel#photo" adiciona a capacidade de ler a foto associada ao contato. Use o URL especificado em href para ler a versão mais recente da foto associada ao contato. O link não será mostrado se não houver uma foto para o contato.

Exemplo:

<atom:link rel="http://schemas.google.com/contacts/2008/rel#photo"
           href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234" type="image/*" />
  • Com um comando PUT ou DELETE, o rel="http://schemas.google.com/contacts/2008/rel#edit-photo" adiciona a capacidade de atualizar ou excluir uma foto local associada ao contato.

Exemplo:

<atom:link rel="http://schemas.google.com/contacts/2008/rel#edit-photo"
           href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234/photo4524" />

Namespace gContact

O URL do namespace XML para gContact é http://schemas.google.com/contact/2008.

Nesse namespace, um elemento é definido para representar um grupo a que o contato pertence.

Propriedades de gContact:groupMembershipInfo

Propriedade Descrição
href Identifica o grupo a que o contato pertence ou pertenceu. O grupo é referenciado pelo ID.
deleted="true" Significa que a associação ao grupo foi removida para o contato. Esse atributo só é incluído se showdeleted for especificado como um parâmetro de consulta. Caso contrário, groupMembershipInfo para grupos a que um contato não pertence mais não será retornado.