שמות המשאבים

היררכיית שמות

שמות המשאבים שבהם נעשה שימוש ב-Search Ads 360 Reporting API הם היררכיים, שמשקפים את ארגון הישויות ב-Search Ads 360. כמעט כל המשאבים הם משאבי משנה של המשאב Customer, שמשקף את העובדה שכמעט כל קריאה ל-API צריכה לטרגט לחשבון Search Ads 360 ספציפי. לדוגמה, קמפיינים, קבוצות של מודעות, מודעות ומילות מפתח הם משאבי משנה של משאב לקוח ברמה הבסיסית (root).

משאב	שם המשאב
לקוח/ה	customers/1234567890
קמפיין	customers/1234567890/campaigns/8765432109
AdGroup	customers/1234567890/adGroups/54321098765
AdGroupAd	customers/1234567890/adGroupAds/54321098765~2109876543210

נקודה חשובה: ב-Search Ads 360 Reporting API נעשה שימוש בשמות relative של משאבים (ולא בשמות משאבים relative כמו בממשקי Google API אחרים).

מזהי המשאבים

ההתייחסות לישויות של Search Ads 360 Reporting API (לקוחות, קמפיינים וכו') מתבצעת באמצעות שמות המשאבים שלהן בכל ה-API. עם זאת, חשוב לציין שלשמות המשאבים עצמם יכולים להיות מזהי משאבים מספריים ייחודיים שמזהים כל אובייקט בהיררכיה. במקרים כאלה, כדאי לנתח את שם המשאב כדי לחלץ את מזהי המשאבים האלה ולהרכיב מזהה חדש.

לדוגמה, בודקים את שם המשאב AdGroupAd מהטבלה הקודמת:

customers/1234567890/adGroupAds/54321098765~2109876543210

אפשר לפצל את הפרויקט למזהי המשאבים הנפרדים שלו (מופרדים באמצעות מזהי אוספים) באופן הבא:

רכיבים של שם המשאב
מזהי משאבים	מספר לקוח: "1234567890" מזהה קבוצת המודעות: "54321098765" מזהה מודעה בקבוצת מודעות: "2109876543210"
מזהי קולקציות	"customers" "adGroupAds"

ניתוח המזהים הנפרדים מאפשר לחלץ שמות של משאבים חדשים כדי להפנות ללקוח של המודעה בקבוצת המודעות (customers/1234567890) או לקבוצת המודעות שלה (customers/1234567890/adGroupAds/54321098765).

נקודה חשובה: ההפניה לשמות משאבים בגופי בקשות ותגובה של JSON מתבצעת על ידי השדה resourceName ולא על ידי השדה name כמו בחלק מממשקי API אחרים של Google Cloud. לישויות רבות ב-Search Ads 360 יש מאפייני שמות עצמיים (campaign.Name, adGroup.Name וכו'), ולכן אנחנו משתמשים ב-resourceName כדי למנוע התנגשות עם שמות של אובייקטים קיימים.