שמות המשאבים

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

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

משאב שם המשאב
לקוח/ה customers/1234567890
קמפיין customers/1234567890/campaigns/8765432109
AdGroup 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.

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

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