지정된 세션 중에 사용자가 선택한 미디어 항목의 목록을 반환합니다.
세션에 아직 선택한 미디어 항목이 없어 미디어 콘텐츠를 반환할 수 없는 경우 FAILED_PRECONDITION
오류가 반환됩니다. 이 시나리오에서는 입력이 제한된 기기에서 실행되는 애플리케이션은 세션의 pickerUri
을 인코딩하는 QR 코드를 렌더링하여 사용자에게 코드를 스캔하고 Google 포토 선택 도구 UI에서 미디어 항목을 선택하라는 메시지를 표시해야 합니다. 사용자가 항목을 선택하기를 기다리는 동안 클라이언트는 sessions.get
응답의 pickedItemsSet = true
까지 pollingConfig.pollInterval
마다 한 번씩 sessions.get
를 폴링해야 합니다. 이 시점에서 클라이언트는 mediaItems.list
호출을 재개하고 성공적인 응답을 받을 수 있습니다.
HTTP 요청
GET https://photospicker.googleapis.com/v1/mediaItems
URL은 gRPC 트랜스코딩 구문을 사용합니다.
쿼리 매개변수
매개변수 | |
---|---|
sessionId |
필수 항목입니다. 이 세션의 Google 생성 식별자입니다. |
pageSize |
선택사항입니다. 반환할 미디어 항목의 최대 개수입니다. 서비스는 이 값보다 적은 수의 결과를 반환할 수 있습니다 (결과가 0개인 경우 포함). 지정하지 않거나 0으로 설정하면 최대 50개의 미디어 항목이 반환됩니다. 최댓값은 100이며, 100을 초과하는 값은 100으로 변환됩니다. 값이 음수이면 |
pageToken |
선택사항입니다. 이전 |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
mediaItems.list
RPC에 대한 응답입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"mediaItems": [
{
object ( |
필드 | |
---|---|
mediaItems[] |
선택한 미디어 항목의 페이지입니다. |
nextPageToken |
토큰: |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/photospicker.mediaitems.readonly