עיבוד אצווה

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

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

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

פעולות

הפונקציה BatchJobService תומכת בכל הפעולות שמפורטות ב-MutateOperation, למעט כמה חריגות חשובות.

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

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

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

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