Method: sellers.orders.list

แสดงรายการคำสั่งซื้อ

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

คำขอ HTTP

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

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

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

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

string

ต้องระบุ ระดับบนสุดที่เป็นเจ้าของคอลเล็กชันคำสั่งซื้อนี้ รูปแบบ: ผู้ขาย/{seller}

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

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

integer

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

string

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

string

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

string

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

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

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

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

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

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

object (Order)

รายการคำสั่งซื้อ
nextPageToken

string

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

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

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

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

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