ביצוע קריאות ל-Google Ads API באמצעות אסטרטגיית mutate

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

יצירת קמפיין למיקסום הביצועים באמצעות mutate

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

אחרי שמגדירים את זה, יוצרים מערך שיכיל את כל הפעולות:

const operations = [];

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

const customerId = AdsApp.currentAccount().getCustomerId();

בכל פעם שרוצים ליצור פעולה חדשה, משתמשים במזהה הזמני הבא בשם המשאב, כדי שאפשר יהיה להתייחס לאובייקט הזה בהמשך ולהוסיף את האובייקט שנוצר למערך:

const newOperation = {
    [OPERATION_TYPE_VARIES]: {
        create: {
            resourceName: `customers/${customerId}/[EXACT_PATH_VARIES]/${getNextTempId()}`
            // Other fields, relevant to the resource being created.
        }
    }
}
operations.push(newOperation);

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

אחרי שיוצרים את כל הפעולות, מריצים אותן בבת אחת:

AdsApp.mutateAll(operations);