REST Resource: mediaItems

리소스: PickedMediaItem

사용자가 선택한 사진 또는 동영상을 나타냅니다.

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

string

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

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

string (Timestamp format)

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

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

enum (Type)

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

object (MediaFile)

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

유형

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

열거형
TYPE_UNSPECIFIED 유형은 기본적으로 지정되지 않습니다.
PHOTO 미디어 항목은 정지 이미지를 나타냅니다.
VIDEO 미디어 항목은 동영상을 나타냅니다.

미디어 파일

미디어 바이트의 개별 파일을 나타냅니다.

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

string

미디어 파일 바이트의 URL입니다.

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

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

string

미디어 파일의 MIME 유형입니다. 예를 들면 image/jpeg입니다.
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, 초점 거리, 노출 시간과 같이 사진과 관련된 메타데이터입니다. 이 필드 중 일부는 null이거나 포함되지 않을 수 있습니다.

JSON 표현 
{
  "focalLength": number,
  "apertureFNumber": number,
  "isoEquivalent": integer,
  "exposureTime": string,
  "printMetadata": {
    object (PrintMetadata)
  }
}
필드
focalLength

number

사진을 찍은 카메라 렌즈의 초점 거리입니다.
apertureFNumber

number

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

integer

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

string (Duration format)

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

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

object (PrintMetadata)

사진 인쇄와 관련된 메타데이터입니다.

PrintMetadata

인쇄 품질평가점수와 같이 사진의 인쇄 관련 속성을 설명하는 메타데이터입니다.

JSON 표현 
{
  "qualityScore": enum (Score)
}
필드
qualityScore

enum (Score)

사진의 인쇄 품질 점수에 따라 사진이 인쇄하기에 적합한지 판단합니다.

이 점수는 사용자에게 인쇄를 하지 않도록 안내하는 데 사용해서는 안 됩니다. 사진의 품질이 높으며 사용자가 인쇄하려는 경우 점수가 HIGH로 설정됩니다. NORMAL 점수는 사진의 품질이 높지 않을 수 있음을 나타냅니다. SCORE_UNSPECIFIED는 사용 가능한 점수가 없음을 나타냅니다.

점수

사진의 인쇄 적합성을 나타내는 점수입니다.

열거형
SCORE_UNSPECIFIED 점수는 기본적으로 지정되지 않습니다.
HIGH 최고 점수를 받은 사진입니다.
NORMAL 정상적인 점수의 사진입니다.

VideoMetadata

동영상과 관련된 메타데이터(예: fps)입니다.

JSON 표현 
{
  "fps": number
}
필드
fps

number

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

메서드

list

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