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
  • https://www.googleapis.com/auth/photoslibrary.readonly.originals