Method: mediaItems.batchGet

지정된 미디어 항목 식별자에 대해 앱에서 만든 미디어 항목 목록을 반환합니다. 항목은 제공된 식별자와 동일한 순서로 반환됩니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 구문을 사용합니다.

쿼리 매개변수

매개변수
mediaItemIds[]

string

필수 항목입니다. 요청할 미디어 항목의 식별자입니다. 식별자를 반복해서 포함해서는 안 되며 비워 둘 수 없습니다. 한 번의 호출로 검색할 수 있는 최대 미디어 항목 수는 50개입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

앱에서 만든 미디어 항목 목록을 가져오는 응답입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "mediaItemResults": [
    {
      object (MediaItemResult)
    }
  ]
}
필드
mediaItemResults[]

object (MediaItemResult)

출력 전용입니다. 가져온 미디어 항목 목록입니다. mediaItems.batchGet 호출이 성공하더라도 일괄 처리의 일부 미디어 항목에 실패가 발생했을 수 있습니다. 이러한 실패는 각 MediaItemResult.status에 표시됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata

MediaItemResult

미디어 항목 검색 결과입니다.

JSON 표현 
{
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
필드
status

object (Status)

이 미디어 항목에 액세스하는 중에 오류가 발생하면 이 필드에 오류와 관련된 정보가 채워집니다. 이 필드에 관한 자세한 내용은 Status를 참고하세요.
mediaItem

object (MediaItem)

사용자의 라이브러리에서 가져온 미디어 항목입니다. 오류가 발생하지 않고 미디어 항목이 가져온 경우 채워집니다.