שמות המשאבים

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

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

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

מזהי המשאבים

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

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

customers/1234567890/adGroupAds/54321098765~2109876543210

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

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

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