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)

ช่วงอายุที่วางแผนได้ที่อนุญาตสำหรับผลิตภัณฑ์ซึ่งจะรายงานเมตริก การกำหนดเป้าหมายจริงคำนวณโดยการแมปช่วงอายุนี้กับค่า Common.AgeRangeInfo มาตรฐานของ Google
genders[]

object (GenderInfo)

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

object (DeviceInfo)

อุปกรณ์ที่กำหนดเป้าหมายได้สำหรับผลิตภัณฑ์โฆษณา ระบบจะใช้การกำหนดอุปกรณ์เป้าหมายในแท็บเล็ตกับเมตริกที่รายงานโดยอัตโนมัติเมื่อเลือกการกำหนดเป้าหมายอุปกรณ์เคลื่อนที่สำหรับผลิตภัณฑ์ CPM_MASTHEAD, GOOGLE_PREFERRED_BUMPER และ GOOGLE_PREFERRED_SHORT
networks[]

enum (ReachPlanNetwork)

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

object (YouTubeSelectLineUp)

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

object (SurfaceTargetingCombinations)

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

YouTubeSelectLineUp

รายการช่อง 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)

ชุดค่าผสมของเป้าหมายแพลตฟอร์มที่ใช้ได้สำหรับผลิตภัณฑ์โฆษณา