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

تسمح الطلبات المجمّعة للخادم بتنفيذ عمليات متعدّدة باستخدام طلب 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: عنوان البريد الإلكتروني المفضّل