Method: sellers.adUnits.list

แสดงรายการหน่วยโฆษณา

  • ตัวอย่างเช่น GET /v1/sellers/seller111/adUnits
  • แสดงรายการหน่วยโฆษณาและโทเค็นเพื่อเรียกข้อมูลหน้าถัดไปหากสำเร็จ
  • ส่งคืนรหัสข้อผิดพลาด PERMISSION_DENIED หากผู้ใช้ไม่มีสิทธิ์เข้าถึงรหัสผู้ขายหรือผู้ขาย
  • ส่งคืนรหัสข้อผิดพลาด INVALID_ARGUMENT หากผู้ขายระบุขนาดหน้าหรือโทเค็นหน้าที่ไม่ถูกต้อง

คำขอ HTTP

GET https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/adUnits

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

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

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

string

ต้องระบุ ผู้ขายซึ่งเป็นเจ้าของคอลเล็กชันหน่วยโฆษณานี้ รูปแบบ: ผู้ขาย/{seller}

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

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

integer

จำนวนรายการสูงสุดที่จะแสดง บริการอาจแสดงผลน้อยกว่าค่านี้ จำนวนหน่วยโฆษณาสูงสุดที่อนุญาตคือ 1,000 ค่าที่มากกว่า 1000 จะเปลี่ยนเป็น 1000 หากไม่ระบุ จะส่งหน่วยโฆษณากลับมาไม่เกิน 1, 000 หน่วย
pageToken

string

ค่า nextPageToken ที่แสดงผลจากคำขอรายการก่อนหน้า หากมี
filter

string

ตัวกรองรายการ ขณะนี้รองรับการกรองสถานะและรหัสภายนอกด้วยไวยากรณ์: "externalId = [EXTERNAL_ID]" และ "state = [STATE]" โอเปอเรเตอร์เชิงตรรกะ AND และ OR สามารถใช้เพื่อเชื่อมโยงตัวกรองได้ ไม่สามารถใช้ AD_UNIT_STATE_DELETED เพื่อแสดงหน่วยโฆษณาที่ลบไปแล้ว โปรดใช้ showDELETE แทน
orderBy

string

ลำดับตามสตริงที่ใช้ระบุลำดับการจัดเรียงผลการค้นหา ปัจจุบันรองรับการสั่งซื้อโดย updateTime โปรดระบุ "updateTime" เพื่อจัดเรียงผลลัพธ์ตาม updateTime ในลำดับจากน้อยไปมาก หรือ "updateTime desc" ตามลำดับจากมากไปน้อย
showDeleted

boolean

เลือกว่าจะแสดงหน่วยโฆษณาที่ลบชั่วคราวหรือไม่

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

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

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

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

ข้อความตอบกลับสำหรับ InventoryService.ListAdUnits

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

object (AdUnit)

รายการหน่วยโฆษณา
nextPageToken

string

โทเค็นเพื่อเรียกผลลัพธ์หน้าถัดไป ส่งต่อค่านี้ในฟิลด์ pageToken ในการเรียกครั้งต่อๆ ไปไปยังเมธอด adUnits.list เพื่อดึงผลลัพธ์หน้าถัดไป

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

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

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

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