שמות המשאבים

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

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

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

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

מזהי המשאבים

האזכור של ישויות ב-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 כדי למנוע התנגשות עם שמות אובייקטים קיימים.