עיבוד אצווה

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

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

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

פעולות

BatchJobService תומך בכל הפעולות שמפורטות ב-MutateOperation, חוץ מכמה יוצאים מן הכלל.

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

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

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