עיבוד אצווה

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

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

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

תפעול

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

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

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

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

הבא
זרימת שימוש