Mettre à jour ou supprimer un contact partagé

Les processus de mise à jour ou de suppression d'un contact partagé sont similaires.

Modifier un contact partagé

Lorsque vous mettez à jour une entrée, vous devez conserver tous les éléments XML qui étaient présents lorsque vous avez récupéré l'entrée sur le serveur. Sinon, les éléments ignorés sont supprimés. Un délai maximal de 24 heures peut être nécessaire pour que les modifications soient prises en compte dans la saisie semi-automatique de l'adresse e-mail et dans le gestionnaire de contacts.

Pour mettre à jour un contact partagé existant, procédez comme suit:

1. Obtenez l'entrée que vous souhaitez mettre à jour.
2. Modifiez l'entrée.

3. Envoyez une requête PUT avec l'entrée mise à jour dans le corps du message à l'URL de modification du contact. Utilisez le type de contenu application/atom+xml et assurez-vous que la valeur <id> de l'entrée mise à jour correspond exactement à celle de l'entrée existante.<id> L'URL d'édition se termine par un numéro de version afin de détecter les conflits de mises à jour provenant de différentes sources. Pour en savoir plus, consultez la section Gestion des versions.

   Mettez à jour l'entrée:

   <entry>
     <id>https://www.google.com/m8/feeds/contacts/DOMAIN/base/8411573</id>
     <updated>2008-02-28T18:47:02.303Z</updated>
     <category scheme='http://schemas.google.com/g/2005#kind'
       term='http://schemas.google.com/contact/2008#contact' />
     <title type='text'>TITLE_NAME</title>
     <gd:name>
       <gd:fullName>FIRST_NAME LAST_NAME</gd:fullName>
     </gd:name>
     <content type='text'>NOTES</content>
     <link rel='self' type='application/atom+xml'
       href='https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/8411573' />
     <link rel='edit' type='application/atom+xml'
       href='https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/8411573/1204224422303000' />
     <gd:phoneNumber rel='http://schemas.google.com/g/2005#other'
       primary='true'>PRIMARY_PHONE_NUMBER</gd:phoneNumber>
     <gd:extendedProperty name="CUSTOM_PROPERTY" value="CUSTOM_PROPRTY_VALUE" />
   </entry>

   Remplacez les éléments suivants :

   • DOMAIN: URL de votre domaine (par exemple, example.com).
   • TITLE_NAME: nom de l'entrée de contact (par exemple, liste de contacts example.com)
   • FIRST_NAME: prénom du contact partagé (par exemple, Alex)
   • LAST_NAME: nom de famille du contact partagé (par exemple, Kim)
   • PROJECTION: valeur de projection qui spécifie les éléments gd:extendedProperty. Pour obtenir la liste des valeurs acceptées, consultez la section Valeurs de projection.
   • PRIMARY_PHONE_NUMBER: numéro de téléphone préféré du contact partagé (par exemple, [phone]).
   • CUSTOM_PROPERTY: nom d'une propriété personnalisée que vous souhaitez stocker au sujet du contact partagé (par exemple, "animal de compagnie").

   • CUSTOM_PROPRTY_VALUE: valeur d'une propriété personnalisée que vous souhaitez stocker au sujet du contact partagé (par exemple, hamster).

     Voici un exemple d'entrée mise à jour pour un contact partagé, avec l'URL de modification mise en surbrillance:

     <entry>
     <id>https://www.google.com/m8/feeds/contacts/example.com/base/8411573</id>
     <updated>2008-02-28T18:47:02.303Z</updated>
     <category scheme='http://schemas.google.com/g/2005#kind'
       term='http://schemas.google.com/contact/2008#contact' />
     <title type='text'>Fitzgerald</title>
     <gd:name>
       <gd:fullName>Fitzgerald</gd:fullName>
     </gd:name>
     <content type='text'>Notes</content>
     <link rel='self' type='application/atom+xml'
       href='https://www.google.com/m8/feeds/contacts/example.com/full/8411573' />
     <link rel='edit' type='application/atom+xml'
       href='https://www.google.com/m8/feeds/contacts/example.com/full/8411573/1204224422303000' />
     <gd:phoneNumber rel='http://schemas.google.com/g/2005#other'
       primary='true'>456-123-2133</gd:phoneNumber>
     <gd:extendedProperty name="pet" value="hamster" />
     <gd:extendedProperty name="cuisine">
       <italian />
     </gd:extendedProperty>
     </entry>

Supprimer des contacts partagés

Il peut s'écouler jusqu'à 24 heures avant que les contacts partagés supprimés ne disparaissent de la saisie semi-automatique de l'adresse e-mail et du gestionnaire de contacts. Pour mettre à jour des contacts existants, consultez la section Mettre à jour les contacts. Ne mettez pas à jour les contacts en les supprimant, puis en les ajoutant à nouveau.

• Pour supprimer un contact partagé, envoyez une requête DELETE à l'URL de modification du contact. Il s'agit de la même URL que celle utilisée pour mettre à jour les contacts.

Google conserve les espaces réservés des contacts supprimés pendant 30 jours après leur suppression. Pendant ce temps, vous pouvez demander les espaces réservés à l'aide du paramètre de requête showdeleted.

Étapes suivantes

Modifier ou supprimer une photo d'un contact partagé