Method: mediaItems.list

แสดงรายการสื่อทั้งหมดจากคลังภาพ Google Photos ของผู้ใช้

คำขอ HTTP

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

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

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

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

integer

จำนวนรายการสื่อสูงสุดที่จะแสดงในการตอบกลับ อาจส่งคืนรายการสื่อน้อยกว่าจำนวนที่ระบุ ค่าเริ่มต้นคือ pageSize คือ 25 ค่าสูงสุดคือ 100
pageToken

string

โทเค็นต่อเนื่องเพื่อรับผลลัพธ์หน้าถัดไป การเพิ่มเงื่อนไขนี้ลงในคําขอจะแสดงผลแถวหลัง pageToken pageToken ควรเป็นค่าที่แสดงในพารามิเตอร์ nextPageToken ในการตอบกลับคําขอ listMediaItems

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

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

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

รายการสื่อทั้งหมดจากคลังภาพ Google Photos ของผู้ใช้

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

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

object (MediaItem)

เอาต์พุตเท่านั้น รายการสื่อในไลบรารีของผู้ใช้
nextPageToken

string

เอาต์พุตเท่านั้น โทเค็นที่จะใช้รับรายการสื่อชุดถัดไป การมีอยู่นี้เป็นตัวบ่งชี้เดียวที่เชื่อถือได้ว่ามีรายการสื่ออื่นๆ พร้อมใช้งานในคำขอถัดไป

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

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

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.readonly
  • https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata