עיבוד אצווה

רוב השירותים מספקים ממשקי API סינכרוניים, שבהם צריך לשלוח בקשה ואז להמתין לתגובה. לעומת זאת, BatchJobService מאפשר לבצע קבוצות של פעולות בכמה שירותים בלי להמתין לסיום הפעולות באופן סינכרוני.

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

בנוסף, BatchJobService מאפשר להשתמש במזהים זמניים בבקשות, כדי שתוכלו לשלוח פעולות תלויות בעבודה אחת.

תפעול

BatchJobService תומך בכל הפעולות שמפורטות ב-MutateOperation, מלבד כמה חריגים חשובים.

מכיוון ש-Google Ads API מבצע את כל הפעולות במשימה כשהאפשרות partial failure מופעלת, אם משימה מבוטלת או שפעולות מסוימות נכשלות, הפעולות שהצליחו לא יידחו לאחור.

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

פעולות לא נתמכות ב-BatchJobService