שמות המשאבים

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

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

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

מזהי המשאבים

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

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

customers/1234567890/adGroupAds/54321098765~2109876543210

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

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

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

מזהים של אובייקטים משותפים

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

שמות המשאבים של אובייקטים כאלה ישתנו בהתאם לחשבון שאליו שולחים את קריאת ה-API.

דוגמה: פעולות המרה ברמת חשבון ניהול

נניח שיש לנו חשבון ניהול 987-654-3210 שמשתף פעולת המרה בין חשבונות עם אחד מחשבונות הלקוח שלו, 123-456-7890:

תרשים שבו מוצג הקשר בין שמות המשאבים להיררכיות החשבונות.

קריאה ל-API בחשבון הניהול, למשל כדי לעדכן את חלון המבט לאחור של פעולת ההמרה, תתייחס לאובייקט המשותף באמצעות שם המשאב: customers/9876543210/conversionActions/257733534.

קריאה ל-API בחשבון הלקוח כדי להביע הסכמה לשימוש בפעולת ההמרה המשותפת תתייחס אליה באמצעות שם המשאב: customers/1234567890/conversionActions/257733534.

זוהי אותה פעולת המרה בסיסית, אבל שם המשאב שלה הוא יחסי לחשבון שבו נעשה שימוש כדי לגשת אליה.

הקודם
סקירה כללית
הבא
שיטות שירות