Method: listPlannableProducts

מחזירה את רשימת הפורמטים של מודעות YouTube שניתנים לתכנון לפי מיקום עם טירגוט מותר.

רשימת שגיאות הטמעה: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

בקשת HTTP

POST https://googleads.googleapis.com/v15:listPlannableProducts

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "plannableLocationId": string
}
שדות
plannableLocationId

string

חובה. המזהה של המיקום שנבחר לתכנון. כדי להציג את המזהים הזמינים של מיקומים בתוכנית, יש להשתמש ב-ReachPlanService.ListPlannableLocations.

גוף התגובה

תשובה עם כל המוצרים הזמינים.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:

ייצוג JSON 
{
  "productMetadata": [
    {
      object (ProductMetadata)
    }
  ]
}
שדות
productMetadata[]

object (ProductMetadata)

רשימת המוצרים הזמינים לתכנון ולמטא-נתונים של טירגוט קשור.

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://www.googleapis.com/auth/adwords

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.

ProductMetadata

המטא-נתונים המשויכים למוצר זמין שניתן לתכנן.

ייצוג JSON 
{
  "plannableProductName": string,
  "plannableTargeting": {
    object (PlannableTargeting)
  },
  "plannableProductCode": string
}
שדות
plannableProductName

string

השם שמשויך למוצר המודעה.
plannableTargeting

object (PlannableTargeting)

הטירגוט המותר לתכנון המוצר הזה.
plannableProductCode

string

הקוד שמשויך למוצר המודעות (לדוגמה: BUMPER, TRUEVIEW_IN_STREAM). כדי להציג את קודי המוצרים הזמינים לתכנון, משתמשים באפשרות ReachPlanService.ListPlannableProducts.

PlannableTargeting

הטירגוט שעבורו ידווחו מדדי התנועה.

ייצוג JSON 
{
  "ageRanges": [
    enum (ReachPlanAgeRange)
  ],
  "genders": [
    {
      object (GenderInfo)
    }
  ],
  "devices": [
    {
      object (DeviceInfo)
    }
  ],
  "networks": [
    enum (ReachPlanNetwork)
  ],
  "youtubeSelectLineups": [
    {
      object (YouTubeSelectLineUp)
    }
  ],
  "surfaceTargeting": {
    object (SurfaceTargetingCombinations)
  }
}
שדות
ageRanges[]

enum (ReachPlanAgeRange)

טווחי גילאים מותרים לתכנון של המוצר שלגביו ידווחו המדדים. המיקוד בפועל מחושב על ידי מיפוי טווח הגילאים הזה לערכים סטנדרטיים של Google Common.AgeRangeInfo.
genders[]

object (GenderInfo)

מגדרים שניתן לטרגט עבור מוצר המודעות.
devices[]

object (DeviceInfo)

מכשירים הניתנים לטירגוט עבור מוצר המודעות. טירגוט לפי מכשיר TABLET מיושם באופן אוטומטי על מדדים מדווחים כאשר האפשרות 'טירגוט לפי מכשיר נייד' נבחרת עבור המוצרים CPM_MASTHEAD, GOOGLE_PREFERRED_BUMPER ו-GOOGLE_PREFERRED_SHORT.
networks[]

enum (ReachPlanNetwork)

רשתות שניתן לטרגט עבור מוצר המודעות.
youtubeSelectLineups[]

object (YouTubeSelectLineUp)

חבילות ערוצים של YouTube Select שניתן לטרגט עבור מוצר המודעה.
surfaceTargeting

object (SurfaceTargetingCombinations)

שילובים של פלטפורמות שניתן לטרגט אליהן עבור מוצר המודעה.

YouTubeSelectLineUp

חבילת ערוצים Plannable YouTube Select לטירגוט מוצרים.

ייצוג JSON 
{
  "lineupId": string,
  "lineupName": string
}
שדות
lineupId

string (int64 format)

המזהה של חבילת הערוצים של YouTube Select.
lineupName

string

השם הייחודי של חבילת הערוצים של YouTube Select.

SurfaceTargetingCombinations

שילובי הטירגוט בפלטפורמות השונות שזמינים למוצר מודעה.

ייצוג JSON 
{
  "defaultTargeting": {
    object (SurfaceTargeting)
  },
  "availableTargetingCombinations": [
    {
      object (SurfaceTargeting)
    }
  ]
}
שדות
defaultTargeting

object (SurfaceTargeting)

טירגוט ברירת המחדל לפלטפורמה הוחל על מוצר המודעות.
availableTargetingCombinations[]

object (SurfaceTargeting)

שילובים זמינים של יעדי הפלטפורמה עבור מוצר המודעה.