Method: mediaItems.list

แสดงผลรายการสื่อที่ผู้ใช้เลือกระหว่างเซสชันที่ระบุ

ระบบจะแสดงผลข้อผิดพลาด FAILED_PRECONDITION หากเซสชันยังไม่มีรายการสื่อที่เลือก คุณจึงแสดงเนื้อหาสื่อไม่ได้ ในสถานการณ์นี้ แอปพลิเคชันที่ทำงานในอุปกรณ์อินพุตที่จำกัดควรแสดงผลคิวอาร์โค้ดที่เข้ารหัส pickerUri ของเซสชัน เพื่อให้ผู้ใช้สแกนโค้ดและเลือกรายการสื่อใน UI เครื่องมือเลือกของ Google Photos ระหว่างที่รอผู้ใช้เลือกสินค้า ลูกค้าควรทำแบบสำรวจ sessions.get 1 ครั้งทุกๆ pollingConfig.pollInterval จนถึง pickedItemsSet = true ในคำตอบของ sessions.get เมื่อถึงเวลานั้น ลูกค้าอาจกลับมาโทรติดต่อ mediaItems.list อีกครั้งและคาดว่าจะได้รับการตอบกลับที่สำเร็จ

คำขอ HTTP

GET https://photospicker.googleapis.com/v1/mediaItems

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

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

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

string

ต้องระบุ ตัวระบุที่ Google สร้างขึ้นสำหรับเซสชันนี้
pageSize

integer

ไม่บังคับ จำนวนรายการสื่อสูงสุดที่จะแสดง

บริการอาจแสดงผลน้อยกว่าค่านี้ (รวมถึงผลลัพธ์เป็น 0) หากไม่ระบุหรือตั้งค่าเป็น 0 ระบบจะแสดงผลสื่อสูงสุด 50 รายการ ค่าสูงสุดคือ 100 ค่าที่มากกว่า 100 จะถูกเปลี่ยนเป็น 100 ค่าติดลบจะทำให้เกิดข้อผิดพลาด INVALID_ARGUMENT
pageToken

string

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

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

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

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

การตอบกลับ RPC ของ mediaItems.list

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

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

object (PickedMediaItem)

หน้ารายการสื่อที่เลือก
nextPageToken

string

โทเค็นที่ส่งในฐานะ pageToken เพื่อเรียกข้อมูลหน้าถัดไปในคำขอ mediaItems.list ได้

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

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

  • https://www.googleapis.com/auth/photospicker.mediaitems.readonly