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