Method: listPlannableProducts

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

רשימת שגיאות שקרו: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

בקשת HTTP

POST https://googleads.googleapis.com/v16: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 מוחל באופן אוטומטי על מדדים שדווחו כשנבחרה טירגוט לפי MOBILE עבור המוצרים 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)

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