ביצוע פעולות באצווה

אם מבצעים כמה פעולות, הזמן שנדרש לשליחה ולקבלה של כל הודעות ה-HTTP האלה עלול לגרום לאפליקציה להיות איטית ולא להגיב. באמצעות בקשות באצווה, אפשר לגרום לשרת לבצע כמה פעולות באמצעות בקשת HTTP אחת. הרעיון הבסיסי הוא ליצור פיד של אנשי קשר ולהוסיף רשומה לכל פעולה שרוצים לבצע.

בקשות באצווה מוגבלות ל-100 פעולות בכל פעם. מידע נוסף על פעולות באצווה זמין במאמר עיבוד באצווה ב-Google Data Protocol. יכול להיות שיחלפו עד 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: שם הפרטי של איש הקשר ששותף – לדוגמה, אלכס.
• LAST_NAME: שם המשפחה של איש הקשר המשותף, לדוגמה, לוי.
• EMAIL_ADDRESS: כתובת האימייל המועדפת של איש הקשר המשותף, לדוגמה: [e-mail].