Method: partners.channels.sites.list

แสดงรายการเว็บไซต์ในช่อง

คำขอ HTTP

GET https://displayvideo.googleapis.com/v2/partners/{partnerId}/channels/{channelId}/sites

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

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

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

string (int64 format)

ต้องระบุ รหัสของช่องหลักที่เว็บไซต์ที่ขอเป็นของ

พารามิเตอร์ Union owner ต้องระบุ ระบุเอนทิตี DV360 ที่เป็นเจ้าของช่องหลัก โดยอาจเป็นพาร์ทเนอร์หรือผู้ลงโฆษณาก็ได้ owner ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
partnerId

string (int64 format)

รหัสของพาร์ทเนอร์ที่เป็นเจ้าของช่องหลัก

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

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

integer

ขนาดหน้าที่ขอ ต้องอยู่ระหว่าง 1 ถึง 10000 หากไม่ได้ระบุ ระบบจะใช้ 100 เป็นค่าเริ่มต้น แสดงรหัสข้อผิดพลาด INVALID_ARGUMENT หากระบุค่าที่ไม่ถูกต้อง

pageToken

string

โทเค็นที่ระบุหน้าผลลัพธ์ที่เซิร์ฟเวอร์ควรแสดง

โดยปกติแล้ว ค่านี้คือค่าของ nextPageToken ที่ส่งคืนจากการเรียกเมธอด sites.list ครั้งก่อน หากไม่ได้ระบุ ระบบจะแสดงผลหน้าแรกของผลการค้นหา

orderBy

string

ฟิลด์ที่ใช้จัดเรียงรายการ ค่าที่ยอมรับมีดังนี้

  • urlOrAppId (ค่าเริ่มต้น)

ลำดับการจัดเรียงเริ่มต้นคือจากน้อยไปมาก หากต้องการระบุลำดับจากมากไปน้อยสำหรับฟิลด์ ให้เพิ่มคำต่อท้าย " desc" ในชื่อฟิลด์ ตัวอย่าง: urlOrAppId desc

filter

string

อนุญาตให้กรองตามช่องเว็บไซต์

ไวยากรณ์ที่รองรับ

  • นิพจน์ตัวกรองสำหรับการดึงข้อมูลเว็บไซต์มีข้อจำกัดได้สูงสุดเพียง 1 รายการ
  • ข้อจำกัดมีรูปแบบเป็น {field} {operator} {value}
  • ทุกช่องต้องใช้วันที่โดยมีตัวดำเนินการ HAS (:)

ฟิลด์ที่รองรับ

  • urlOrAppId

ตัวอย่าง

  • เว็บไซต์ทั้งหมดที่ URL หรือรหัสแอปมีคำว่า "google": urlOrAppId : "google"

ฟิลด์นี้ควรมีความยาวไม่เกิน 500 อักขระ

ดูข้อมูลเพิ่มเติมได้ในคำแนะนำเกี่ยวกับคำขอLISTตัวกรอง

พารามิเตอร์ Union owner ต้องระบุ ระบุเอนทิตี DV360 ที่เป็นเจ้าของช่องหลัก โดยอาจเป็นพาร์ทเนอร์หรือผู้ลงโฆษณาก็ได้ owner ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
advertiserId

string (int64 format)

รหัสของผู้ลงโฆษณาที่เป็นเจ้าของช่องหลัก

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

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

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

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ ListSitesResponse

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

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

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

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0