REST Resource: mediaItems

리소스: PickedMediaItem

사용자가 선택한 사진 또는 동영상의 표현입니다.

JSON 표현 
{
  "id": string,
  "createTime": string,
  "type": enum (Type),
  "mediaFile": {
    object (MediaFile)
  }
}
필드
id

string

미디어 항목의 식별자입니다.

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

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"입니다.
type

enum (Type)

이 미디어 항목의 유형입니다.
mediaFile

object (MediaFile)

이 미디어 항목을 구성하는 미디어 파일입니다.

유형

미디어 항목의 유형입니다.

열거형
TYPE_UNSPECIFIED 유형이 지정되지 않았습니다.
PHOTO 미디어 항목이 사진을 나타냅니다.
VIDEO 미디어 항목이 동영상을 나타냅니다.

미디어 파일

미디어 파일의 표현입니다.

JSON 표현 
{
  "baseUrl": string,
  "mimeType": string,
  "filename": string,
  "mediaFileMetadata": {
    object (MediaFileMetadata)
  }
}
필드
baseUrl

string

미디어 파일의 바이트를 가져오는 URL입니다.

미디어 파일을 다운로드하려면 API 클라이언트가 개발자 문서에 지정된 매개변수를 이 URL에 추가해야 합니다.

예를 들어 '=w2048-h1024'은 사진 유형의 미디어 항목의 크기를 너비 2048px, 높이 1024px로 설정합니다.
mimeType

string

미디어 파일의 MIME 유형입니다. 예를 들면 image/jpeg입니다.
filename

string

미디어 파일의 파일 이름입니다.
mediaFileMetadata

object (MediaFileMetadata)

미디어 파일과 관련된 메타데이터(예: 높이, 너비)

MediaFileMetadata

미디어 파일에 관한 메타데이터입니다.

JSON 표현 
{
  "width": integer,
  "height": integer,
  "cameraMake": string,
  "cameraModel": string,

  // Union field metadata can be only one of the following:
  "photoMetadata": {
    object (PhotoMetadata)
  },
  "videoMetadata": {
    object (VideoMetadata)
  }
  // End of list of possible types for union field metadata.
}
필드
width

integer

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

integer

미디어 파일의 원래 높이 (픽셀)입니다.
cameraMake

string

미디어가 캡처된 카메라의 브랜드입니다.
cameraModel

string

미디어가 캡처된 카메라의 모델입니다.
통합 필드 metadata. 미디어 유형에 따른 미디어 파일의 메타데이터입니다. metadata은 다음 중 하나여야 합니다.
photoMetadata

object (PhotoMetadata)

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

object (VideoMetadata)

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

PhotoMetadata

ISO, 초점 거리, 노출 시간 등 사진에만 해당하는 메타데이터입니다.

이러한 필드 중 일부는 설정되지 않을 수 있습니다.

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

number

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

number

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

integer

사진을 촬영한 카메라의 ISO입니다.
exposureTime

string (Duration format)

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

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

VideoMetadata

동영상에만 해당하는 메타데이터입니다. 예를 들어 fps입니다.

JSON 표현 
{
  "fps": number,
  "processingStatus": enum (VideoProcessingStatus)
}
필드
fps

number

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

enum (VideoProcessingStatus)

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

VideoProcessingStatus

Google 포토에 저장된 동영상의 처리 상태입니다.

열거형
UNSPECIFIED 동영상 처리 상태가 지정되지 않았습니다.
PROCESSING

동영상을 처리하는 중입니다.

사용자에게는 Google 포토 앱에 이 동영상의 아이콘이 표시되지만 아직 재생할 수는 없습니다.
READY

동영상 처리가 완료되었으며 이제 동영상을 시청할 수 있습니다.

READY 상태가 아닌 동영상을 오프라인 저장하려고 하면 실패할 수 있습니다.
FAILED 문제가 발생하여 동영상이 처리되지 않았습니다.

메서드

list

 지정된 세션 중에 사용자가 선택한 미디어 항목 목록을 반환합니다.