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)

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

동영상 처리 상태

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

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

참여자 정보

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

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

string

도움을 주신 분들의 프로필 사진 URL입니다.

displayName

string

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

방법

batchCreate

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

batchGet

지정된 미디어 항목 식별자의 미디어 항목 목록을 반환합니다.

get

지정된 미디어 항목 식별자의 미디어 항목을 반환합니다.

list

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

patch

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