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。これは、セッション間でこのメディア アイテムを識別するために使用できる永続的な 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 フォトにアップロードされた時刻ではありません）。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
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 フォト ライブラリで、アプリによって作成されたメディア アイテムを検索します。