Method: partners.channels.sites.list

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

คำขอ HTTP

GET https://displayvideo.googleapis.com/v3/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