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

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

string

メディア アイテムの説明です。この情報は、Google フォト アプリのアイテムの情報セクションに表示されます。1,000 文字未満にする必要があります。ユーザーが書いたテキストのみを含めます。説明文は、文脈を追加し、ユーザーがメディアを理解できるようにする必要があります。自動生成された文字列（ファイル名、タグ、その他のメタデータなど）は含めないでください。
productUrl

string

メディア アイテムの Google フォトの URL。このリンクは、ユーザーがログインしている場合のみ使用できます。アルバム検索から取得された URL は、アルバム内のアイテムを参照します。
baseUrl

string

メディア アイテムのバイトを表す URL。これはそのまま使用しないでください。使用する前に、この URL にパラメータを追加する必要があります。サポートされている全パラメータの一覧については、デベロッパー向けドキュメントをご覧ください。たとえば、'=w2048-h1024' は、写真タイプのメディア アイテムのサイズを、幅 2,048 ピクセル、高さ 1,024 ピクセルに設定します。
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)

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

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

 ユーザーの Google フォト ライブラリに 1 つまたは複数のメディア アイテムを作成します。

batchGet

 指定したメディア アイテム ID に対応するメディア アイテムのリストを返します。

get

 指定したメディア アイテム ID のメディア アイテムを返します。

list

 ユーザーの Google フォト ライブラリにあるすべてのメディア アイテムを一覧表示します。

patch

 指定した id を使用してメディア アイテムを更新します。
ユーザーの Google フォト ライブラリ内のメディア アイテムを検索します。