É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 se présente sous la forme d'un type de contact étendu, représentant une personne, un lieu (comme un club ou un restaurant) ou une organisation. Le type de contact apparaît dans le fichier 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 ressemble à ce qui 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 des deux, pour l'un 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 vers des photos, le jeton d'autorisation doit être spécifié dans l'en-tête HTTP. Pour en savoir plus, consultez À propos de l'authentification et de 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 le contact n'a pas de photo.

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" ajoute la possibilité 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 et représente un groupe auquel appartient le contact.

gContact:groupMembershipInfo établissements

Propriété Description
href Identifie le groupe auquel appartient ou appartenait le contact. Le groupe est référencé par son ID.
deleted="true" Cela signifie que l'appartenance du contact au groupe a été supprimée. 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é.