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'는 사진 유형 미디어 항목의 크기를 너비 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 포토에 업로드된 시간이 아님).

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 동영상 처리가 완료되었으며 이제 볼 수 있습니다. 중요: READY 상태가 아닌 동영상을 다운로드하려고 하면 실패할 수 있습니다.
FAILED 문제가 발생하여 동영상을 처리하지 못했습니다.

ContributorInfo

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

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

string

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

displayName

string

도움을 주신 분의 표시 이름입니다.

메서드

batchCreate

batchGet

get

list

patch

미디어 항목을 지정된 id로 업데이트합니다.