一括操作を行う

バッチ リクエストを使用すると、サーバーは 1 つの HTTP リクエストで複数のオペレーションを実行できるため、アプリケーションの応答性を向上させることができます。バッチ オペレーションを実行するには、連絡先フィードを作成し、各オペレーションのエントリを追加します。

バッチ リクエストは 100 個のオペレーションに制限されています。詳細については、Google Data Protocol のバッチ処理をご覧ください。変更が予測入力や連絡先マネージャーに反映されるまでに、最長で 24 時間ほどかかることがあります。

次のコードサンプルは、2 つの共有連絡先を作成するバッチ リクエストを示しています。バッチ リクエストでは、連絡先のクエリ、更新、削除もできます。エントリの更新と削除には、楽観的同時実行の編集リンクが必要です。

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

次のように置き換えます。

  • FIRST_NAME: 連絡先の名前。
  • LAST_NAME: 連絡先の姓。
  • EMAIL_ADDRESS: 希望するメールアドレス。