Method: albums.list

แสดงอัลบั้มทั้งหมดที่แสดงต่อผู้ใช้ในแท็บอัลบั้มของแอป Google Photos

คำขอ HTTP

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

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

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

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

integer

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

string

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

boolean

หากตั้งค่า ผลลัพธ์จะยกเว้นรายการสื่อที่ไม่ได้สร้างขึ้นโดยแอปนี้ ค่าเริ่มต้นคือ false (ระบบจะแสดงอัลบั้มทั้งหมด) ระบบจะไม่สนใจช่องนี้หากใช้ขอบเขต photoslibrary.readonly.appcreateddata

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

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

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

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

รายชื่ออัลบั้มที่ขอ

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

object (Album)

เอาต์พุตเท่านั้น รายการอัลบั้มที่แสดงในแท็บอัลบั้มของแอป Google Photos ของผู้ใช้
nextPageToken

string

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

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

ต้องมีขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

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