Method: partners.channels.sites.list

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

คำขอ HTTP

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

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

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

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

string (int64 format)

ต้องระบุ รหัสของช่องหลักของเว็บไซต์ที่ขอ
พารามิเตอร์การรวม 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
พารามิเตอร์การรวม owner ต้องระบุ ระบุเอนทิตี DV360 ที่เป็นเจ้าของช่องหลัก อาจเป็นพาร์ทเนอร์หรือผู้ลงโฆษณาก็ได้ owner ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
advertiserId

string (int64 format)

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

เนื้อหาของคำขอ

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

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

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

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

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

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

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