Si vous effectuez plusieurs opérations, le temps nécessaire pour envoyer et recevoir tous ces messages HTTP peut ralentir votre application et la rendre non réactive. 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 Traitement par lot dans le protocole Google Data. Un délai maximal de 24 heures peut être nécessaire pour que ces modifications soient prises en compte dans la saisie semi-automatique de l'adresse 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 utiliser une requête par lot pour interroger, mettre à jour et supprimer des contacts. Les entrées de mise à jour et de suppression nécessitent un lien de modification pour que la concurrencialité 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 de famille du contact partagé (par exemple, Kim).EMAIL_ADDRESS
: adresse e-mail préférée du contact partagé (par exemple, alk@gmail.com).