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

إذا كنت تجري عدة عمليات، فإن الوقت الذي يستغرقه إرسال وتلقّي كل رسائل HTTP يمكن أن يجعل التطبيق بطيئًا ولا يستجيب. باستخدام الطلبات المجمّعة، يمكنك جعل الخادم ينفذ عمليات متعددة من خلال طلب 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: عنوان البريد الإلكتروني المفضّل لجهة الاتصال المشترَكة، مثل [e-mail].