Elementos de contactos compartidos

La API de Domain Shared Contacts usa los elementos estándar de la API de Google Data y elementos específicos para los contactos compartidos.

Una entrada de contacto adopta la forma de un tipo de contacto extendido, que representa a una persona, un lugar (como un club o un restaurante) o una organización. El tipo de contacto aparece en XML como un elemento <atom:entry> que contiene varios elementos de extensión del espacio de nombres de Google Data.

El elemento category que indica que la entrada es un contacto se ve de la siguiente manera:

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

En la API de Domain Shared Contacts, varios elementos son un poco más restrictivos que el tipo de contacto. Para los siguientes elementos, debes proporcionar un atributo rel o un atributo label, pero no ambos:

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

Cuando creas o actualizas un contacto compartido, si proporcionas rel y label, o ninguno de los dos, para cualquiera de esos elementos, el servidor rechaza la entrada.

Compatibilidad con Fotos

Junto con los valores de las propiedades estándar, como self o edit, puedes usar valores de rel para los elementos atom:link. Cuando se usan vínculos de fotos, se debe especificar el token de autorización en el encabezado HTTP. Para obtener más información, consulta Obtén información sobre la autenticación y la autorización.

  • Con un comando de GET, rel="http://schemas.google.com/contacts/2008/rel#photo" agrega la capacidad de leer la foto asociada al contacto. Puedes usar la URL especificada en href para leer la versión más reciente de la foto asociada al contacto. El vínculo no se muestra si no hay una foto del contacto.

Ejemplo:

<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/*" />
  • Con un comando PUT o DELETE, rel="http://schemas.google.com/contacts/2008/rel#edit-photo" agrega la capacidad de actualizar o borrar una foto local asociada con el contacto.

Ejemplo:

<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" />

Espacio de nombres gContact

La URL del espacio de nombres XML para gContact es http://schemas.google.com/contact/2008.

En este espacio de nombres, se define un elemento que representa un grupo al que pertenece el contacto.

gContact:groupMembershipInfo propiedades

Propiedad Descripción
href Identifica el grupo al que pertenece o perteneció el contacto. Se hace referencia al grupo por su ID.
deleted="true" Indica que se quitó la membresía del grupo para el contacto. Este atributo solo se incluye si se especifica showdeleted como parámetro de consulta. De lo contrario, no se devuelve groupMembershipInfo para los grupos a los que ya no pertenece un contacto.