Method: exchanges.publishers.list

แสดงรายชื่อผู้เผยแพร่โฆษณา

คำขอ HTTP

GET https://dv360seller.googleapis.com/v1beta1/{parent=exchanges/*}/publishers

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

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

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

string

ต้องระบุ ชื่อทรัพยากรระดับบน ตัวอย่าง: exchanges/123

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

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

integer

ไม่บังคับ จำนวนรายการสูงสุดที่จะแสดงผล ค่าสูงสุดที่อนุญาตคือ 50 หากไม่ได้ระบุหรือระบุมากกว่า 50 ระบบจะใช้ 50 เป็นขนาดหน้า
pageToken

string

ไม่บังคับ ค่า nextPageToken ที่แสดงผลจากคำขอ List ก่อนหน้า (หากมี)
filter

string

ไม่บังคับ อนุญาตให้กรองตามพร็อพเพอร์ตี้ของผู้เผยแพร่โฆษณา

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

  • นิพจน์ตัวกรองประกอบด้วยข้อจำกัดอย่างน้อย 1 ข้อ
  • คุณสามารถรวมข้อจำกัดโดยใช้ตัวดำเนินการตรรกะ AND หรือ OR ลำดับข้อจำกัดจะใช้ AND โดยนัย
  • ข้อจำกัดมีรูปแบบเป็น <field> <operator> <value>
  • ตัวดำเนินการต้องเป็น EQUALS (=)
  • ช่องที่รองรับ
    • ExternalPublisherId
    • DisplayName
    • Status

ตัวอย่าง

  • รับผู้เผยแพร่โฆษณาที่มีสถานะเป็นใช้งานอยู่ status=DISCOVERY_OBJECT_STATUS_ACTIVE

  • รับผู้เผยแพร่โฆษณาที่มีชื่อที่แสดงเป็น display name displayName="display name"

ความยาวของช่องนี้ต้องไม่เกิน 500 ตัวอักษร

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

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

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

การตอบกลับเพื่อแสดงรายชื่อผู้เผยแพร่โฆษณา

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "publishers": [
    {
      object (Publisher)
    }
  ],
  "nextPageToken": string
}
ช่อง
publishers[]

object (Publisher)

ผู้เผยแพร่โฆษณาที่แสดง ระบบจะแสดงผลรายการตามจำนวนสูงสุดที่อิงตามช่อง pageSize ในคำขอ
nextPageToken

string

โทเค็นเพื่อดึงข้อมูลผลลัพธ์หน้าถัดไป หรือว่างเปล่าหากไม่มีผลลัพธ์เพิ่มเติมในรายการ

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

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

  • https://www.googleapis.com/auth/doubleclickbidmanager

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview