Method: mediaItems.list

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

HTTP 要求

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

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

查詢參數

參數
pageSize

integer

回應中傳回的媒體項目數量上限。傳回的媒體項目數量可能少於指定數量。預設 pageSize 為 25，上限為 100。
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