Elementos de contatos compartilhados

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

Uma entrada de contato assume a forma de um Tipo de contato estendido, representando uma pessoa, um local (como um clube ou restaurante) ou uma organização. O tipo de contato aparece no XML como um elemento <atom:entry> que contém vários elementos de extensão do namespace do 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 que o tipo de contato. Para os elementos abaixo, você fornece um atributo rel ou label, mas não ambos:

  • 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 deles para nenhum desses elementos, o servidor rejeitará a entrada.

Suporte a fotos

Com os valores de propriedades padrão, como self ou edição, 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, rel="http://schemas.google.com/contacts/2008/rel#photo" adiciona a capacidade de ler a foto associada ao contato. Você pode usar o URL especificado em href para ler a versão mais recente da foto associada ao contato. O link não será exibido se não houver uma imagem do 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, 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 de gContact é http://schemas.google.com/contact/2008.

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

gContact:groupMembershipInfo propriedades

Propriedade Descrição
href Identifica o grupo ao qual o contato pertence ou pertenceu. O grupo é referenciado pelo respectivo ID.
deleted="true" Isso significa que a associação ao grupo foi removida do contato. Esse atributo só será 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 não será retornado.