מזהים

רוב הישות ב-Google Ads חושפות את השיטה getId() שמחזירה את המזהה שלהן. ברוב המקרים אין צורך במזהים, אבל הם יכולים להיות שימושיים במקרים הבאים:

עבודה עם דוחות

המזהים מספקים דרך טובה לקשר שורה בדוח לישויות בפועל ב-Google Ads.

שמירה על מיפוי עם מאגר נתונים חיצוני

יכול להיות שכבר יש לכם מידע מבוסס-מזהה שמאוחסן במסד הנתונים שלכם.

רוצים לשפר את הביצועים?

אחזור לפי מזהי פריטים הוא לרוב מהיר יותר מאפשרויות חלופיות. גם הקוד לאחזור ישות אחת פשוט יותר:

let campaigns = AdsApp.campaigns()
   .withIds([678678])
   .get();
// vs.
let campaigns = AdsApp.campaigns()
   .withCondition("Name='My Campaign'")
   .get();

ייחודיות

המזהים של הקמפיינים ושל קבוצות המודעות הם ייחודיים: אף שני קמפיינים או שתי קבוצות של מודעות לא ישתפו לעולם את אותו מזהה. עם זאת, למודעות ולמילות מפתח יש מזהים מורכבים: המזהה הייחודי של מילת מפתח הוא שילוב של מזהה קבוצת המודעות ומזהה מילת המפתח. באופן דומה, המזהה הייחודי של מודעה הוא שילוב של מזהה קבוצת המודעות ומזהה המודעה. לכך יש השלכות על האופן שבו selector.withIds() נקרא.

לגבי קמפיינים וקבוצות של מודעות, הפונקציה selector.withIds() מצפה למערך של מספרים:

let ids = [123123, 234234, 345345];
let campaignSelector = AdsApp.campaigns().withIds(ids);

עם זאת, עבור מודעות ומילות מפתח, selector.withIds() צריך מערך של מערכי שני רכיבים, כאשר הרכיב הראשון הוא מזהה קבוצת המודעות. קטע הקוד הבא מאחזר שלוש מילות מפתח מקבוצת מודעות:

let adGroupId = 123123;
let keywordSelector = AdsApp.keywords().withIds([
    [adGroupId, 234234],
    [adGroupId, 345345],
    [adGroupId, 456456]
]);

אותו מבנה חל גם על אחזור מודעות.