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