שמות המשאבים

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

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

משאב שם המשאב
לקוח/ה 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.

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

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