עיבוד אצווה

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

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

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

תפעול

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

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

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

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