Method: sharedAlbums.list

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

คำขอ HTTP

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

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

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

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

integer

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

string

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

boolean

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

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

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

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

รายการอัลบั้มที่แชร์ซึ่งขอ

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

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

object (Album)

เอาต์พุตเท่านั้น รายการอัลบั้มที่แชร์
nextPageToken

string

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

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

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

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