Method: albums.list

列出應用程式建立的所有相簿。

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

這個網址使用 gRPC 轉碼語法。

參數

參數
`pageSize`	`integer` 回覆中傳回的專輯數量上限。傳回的專輯數量可能少於指定數量。預設 `pageSize` 為 20，上限為 50。
`pageToken`	`string` 用來取得結果下一頁的接續符記。將這項值加入要求後，系統會傳回 `pageToken` 之後的資料列。`pageToken` 應為 `listAlbums` 要求回應中 `nextPageToken` 參數傳回的值。
`excludeNonAppCreatedData`	`boolean` 如果設為 true，結果就會排除非由此應用程式建立的媒體項目。預設值為 false (會傳回所有專輯)。如果使用 photoslibrary.readonly.appcreateddata 範圍，系統會忽略這個欄位。

pageSize

integer

回覆中傳回的專輯數量上限。傳回的專輯數量可能少於指定數量。預設 pageSize 為 20，上限為 50。

pageToken

string

用來取得結果下一頁的接續符記。將這項值加入要求後，系統會傳回 pageToken 之後的資料列。pageToken 應為 listAlbums 要求回應中 nextPageToken 參數傳回的值。

excludeNonAppCreatedData

boolean

如果設為 true，結果就會排除非由此應用程式建立的媒體項目。預設值為 false (會傳回所有專輯)。如果使用 photoslibrary.readonly.appcreateddata 範圍，系統會忽略這個欄位。

要求主體必須為空白。

要求的相簿清單。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法
{ "albums": [ { object (`Album`) } ], "nextPageToken": string }

欄位

欄位
`albums[]`	`object (Album)` 僅供輸出。使用者 Google 相簿應用程式「相簿」分頁中顯示的相簿清單。
`nextPageToken`	`string` 僅供輸出。用於取得下一組相簿的符記。如果此要求需要擷取更多專輯，就會填入這個值。

albums[]

object (Album)

僅供輸出。使用者 Google 相簿應用程式「相簿」分頁中顯示的相簿清單。

nextPageToken

string

僅供輸出。用於取得下一組相簿的符記。如果此要求需要擷取更多專輯，就會填入這個值。

需要下列其中一種 OAuth 範圍：

Method: albums.list 透過集合功能整理內容 你可以依據偏好儲存及分類內容。