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