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

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

יצירת קמפיין ליצירת ביקוש באמצעות 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);