Method: advertisers.reachForecast.retrievePlannableProducts

ดึงข้อมูลรายการผลิตภัณฑ์ที่วางแผนสำหรับสถานที่ตั้งได้

คำขอ HTTP

GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/reachForecast:retrievePlannableProducts

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
advertiserId

string (int64 format)

ต้องระบุ รหัสของผู้ลงโฆษณาที่จะแสดงผลิตภัณฑ์ที่วางแผนได้

พารามิเตอร์การค้นหา

พารามิเตอร์
plannableLocationId

string

ต้องระบุ รหัสของสถานที่ที่วางแผนได้

เนื้อความของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

การตอบกลับสำหรับ reachForecast.retrievePlannableProducts

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "productMetadata": [
    {
      object (ProductMetadata)
    }
  ]
}
ช่อง
productMetadata[]

object (ProductMetadata)

เอาต์พุตเท่านั้น รายการข้อมูลเมตาของผลิตภัณฑ์ที่แสดงความเป็นไปได้ในการกำหนดเป้าหมาย

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/display-video

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

ProductMetadata

ข้อมูลเมตาสำหรับผลิตภัณฑ์ที่วางแผนได้

การแสดง JSON 
{
  "plannableProductDescription": string,
  "plannableProductCode": string,
  "plannableTargeting": {
    object (PlannableTargeting)
  },
  "displayName": string,
  "plannableProductCoreAttributes": {
    object (PlannableProductCoreAttributes)
  }
}
ช่อง
plannableProductDescription

string

เอาต์พุตเท่านั้น คำอธิบายแบบข้อความธรรมดาของผลิตภัณฑ์โฆษณา
plannableProductCode

string

เอาต์พุตเท่านั้น รหัสผลิตภัณฑ์ที่วางแผนได้ (เช่น "YOUTUBE_REACH_MIX")
plannableTargeting

object (PlannableTargeting)

เอาต์พุตเท่านั้น ความสามารถในการกำหนดเป้าหมายที่พร้อมใช้งานสำหรับผลิตภัณฑ์นี้
displayName

string

เอาต์พุตเท่านั้น ชื่อที่เชื่อมโยงกับผลิตภัณฑ์โฆษณา เช่น "แคมเปญยอดดูวิดีโอ"
plannableProductCoreAttributes

object (PlannableProductCoreAttributes)

เอาต์พุตเท่านั้น แอตทริบิวต์หลักสำหรับผลิตภัณฑ์นี้

PlannableTargeting

ความสามารถในการกำหนดเป้าหมายสำหรับผลิตภัณฑ์หนึ่งๆ

การแสดง JSON 
{
  "ageRanges": [
    enum (PlannableAgeRange)
  ],
  "surfaceTargetingCombinations": {
    object (SurfaceTargetingCombinations)
  },
  "genders": [
    enum (Gender)
  ],
  "networks": [
    enum (PlannableNetwork)
  ],
  "devices": [
    enum (DeviceType)
  ],
  "youtubeSelectLineups": [
    {
      object (YouTubeSelectLineUp)
    }
  ],
  "defaultYoutubeSelectLineup": {
    object (YouTubeSelectLineUp)
  }
}
ช่อง
ageRanges[]

enum (PlannableAgeRange)

เอาต์พุตเท่านั้น ช่วงอายุที่วางแผนได้ที่อนุญาตสำหรับผลิตภัณฑ์ การกำหนดเป้าหมายจริงจะคำนวณโดยการจับคู่ช่วงอายุนี้กับการกำหนดเป้าหมายตามอายุมาตรฐานของ Google
surfaceTargetingCombinations

object (SurfaceTargetingCombinations)

เอาต์พุตเท่านั้น ชุดรวมแพลตฟอร์มที่กำหนดเป้าหมายได้สำหรับผลิตภัณฑ์โฆษณา
genders[]

enum (Gender)

เอาต์พุตเท่านั้น เพศที่กำหนดเป้าหมายได้สำหรับผลิตภัณฑ์โฆษณา
networks[]

enum (PlannableNetwork)

เอาต์พุตเท่านั้น เครือข่ายที่กำหนดเป้าหมายได้สำหรับผลิตภัณฑ์โฆษณา
devices[]

enum (DeviceType)

เอาต์พุตเท่านั้น อุปกรณ์ที่กำหนดเป้าหมายได้สำหรับผลิตภัณฑ์โฆษณา
youtubeSelectLineups[]

object (YouTubeSelectLineUp)

เอาต์พุตเท่านั้น รายการช่อง YouTube Select ที่กำหนดเป้าหมายได้สำหรับผลิตภัณฑ์โฆษณา
defaultYoutubeSelectLineup

object (YouTubeSelectLineUp)

เอาต์พุตเท่านั้น รายการช่อง YouTube Select เริ่มต้นสำหรับผลิตภัณฑ์นี้ (หากมี)

SurfaceTargetingCombinations

กฎการกำหนดเป้าหมายแพลตฟอร์ม

การแสดง JSON 
{
  "availableSurfaceTypes": [
    enum (PlannableSurface)
  ],
  "validSurfaceCombinations": [
    {
      object (SurfaceTargetingCombination)
    }
  ],
  "defaultSurfaceTypes": [
    enum (PlannableSurface)
  ]
}
ช่อง
availableSurfaceTypes[]

enum (PlannableSurface)

เอาต์พุตเท่านั้น ประเภทแพลตฟอร์มที่ใช้ได้
validSurfaceCombinations[]

object (SurfaceTargetingCombination)

เอาต์พุตเท่านั้น ชุดค่าผสมที่ถูกต้องของแพลตฟอร์มที่เลือกพร้อมกันได้
defaultSurfaceTypes[]

enum (PlannableSurface)

เอาต์พุตเท่านั้น ประเภทแพลตฟอร์มเริ่มต้นสำหรับผลิตภัณฑ์นี้

SurfaceTargetingCombination

ชุดค่าผสมของแพลตฟอร์มที่ถูกต้อง

การแสดง JSON 
{
  "choices": [
    enum (PlannableSurface)
  ]
}
ช่อง
choices[]

enum (PlannableSurface)

เอาต์พุตเท่านั้น การรวมกันของแพลตฟอร์ม

YouTubeSelectLineUp

รายการช่อง YouTube Select ที่วางแผนได้สำหรับการกำหนดเป้าหมายผลิตภัณฑ์

การแสดง JSON 
{
  "lineupId": string,
  "displayName": string
}
ช่อง
lineupId

string (int64 format)

เอาต์พุตเท่านั้น รหัสของรายการช่อง YouTube Select
displayName

string

เอาต์พุตเท่านั้น ชื่อที่แสดงของรายการช่อง YouTube Select

PlannableProductCoreAttributes

แอตทริบิวต์หลักสำหรับผลิตภัณฑ์ที่วางแผนได้

การแสดง JSON 
{
  "productCategory": enum (PlannableProductCategory),
  "buyingMethod": enum (PlannableBuyingMethod),
  "costModel": enum (PlannableCostModel)
}
ช่อง
productCategory

enum (PlannableProductCategory)

เอาต์พุตเท่านั้น หมวดหมู่สินค้า
buyingMethod

enum (PlannableBuyingMethod)

เอาต์พุตเท่านั้น วิธีการซื้อ
costModel

enum (PlannableCostModel)

เอาต์พุตเท่านั้น รูปแบบต้นทุน

PlannableBuyingMethod

วิธีการซื้อผลิตภัณฑ์ที่วางแผนได้

Enum
PLANNABLE_BUYING_METHOD_UNSPECIFIED ไม่ได้ระบุ
PLANNABLE_BUYING_METHOD_AUCTION การประมูล
PLANNABLE_BUYING_METHOD_RESERVATION การจอง

PlannableCostModel

รูปแบบต้นทุนของผลิตภัณฑ์ที่วางแผนได้

Enum
PLANNABLE_COST_MODEL_UNSPECIFIED ไม่ได้ระบุ
PLANNABLE_COST_MODEL_CPM CPM
PLANNABLE_COST_MODEL_CPV CPV
PLANNABLE_COST_MODEL_CPC CPC
PLANNABLE_COST_MODEL_CPA CPA สูงสุด