Method: accounts.promotions.list

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

หลังจากแทรกหรืออัปเดตโปรโมชันแล้ว อาจใช้เวลาหลายนาทีกว่าระบบจะเรียกข้อมูลโปรโมชันที่ประมวลผลแล้วที่อัปเดตได้

คำขอ HTTP

GET https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions

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

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

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

string

ต้องระบุ บัญชีที่จะแสดงโปรโมชันที่ประมวลผลแล้ว รูปแบบ: accounts/{account}

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

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

integer

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

string

เอาต์พุตเท่านั้น โทเค็นของหน้าเว็บที่ได้รับจากการโทร promotions.list ก่อนหน้า โปรดระบุข้อมูลนี้เพื่อเรียกข้อมูลหน้าถัดไป

เมื่อใส่เลขหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ให้กับ promotions.list ต้องตรงกับการเรียกใช้ที่ระบุโทเค็นของหน้าเว็บ

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

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

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

ข้อความตอบกลับสำหรับเมธอด promotions.list

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

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

object (Promotion)

โปรโมชันที่ประมวลผลจากบัญชีที่ระบุ
nextPageToken

string

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

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

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

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

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