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에 매개변수를 추가해야 합니다. 지원되는 매개변수의 전체 목록을 보려면 개발자 문서를 참고하세요. 예를 들어 '=w2048-h1024'는 사진 유형의 미디어 항목 크기를 너비 2048픽셀, 높이 1024픽셀로 설정합니다.

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 포토에 업로드된 시점이 아니라 처음 생성된 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

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 포토 라이브러리에서 미디어 항목을 검색합니다.