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