تنفيذ عمليات مجمّعة

تسمح الطلبات المجمّعة للخادم بتنفيذ عمليات متعدّدة باستخدام طلب HTTP واحد، ما يمكن أن يحسّن استجابة التطبيق. لتنفيذ عملية مجمّعة، أنشئ خلاصة جهات اتصال وأضِف إدخالاً لكل عملية.

تقتصر الطلبات المجمّعة على 100 عملية. لمزيد من المعلومات، يُرجى الاطّلاع على المعالجة المجمّعة في بروتوكول بيانات Google. قد يستغرق ظهور التغييرات في قائمة الإكمال التلقائي وفي "مدير جهات الاتصال" مدة تصل إلى 24 ساعة.

يعرض نموذج الرمز البرمجي التالي طلبًا مجمّعًا ينشئ جهتَي اتصال مشتركتَين. يمكن للطلبات المجمّعة أيضًا طلب بيانات جهات الاتصال وتعديلها وحذفها. تتطلّب عمليات تعديل وحذف الإدخالات رابط تعديل للتزامن المتفائل.

<?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: عنوان البريد الإلكتروني المفضّل