Mettre à jour ou supprimer un contact partagé

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

Mettre à jour un contact partagé

Lorsque vous mettez à jour une entrée, vous devez conserver tout le code XML présent lorsque vous avez récupéré l'entrée sur le serveur. Sinon, les éléments ignorés sont supprimés. Il peut s'écouler jusqu'à 24 heures avant que les modifications soient répercutées 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 à l'<id> de l'entrée existante. L'URL de modification 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 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 concernant le contact partagé, par exemple "animal de compagnie".

   • CUSTOM_PROPRTY_VALUE: valeur d'une propriété personnalisée que vous souhaitez stocker à propos 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 des adresses e-mail et du gestionnaire de contacts. Pour mettre à jour des contacts existants, consultez la section Mettre à jour des contacts. Ne modifiez pas les contacts en les supprimant, puis en les rajoutant.

• 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 pour les 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 la photo d'un contact partagé