- בקשת HTTP
- גוף הבקשה
- גוף התשובה
- היקפי הרשאות
- ProductMetadata
- PlannableTargeting
- YouTubeSelectLineUp
- SurfaceTargetingCombinations
- רוצים לנסות?
מחזירה את רשימת הפורמטים של מודעות YouTube שניתנים לתכנון לפי מיקום עם טירגוט מותר.
רשימת שגיאות הטמעה: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError
בקשת HTTP
POST https://googleads.googleapis.com/v15:listPlannableProducts
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "plannableLocationId": string } |
שדות | |
---|---|
plannableLocationId |
חובה. המזהה של המיקום שנבחר לתכנון. כדי להציג את המזהים הזמינים של מיקומים בתוכנית, יש להשתמש ב- |
גוף התגובה
תשובה עם כל המוצרים הזמינים.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{
"productMetadata": [
{
object ( |
שדות | |
---|---|
productMetadata[] |
רשימת המוצרים הזמינים לתכנון ולמטא-נתונים של טירגוט קשור. |
היקפי הרשאות
נדרש היקף OAuth הבא:
https://www.googleapis.com/auth/adwords
למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.
ProductMetadata
המטא-נתונים המשויכים למוצר זמין שניתן לתכנן.
ייצוג JSON |
---|
{
"plannableProductName": string,
"plannableTargeting": {
object ( |
שדות | |
---|---|
plannableProductName |
השם שמשויך למוצר המודעה. |
plannableTargeting |
הטירגוט המותר לתכנון המוצר הזה. |
plannableProductCode |
הקוד שמשויך למוצר המודעות (לדוגמה: BUMPER, TRUEVIEW_IN_STREAM). כדי להציג את קודי המוצרים הזמינים לתכנון, משתמשים באפשרות |
PlannableTargeting
הטירגוט שעבורו ידווחו מדדי התנועה.
ייצוג JSON |
---|
{ "ageRanges": [ enum ( |
שדות | |
---|---|
ageRanges[] |
טווחי גילאים מותרים לתכנון של המוצר שלגביו ידווחו המדדים. המיקוד בפועל מחושב על ידי מיפוי טווח הגילאים הזה לערכים סטנדרטיים של Google Common.AgeRangeInfo. |
genders[] |
מגדרים שניתן לטרגט עבור מוצר המודעות. |
devices[] |
מכשירים הניתנים לטירגוט עבור מוצר המודעות. טירגוט לפי מכשיר TABLET מיושם באופן אוטומטי על מדדים מדווחים כאשר האפשרות 'טירגוט לפי מכשיר נייד' נבחרת עבור המוצרים CPM_MASTHEAD, GOOGLE_PREFERRED_BUMPER ו-GOOGLE_PREFERRED_SHORT. |
networks[] |
רשתות שניתן לטרגט עבור מוצר המודעות. |
youtubeSelectLineups[] |
חבילות ערוצים של YouTube Select שניתן לטרגט עבור מוצר המודעה. |
surfaceTargeting |
שילובים של פלטפורמות שניתן לטרגט אליהן עבור מוצר המודעה. |
YouTubeSelectLineUp
חבילת ערוצים Plannable YouTube Select לטירגוט מוצרים.
ייצוג JSON |
---|
{ "lineupId": string, "lineupName": string } |
שדות | |
---|---|
lineupId |
המזהה של חבילת הערוצים של YouTube Select. |
lineupName |
השם הייחודי של חבילת הערוצים של YouTube Select. |
SurfaceTargetingCombinations
שילובי הטירגוט בפלטפורמות השונות שזמינים למוצר מודעה.
ייצוג JSON |
---|
{ "defaultTargeting": { object ( |
שדות | |
---|---|
defaultTargeting |
טירגוט ברירת המחדל לפלטפורמה הוחל על מוצר המודעות. |
availableTargetingCombinations[] |
שילובים זמינים של יעדי הפלטפורמה עבור מוצר המודעה. |