Wykonywanie operacji zbiorczych

Jeśli wykonujesz kilka operacji, czas potrzebny na wysłanie i odebranie wszystkich tych wiadomości HTTP może spowodować powolne działanie aplikacji i brak reakcji. Dzięki temu serwer może wykonywać wiele operacji za pomocą jednego żądania HTTP. Podstawowym założeniem jest utworzenie kanału kontaktów i dodanie wpisu dla każdej operacji, którą chcesz wykonać.

Żądania zbiorcze są ograniczone do 100 operacji naraz. Więcej informacji o operacjach wsadowych znajdziesz w artykule o przetwarzaniu wsadowym w protokole Google Data Protocol. Zanim zmiany pojawią się w autouzupełnianiu adresu e-mail i w menedżerze kontaktów, może minąć do 24 godzin.

Poniższy przykładowy kod przedstawia żądanie zbiorcze tworzące 2 kontakty udostępnione; możesz jednak używać żądania zbiorczego do wysyłania zapytań, aktualizowania i usuwania kontaktów. Pozycje aktualizowania i usuwania wymagają linku do edycji, aby optymalna równoczesność działała.

<?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>

Zastąp następujące elementy:

• FIRST_NAME: imię udostępnionego kontaktu, na przykład Alex.
• LAST_NAME: nazwisko udostępnionego kontaktu, np. [Imię].
• EMAIL_ADDRESS: preferowany adres e-mail kontaktu udostępnionego – na przykład [e-mail].