Elementos de contactos compartidos

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

Una entrada de contacto tiene 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 Datos de Google.

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, proporciona 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 esos elementos, el servidor rechaza la entrada.

Compatibilidad con Fotos

Junto con los valores de propiedades estándar, como self o edit, puedes usar valores rel para 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 Más información sobre la autenticación y la autorización.

  • Con un comando GET, rel="http://schemas.google.com/contacts/2008/rel#photo" agrega la capacidad de leer la foto asociada con el contacto. Puedes usar la URL especificada en href para leer la versión más reciente de la foto asociada con el contacto. El vínculo no se muestra si no hay una imagen para el 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 pertenecía el contacto. Se hace referencia al grupo por su ID.
deleted="true" Significa que se quitó la membresía del grupo del contacto. Este atributo solo se incluye si se especifica showdeleted como un parámetro de consulta. De lo contrario, no se muestra groupMembershipInfo para los grupos a los que un contacto ya no pertenece.