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
  • https://www.googleapis.com/auth/photoslibrary.readonly
  • https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata
  • https://www.googleapis.com/auth/photoslibrary.readonly.originals

MediaItemResult

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

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

object (Status)

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

object (MediaItem)

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