Method: mediaItems.list

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

คำขอ HTTP

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

URL ใช้ไวยากรณ์ gRPC Transcoding

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

พารามิเตอร์
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