Method: listPlannableProducts

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

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

בקשת HTTP

POST https://googleads.googleapis.com/v14: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)
    }
  ]
}
שדות
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 שניתן לטרגט עבור מוצר המודעה.

YouTubeSelectLineUp

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

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

string (int64 format)

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

string

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