עיבוד אצווה

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

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

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

תפעול

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

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

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

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

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