Method: sharedAlbums.list

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

คำขอ HTTP

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

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

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

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