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' は、写真タイプのメディア アイテムのサイズを、幅 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

寄与者の表示名。

Methods

batchCreate

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

batchGet

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

get

 指定されたメディア アイテム ID に対応するメディア アイテムを返します。

list

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

patch

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