‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

מטא-נתונים של משאבים

אתם יכולים להשתמש ב-GoogleAdsFieldService (דרך GetGoogleAdsField או SearchGoogleAdsFields) כדי לבקש באופן דינמי את קטלוג המשאבים, שדות המשאבים, מפתחות הפילוח והמדדים שזמינים ב-methods‏ GoogleAdsService Search ו-SearchStream. הקטלוג מספק מטא-נתונים שלקוחות Google Ads API יכולים להשתמש בהם כדי לאמת ולבנות הצהרות של Google Ads Query Language.

דוגמה לבקשת HTTP ותשובה

הבקשה מורכבת מ-HTTP GET לשרת Google Ads API בכתובת ה-URL הבאה:

https://googleads.googleapis.com/v26/googleAdsFields/{resource_or_field}

בדוגמה הבאה מוצגת בקשה ואחריה התשובה שהוחזרה מ-GoogleAdsFieldService למשאב ad_group:

בקשה

https://googleads.googleapis.com/v26/googleAdsFields/ad_group

תשובה

{
  "resourceName": "googleAdsFields/ad_group",
  "name": "ad_group",
  "category": "RESOURCE",
  "selectable": false,
  "filterable": false,
  "sortable": false,
  "selectableWith": [
    "campaign",
    "customer",
    "metrics.average_cpc",
    "segments.device"
  ],
  "attributeResources": [
    "customer",
    "campaign"
  ],
  "metrics": [
    "metrics.conversions",
    "metrics.search_budget_lost_impression_share",
    "metrics.average_cost",
    "metrics.clicks"
  ],
  "segments": [
    "segments.date",
    "segments.ad_network_type",
    "segments.device"
  ]
}

בדוגמה הזו, המערכים החשובים הם:

attributeResources: משאבים שאפשר לצרף באופן משתמע למשאב בסעיף FROM בלי לפלח את המדדים. השדה הזה מאוכלס רק בשדות שבהם הערך של category הוא RESOURCE.
metrics: מדדים שאפשר לבחור עם המשאב בסעיף FROM. השדה הזה מאוכלס רק בשדות שבהם הערך של category הוא RESOURCE.
segments: מפתחות פילוח (שדות segments.* ומשאבי פילוח) שאפשר לבחור עם המשאב בסעיף FROM. הם מפלחים את המדדים שצוינו בשאילתה. השדה הזה מאוכלס רק בשדות שבהם הערך של category הוא RESOURCE.
selectableWith: משאבים, פלחים או מדדים שאפשר לבחור באותה שאילתה של Google Ads Query Language, כשהמשאב או הפלח הזה הם לא המשאב הראשי בסעיף FROM.

תאימות של שאילתות עם selectableWith

המאפיין selectableWith בשדה של משאב או פלח מציין משאבים, פלחים או מדדים אחרים שאפשר לבחור באותה שאילתה של שפת השאילתות של Google Ads. המאפיין הזה חיוני כשרוצים לכלול שדות ממשאב או מפלח שלא צוינו בסעיף FROM.

כשיוצרים שאילתה בשפת השאילתות של Google Ads:

המשאב בסעיף FROM הוא הישות הראשית. תמיד אפשר לבחור שדות מהמשאב הזה.
אפשר גם לבחור מדדים ופלחים תואמים שזמינים עם הישות הראשית.
אם אתם כוללים שדות ממשאב או מפלח כלשהם מחוץ לסעיף FROM, אתם צריכים לוודא שהמשאב או הפלח הזה, שלא שייכים ל-FROM, תואמים לכל השדות, הפלחים והמדדים האחרים שנבחרו בשאילתה.

הרשימה selectableWith של משאב ספציפי (משאב א') מכילה את כל המשאבים, הפלחים והמדדים האחרים שאפשר לבחור לצד שדות ממשאב א' כשמשאב א' הוא לא הישות הראשית.

דוגמה

הנה שאילתה לדוגמה:

SELECT ad_group.id, segments.date, campaign.name FROM ad_group

הסעיף FROM מציין את ad_group.
השאילתה הזו בוחרת את ad_group.id (מהמשאב FROM), את segments.date ואת campaign.name.
בחרת את campaign.name, אבל campaign לא נמצא בסעיף FROM. לכן, צריך לוודא שהוא תואם לרכיבים האחרים שנבחרו.
כדי לוודא שהשאילתה הזו תקינה, המשאב campaign חייב להיות תואם ל-segments.date (שדה אחר שנבחר). לכן, צריך לבדוק את המאפיין selectableWith של המשאב campaign. אם segments.date נמצא ברשימת selectableWith של campaign, השאילתה תקינה.

אם בוחרים שדות ממשאב שלא נמצא בסעיף FROM, הרשימה selectableWith של המשאב הזה חייבת לכלול את כל הפלחים והמשאבים האחרים שמופיעים בסעיף SELECT.

פרטי המטא-נתונים

אפשר לבקש את הקטלוג באמצעות GoogleAdsFieldService (לפי שם המשאב עם GetGoogleAdsField או באמצעות שאילתה עם SearchGoogleAdsFields) ברמות GoogleAdsFieldCategory הבאות:

משאב (RESOURCE): לדוגמה, googleAdsFields/campaign.
מאפיין המשאב (ATTRIBUTE): לדוגמה, googleAdsFields/campaign.name.
שדה פילוח (SEGMENT): לדוגמה, googleAdsFields/segments.ad_network_type.
מדד (METRIC): לדוגמה, googleAdsFields/metrics.clicks.

מתבצע אחזור של אובייקטים

מבנה השיחה