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

אם מבצעים כמה פעולות, הזמן הנדרש לשליחה וקבלה של כל הודעות ה-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].