Method: mediaItems.list

列出使用者 Google 相簿相片庫中的所有媒體項目。

HTTP 要求

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

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

查詢參數

參數
pageSize

integer

要在回應中傳回的媒體項目數量上限。可能傳回的媒體項目數量可能少於指定數量。預設值為 25,最大值為 100。pageSize

pageToken

string

用於取得結果下一頁的接續權杖。將這項值加入要求後,系統會傳回 pageToken 之後的資料列。pageToken 應為回應 listMediaItems 要求在 nextPageToken 參數中傳回的值。

要求主體

要求主體必須為空白。

回應主體

使用者 Google 相簿相片庫中所有媒體項目的清單。

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

JSON 表示法
{
  "mediaItems": [
    {
      object (MediaItem)
    }
  ],
  "nextPageToken": string
}
欄位
mediaItems[]

object (MediaItem)

僅供輸出。使用者媒體庫中的媒體項目清單。

nextPageToken

string

僅供輸出。取得下一組媒體項目時使用的權杖。如果要瞭解下一個要求中可用的媒體項目較多,那麼情形是唯一可靠的指標。

授權範圍

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

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.readonly
  • https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata