Elementos de contactos compartidos

La API de contactos compartidos de dominio usa los elementos estándar de la API de datos de Google y los elementos específicos de 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 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 contactos compartidos con el dominio, varios elementos son ligeramente 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, 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 los valores 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 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 el contacto no tiene una imagen.

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 el contacto o al que perteneció. Se hace referencia al grupo mediante su ID.
deleted="true" Significa que se quitó la pertenencia a un grupo del contacto. Este atributo solo se incluye si se especifica showdeleted como parámetro de consulta; de lo contrario, no se muestra groupMembershipInfo para los grupos a los que ya no pertenece un contacto.