REST Resource: mediaItems

리소스: MediaItem

Google 포토의 미디어 항목 (예: 사진 또는 동영상)에 관한 표현입니다.

JSON 표현 
{
  "id": string,
  "description": string,
  "productUrl": string,
  "baseUrl": string,
  "mimeType": string,
  "mediaMetadata": {
    object (MediaMetadata)
  },
  "contributorInfo": {
    object (ContributorInfo)
  },
  "filename": string
}
필드
id

string

미디어 항목의 식별자입니다. 이 식별자는 세션 간에 이 미디어 항목을 식별하는 데 사용할 수 있는 영구 식별자입니다.
description

string

미디어 항목의 설명입니다. Google 포토 앱의 항목 정보 섹션에 사용자에게 표시됩니다. 1,000자(영문 기준) 미만이어야 합니다. 사용자가 작성한 텍스트만 포함합니다. 설명은 맥락을 제공하고 사용자가 미디어를 이해하는 데 도움이 되어야 합니다. 파일 이름, 태그, 기타 메타데이터와 같은 자동 생성 문자열은 포함하지 마세요.
productUrl

string

미디어 항목의 Google 포토 URL입니다. 이 링크는 로그인한 사용자만 사용할 수 있습니다. 앨범 검색에서 가져온 경우 URL은 앨범 내의 항목을 가리킵니다.
baseUrl

string

미디어 항목의 바이트 URL입니다. 이 URL은 있는 그대로 사용해서는 안 됩니다. 매개변수를 사용하기 전에 이 URL에 추가해야 합니다. 지원되는 매개변수의 전체 목록은 개발자 문서를 참고하세요. 예를 들어 '=w2048-h1024'는 사진 유형의 미디어 항목의 크기를 너비 2048px, 높이 1024px로 설정합니다.
mimeType

string

미디어 항목의 MIME 유형입니다. 예를 들면 image/jpeg입니다.
mediaMetadata

object (MediaMetadata)

높이, 너비, 생성 시간과 같이 미디어 항목과 관련된 메타데이터입니다.
contributorInfo

object (ContributorInfo)

이 미디어 항목을 추가한 사용자에 대한 정보입니다. 공유 앨범의 ID와 함께 mediaItems.search를 사용할 때만 포함됩니다. 앱에서 앨범을 만들어야 하며 공유 범위가 있어야 합니다.
filename

string

미디어 항목의 파일 이름입니다. 이 정보는 Google 포토 앱의 항목 정보 섹션에 사용자에게 표시됩니다.

MediaMetadata

미디어 항목의 메타데이터입니다.

JSON 표현 
{
  "creationTime": string,
  "width": string,
  "height": string,

  // Union field metadata can be only one of the following:
  "photo": {
    object (Photo)
  },
  "video": {
    object (Video)
  }
  // End of list of possible types for union field metadata.
}
필드
creationTime

string (Timestamp format)

미디어 항목이 처음 생성된 시간입니다 (Google 포토에 업로드된 시간이 아님).

생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
width

string (int64 format)

미디어 항목의 원래 너비 (픽셀)입니다.
height

string (int64 format)

미디어 항목의 원래 높이 (픽셀)입니다.
통합 필드 metadata. 미디어 항목을 나타내는 기본 미디어 유형에 관한 미디어 항목의 메타데이터입니다. metadata은 다음 중 하나여야 합니다.
photo

object (Photo)

사진 미디어 유형의 메타데이터입니다.
video

object (Video)

동영상 미디어 유형의 메타데이터입니다.

사진

ISO, 초점 거리, 노출 시간과 같이 사진에만 해당하는 메타데이터입니다. 일부 필드는 null이거나 포함되지 않을 수 있습니다.

JSON 표현 
{
  "cameraMake": string,
  "cameraModel": string,
  "focalLength": number,
  "apertureFNumber": number,
  "isoEquivalent": integer,
  "exposureTime": string
}
필드
cameraMake

string

사진을 찍은 카메라의 브랜드입니다.
cameraModel

string

사진을 찍은 카메라의 모델입니다.
focalLength

number

사진이 촬영된 카메라 렌즈의 초점 거리입니다.
apertureFNumber

number

사진이 촬영된 카메라 렌즈의 조리개 f 번호입니다.
isoEquivalent

integer

사진을 찍은 카메라의 ISO입니다.
exposureTime

string (Duration format)

사진을 찍을 때 카메라 조리개의 노출 시간입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

동영상

동영상에만 해당하는 메타데이터(예: fps, 처리 상태) 일부 필드는 null이거나 포함되지 않을 수 있습니다.

JSON 표현 
{
  "cameraMake": string,
  "cameraModel": string,
  "fps": number,
  "status": enum (VideoProcessingStatus)
}
필드
cameraMake

string

동영상이 촬영된 카메라의 브랜드입니다.
cameraModel

string

동영상을 촬영한 카메라의 모델입니다.
fps

number

동영상의 프레임 속도입니다.
status

enum (VideoProcessingStatus)

동영상의 처리 상태입니다.

VideoProcessingStatus

Google 포토에 업로드 중인 동영상의 처리 상태입니다.

열거형
UNSPECIFIED 동영상 처리 상태를 알 수 없습니다.
PROCESSING 동영상을 처리하는 중입니다. 사용자에게 Google 포토 앱에 이 동영상의 아이콘이 표시되지만 아직 재생할 수는 없습니다.
READY 동영상 처리가 완료되어 이제 볼 수 있습니다. 중요: '준비됨' 상태가 아닌 동영상을 다운로드하려고 하면 실패할 수 있습니다.
FAILED 문제가 발생하여 동영상을 처리할 수 없습니다.

ContributorInfo

미디어 항목을 추가한 사용자에 대한 정보입니다. 이 정보는 미디어 항목이 앱에서 만든 공유 앨범에 있고 공유 범위가 있는 경우에만 포함됩니다.

JSON 표현 
{
  "profilePictureBaseUrl": string,
  "displayName": string
}
필드
profilePictureBaseUrl

string

참여자의 프로필 사진 URL입니다.
displayName

string

참여자의 표시 이름입니다.

메서드

batchCreate

 사용자의 Google 포토 라이브러리에 하나 이상의 미디어 항목을 만듭니다.

batchGet

 지정된 미디어 항목 식별자에 대해 앱에서 만든 미디어 항목 목록을 반환합니다.

get

 지정된 미디어 항목 식별자에 대해 앱에서 만든 미디어 항목을 반환합니다.

list

 사용자의 Google 포토 라이브러리에서 앱에서 만든 모든 미디어 항목을 나열합니다.

patch

 앱에서 만든 미디어 항목을 지정된 id로 업데이트합니다.
사용자의 Google 포토 라이브러리에서 앱에서 만든 미디어 항목을 검색합니다.