Effectuer des opérations par lot

Les requêtes par lot permettent au serveur d'effectuer plusieurs opérations avec une seule requête HTTP, ce qui peut améliorer la réactivité de l'application. Pour effectuer une opération par lot, créez un flux de contacts et ajoutez une entrée pour chaque opération.

Les requêtes par lot sont limitées à 100 opérations. Pour en savoir plus, consultez Traitement par lot dans le protocole de données Google. Un délai maximal de 24 heures peut être nécessaire pour que les modifications soient prises en compte dans la saisie semi-automatique et dans le gestionnaire de contacts.

L'exemple de code suivant montre une requête par lot qui crée deux contacts partagés. Les requêtes par lot peuvent également interroger, mettre à jour et supprimer des contacts. La mise à jour et la suppression d'entrées nécessitent un lien de modification pour la concurrence optimiste.

<?xml version='1.0' encoding='UTF-8'?>
<feed xmlns='http://www.w3.org/2005/Atom'
      xmlns:gContact='http://schemas.google.com/contact/2008'
      xmlns:gd='http://schemas.google.com/g/2005'
      xmlns:batch='http://schemas.google.com/gdata/batch'>
  <category scheme='http://schemas.google.com/g/2005#kind'
      term='http://schemas.google.com/g/2008#contact' />
  <entry>
    <batch:id>1</batch:id>
    <batch:operation type='insert' />
    <category scheme='http://schemas.google.com/g/2005#kind'
      term='http://schemas.google.com/g/2008#contact'/>
    <gd:name>
      <gd:givenName>FIRST_NAME</gd:fullName>
      <gd:familyName>LAST_NAME</gd:fullName>
    </gd:name>
    <gd:email rel='http://schemas.google.com/g/2005#home'
      address='EMAIL_ADDRESS' primary='true'/>
  </entry>
  <entry>
    <batch:id>2</batch:id>
    <batch:operation type='insert' />
    <category scheme='http://schemas.google.com/g/2005#kind'
      term='http://schemas.google.com/g/2008#contact'/>
    <gd:name>
      <gd:givenName>FIRST_NAME</gd:fullName>
      <gd:familyName>LAST_NAME</gd:fullName>
    </gd:name>
    <gd:email rel='http://schemas.google.com/g/2005#home'
      address='EMAIL_ADDRESS'
      primary='true'/>
  </entry>
</feed>

Remplacez les éléments suivants :

• FIRST_NAME : prénom du contact.
• LAST_NAME : nom de famille du contact.
• EMAIL_ADDRESS : adresse e-mail préférée.