רוב השירותים מספקים ממשקי API סינכרוניים, שבהם צריך לשלוח בקשה ואז להמתין לתגובה. לעומת זאת, BatchJobService
מאפשר לבצע קבוצות של פעולות בכמה שירותים בלי להמתין לסיום הפעולות באופן סינכרוני.
בניגוד לפעולות שינוי ספציפיות לשירות, משימה אחת ב-BatchJobService
יכולה לפעול על אוסף מעורב של קמפיינים, קבוצות של מודעות, מודעות, קריטריונים, תוויות ופריטי פיד.
משימות שנשלחות פועלות במקביל, ו-BatchJobService
מנסה שוב באופן אוטומטי פעולות שנכשלו בגלל שגיאות זמניות, כמו שגיאות של מגבלת קצב. כל פעולה ב-Google Ads API עדיין נספרת במגבלת הפעולות היומית בהתאם להוראות לספירת פעולות ה-API.
בנוסף, BatchJobService
מאפשר להשתמש במזהים זמניים בבקשות, כדי שתוכלו לשלוח פעולות תלויות בעבודה אחת.
תפעול
BatchJobService
תומך בכל הפעולות שמפורטות ב-MutateOperation
, מלבד כמה חריגים חשובים.
מכיוון ש-Google Ads API מבצע את כל הפעולות במשימה כשהאפשרות partial failure מופעלת, אם משימה מבוטלת או שפעולות מסוימות נכשלות, הפעולות שהצליחו לא יידחו לאחור.
הפעולות הבאות ב-MutateOperation
חייבות להיות אטומיות, ולכן הן לא תומכות בכשלים חלקיים ולא נתמכות במשימות באצווה. מומלץ לא להוסיף אותם למשימות, להגדיר את partial_failure
כ-false
בבקשות ולהשתמש במקום זאת בשיטה mutate
ב-GoogleAdsService
.
פעולות לא נתמכות ב-BatchJobService
CampaignConversionGoalOperation
ConversionGoalCampaignConfigOperation
CustomConversionGoalOperation
CustomerConversionGoalOperation
CustomerOperation