انجام عملیات دسته ای

اگر چندین عملیات را انجام می‌دهید، مدت زمانی که برای ارسال و دریافت همه آن پیام‌های HTTP طول می‌کشد می‌تواند برنامه شما را کند کند و پاسخگو نباشد. با درخواست های دسته ای، می توانید از سرور بخواهید چندین عملیات را با یک درخواست HTTP انجام دهد. ایده اصلی این است که شما یک فید مخاطبین ایجاد کنید و برای هر عملیاتی که می خواهید انجام دهید یک ورودی اضافه کنید.

درخواست های دسته ای به 100 عملیات در یک زمان محدود می شود. می‌توانید اطلاعات بیشتری درباره عملیات دسته‌ای در پردازش دسته‌ای در پروتکل داده Google بیابید. تغییرات ممکن است تا 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 : نام مخاطب مشترک - برای مثال Alex.
  • LAST_NAME : نام خانوادگی مخاطب مشترک—مثلاً کیم.
  • EMAIL_ADDRESS : آدرس ایمیل ترجیحی مخاطب مشترک - برای مثال، alk@gmail.com.
،

اگر چندین عملیات را انجام می‌دهید، مدت زمانی که برای ارسال و دریافت همه آن پیام‌های HTTP طول می‌کشد می‌تواند برنامه شما را کند کند و پاسخگو نباشد. با درخواست های دسته ای، می توانید از سرور بخواهید چندین عملیات را با یک درخواست HTTP انجام دهد. ایده اصلی این است که شما یک فید مخاطبین ایجاد کنید و برای هر عملیاتی که می خواهید انجام دهید یک ورودی اضافه کنید.

درخواست های دسته ای به 100 عملیات در یک زمان محدود می شود. می‌توانید اطلاعات بیشتری درباره عملیات دسته‌ای در پردازش دسته‌ای در پروتکل داده Google بیابید. تغییرات ممکن است تا 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 : نام مخاطب مشترک - برای مثال Alex.
  • LAST_NAME : نام خانوادگی مخاطب مشترک—مثلاً کیم.
  • EMAIL_ADDRESS : آدرس ایمیل ترجیحی مخاطب مشترک - برای مثال، alk@gmail.com.