Method: advertisers.channels.sites.list

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

คำขอ HTTP

GET https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/channels/{channelId}/sites

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

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

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

string (int64 format)

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

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

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 ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
partnerId

string (int64 format)

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

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

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

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

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

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

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

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

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