REST Resource: mediaItems

リソース: PickedMediaItem

ユーザーが選択した写真や動画を表します。

JSON 表現
{
  "id": string,
  "createTime": string,
  "type": enum (Type),
  "mediaFile": {
    object (MediaFile)
  }
}
フィールド
id

string

メディア アイテムの ID。

セッション間でこのメディア アイテムを識別するために使用できる永続的な識別子です。

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 メディア アイテムは動画を表します。

MediaFile

メディアバイトの個々のファイルを表します。

JSON 表現
{
  "baseUrl": string,
  "mimeType": string,
  "mediaFileMetadata": {
    object (MediaFileMetadata)
  }
}
フィールド
baseUrl

string

メディア ファイルのバイトを示す URL。

メディア ファイルをダウンロードするには、API クライアントが、 デベロッパー向けドキュメントで指定されているパラメータをこの URL に追加する必要があります。

たとえば、'=w2048-h1024' は、写真タイプのメディア アイテムのサイズを、幅 2,048 ピクセル、高さ 1,024 ピクセルに設定します。

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)

写真を撮影したときのカメラの絞りの露出時間。

s で終わる小数 9 桁までの秒単位の期間。例: "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

指定したセッション中にユーザーが選択したメディア アイテムのリストを返します。