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

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

تقتصر طلبات الحِزم على 100 عملية في المرة الواحدة. يمكنك الاطّلاع على مزيد من المعلومات حول عمليات الدُفعات في المعالجة المجمّعة في Google Data Protocol. قد يستغرق ظهور التغييرات في قائمة الإكمال التلقائي لعناوين البريد الإلكتروني ومدير جهات الاتصال مدة تصل إلى 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: عنوان البريد الإلكتروني المفضّل للجهة المشترَكة، على سبيل المثال، [e-mail].