列出使用者 Google 相簿相片庫中的所有媒體項目。
HTTP 要求
GET https://photoslibrary.googleapis.com/v1/mediaItems
這個網址使用 gRPC 轉碼語法。
查詢參數
參數 | |
---|---|
pageSize |
要在回應中傳回的媒體項目數量上限。可能傳回的媒體項目數量可能少於指定數量。預設值為 25,最大值為 100。 |
pageToken |
用於取得結果下一頁的接續權杖。將這項值加入要求後,系統會傳回 |
要求主體
要求主體必須為空白。
回應主體
使用者 Google 相簿相片庫中所有媒體項目的清單。
如果成功,回應主體會含有以下結構的資料:
JSON 表示法 |
---|
{
"mediaItems": [
{
object ( |
欄位 | |
---|---|
mediaItems[] |
僅供輸出。使用者媒體庫中的媒體項目清單。 |
nextPageToken |
僅供輸出。取得下一組媒體項目時使用的權杖。如果要瞭解下一個要求中可用的媒體項目較多,那麼情形是唯一可靠的指標。 |
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/photoslibrary
https://www.googleapis.com/auth/photoslibrary.readonly
https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata