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

หากตั้งค่าไว้ ผลลัพธ์จะยกเว้นรายการสื่อที่ไม่ได้สร้างโดยแอปนี้ ค่าเริ่มต้นเป็น false (ระบบจะส่งคืนอัลบั้มทั้งหมด) ระบบจะไม่สนใจช่องนี้ หากใช้ขอบเขต 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