שמות המשאבים

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

שמות המשאבים שמשמשים ב-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).