Éléments de contacts partagés

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

Une entrée de contact prend la forme d'un type de contact étendu, représentant une personne, un lieu (tel qu'un club ou un restaurant) ou une organisation. Le genre 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 pour l'un de ces éléments, le serveur rejette l'entrée.

Assistance Photos

Avec les valeurs des 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, vous devez spécifier un jeton d'autorisation dans l'en-tête HTTP. 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 s'il n'y a pas de photo pour le contact.

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 de propriétés

Propriété Description
href Identifie le groupe auquel le contact appartient ou appartenait. Le groupe est référencé par son ID.
deleted="true" signifie 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 n'est pas renvoyé pour les groupes dont un contact n'appartient plus.