Effectuer des opérations par lot

Si vous effectuez plusieurs opérations, le temps nécessaire à l'envoi et à la réception de tous ces messages HTTP peut ralentir votre application et limiter sa réponse. Avec les requêtes par lot, vous pouvez demander au serveur d'effectuer plusieurs opérations avec une seule requête HTTP. L'idée de base est de créer un flux de contacts et d'ajouter une entrée pour chaque opération que vous souhaitez effectuer.

Les requêtes par lot sont limitées à 100 opérations à la fois. Pour en savoir plus sur les opérations par lot, consultez la page Traitement par lot dans le protocole Google Data. Il peut s'écouler jusqu'à 24 heures avant que les modifications soient prises en compte dans la saisie semi-automatique des adresses e-mail et dans le gestionnaire de contacts.

L'exemple de code suivant montre une requête par lot qui crée deux contacts partagés. Toutefois, vous pouvez également interroger, mettre à jour et supprimer des contacts à l'aide d'une requête par lot. Les entrées de mise à jour et de suppression nécessitent un lien de modification pour que la simultanéité optimiste fonctionne.

<?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 partagé, par exemple Alex.
• LAST_NAME: nom du contact partagé (par exemple, Kim).
• EMAIL_ADDRESS: adresse e-mail préférée du contact partagé (par exemple, [e-mail]).