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 tem a forma de um tipo de contato estendido, que representa uma pessoa, um local (como um clube ou um 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 de dados do Google.

O elemento category que indica que a entrada é um contato é semelhante a esta:

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

Suporte a fotos

Além dos valores de propriedades padrão, como "self" ou "edit", você pode usar valores rel para elementos atom:link. Ao usar links de fotos, o token de autorização no cabeçalho HTTP precisa ser especificado. 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. É possível usar 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 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 para gContact é http://schemas.google.com/contact/2008.

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

gContact:groupMembershipInfo propriedades

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