Method: mediaItems.list

傳回使用者在指定工作階段中挑選的媒體項目清單。

如果使用者尚未為指定工作階段挑選媒體項目，系統會傳回 FAILED_PRECONDITION 錯誤。在這種情況下，應用程式應輪詢 sessions.get，直到工作階段就緒後再重試此方法。

HTTP 要求

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

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

查詢參數

參數
sessionId

string

必要欄位。Google 為這個工作階段產生的 ID。
pageSize

integer

選用設定。要傳回的媒體項目數量上限。

服務傳回的產品數量可能會少於這個值 (包括零個結果)。如未指定或設為 0，最多會傳回 50 個媒體項目。許可的最大值為 100；超出的數值將一律指定為 100。負值會導致 INVALID_ARGUMENT 錯誤。
pageToken

string

選用設定。從先前 mediaItems.list 呼叫收到的網頁權杖。提供此項目即可擷取後續網頁。

要求主體

要求主體必須為空白。

回應主體

對 mediaItems.list 方法的回應。

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

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

object (PickedMediaItem)

所選取的媒體項目頁面。
nextPageToken

string

如果已設定，這個欄位可用於後續 mediaItems.list 呼叫中的 pageToken，用於擷取所選取媒體項目的下一頁。

如果省略這個欄位，就不會有後續頁面。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/photospicker.mediaitems.readonly