היררכיית שמות
שמות המשאבים שמשמשים ב-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
אפשר לפרק את הנתיב הזה למזהי המשאבים הנפרדים שלו (מופרדים על ידי מזהי אוספים) באופן הבא:
| רכיבים של שמות משאבים | |||||||
|---|---|---|---|---|---|---|---|
| מזהי משאבים |
|
||||||
| מזהי אוספים |
|
||||||
ניתוח המזהים הנפרדים מאפשר לכם לגזור שמות חדשים של משאבים כדי להפנות ללקוח של המודעה בקבוצת המודעות (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.
זו אותה פעולת המרה בסיסית, אבל שם המשאב שלה הוא יחסי לחשבון שדרכו ניגשים אליה.