Éléments de contacts partagés

L'API Domain Shared Contacts utilise les éléments standards de l'API Google Data et des éléments spécifiques aux contacts partagés.

Une entrée de contact prend la forme d'un type de contact étendu, qui représente une personne, un lieu (comme un club ou un restaurant) ou une organisation. Le type de contact apparaît au format XML sous la forme d'un élément <atom:entry> contenant divers éléments d'extension de l'espace de noms Google Data.

L'élément category indiquant que l'entrée est un contact se présente comme suit:

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

Dans l'API Domain Shared Contacts, plusieurs éléments sont légèrement plus restrictifs que le type de contact. Pour les éléments suivants, vous devez fournir un attribut rel ou un attribut label, mais pas les deux:

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

Lorsque vous créez ou mettez à jour un contact partagé, si vous fournissez à la fois rel et label, ou aucun de ces éléments, le serveur rejette l'entrée.

Compatibilité avec Photos

En plus des valeurs de propriétés standards telles que "self" ou "edit", vous pouvez utiliser des valeurs rel pour les éléments atom:link. Lorsque vous utilisez des liens photo, le jeton d'autorisation dans l'en-tête HTTP doit être spécifié. Pour en savoir plus, consultez la section En savoir plus sur l'authentification et l'autorisation.

  • Avec une commande GET, rel="http://schemas.google.com/contacts/2008/rel#photo" ajoute la possibilité de lire la photo associée au contact. Vous pouvez utiliser l'URL spécifiée dans href pour lire la dernière version de la photo associée au contact. Le lien ne s'affiche pas si aucune photo du contact n'est disponible.

Exemple :

<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/*" />
  • Avec une commande PUT ou DELETE, rel="http://schemas.google.com/contacts/2008/rel#edit-photo" permet de mettre à jour ou de supprimer une photo locale associée au contact.

Exemple :

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

Espace de noms gContact

L'URL de l'espace de noms XML pour gContact est http://schemas.google.com/contact/2008.

Dans cet espace de noms, un élément est défini qui représente un groupe auquel le contact appartient.

gContact:groupMembershipInfo établissements

Propriété Description
href Indique le groupe auquel le contact appartient ou appartenait. Le groupe est référencé par son ID.
deleted="true" Indique que l'appartenance au groupe a été supprimée pour le contact. Cet attribut n'est inclus que si showdeleted est spécifié en tant que paramètre de requête. Sinon, groupMembershipInfo pour les groupes auxquels un contact n'appartient plus n'est pas renvoyé.