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

batchGet

get

list

patch

指定された id でメディア アイテムを更新します。