שמות המשאבים

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

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

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

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