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 emhref
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
ouDELETE
,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. |