リソース: MediaItem
Google フォトのメディア アイテム(写真や動画など)を表します。
JSON 表現 |
---|
{ "id": string, "description": string, "productUrl": string, "baseUrl": string, "mimeType": string, "mediaMetadata": { object ( |
フィールド | |
---|---|
id |
メディア アイテムの識別子です。セッション間でこのメディア アイテムを識別するために使用できる永続的な識別子です。 |
description |
メディア アイテムの説明です。これは、Google フォト アプリのアイテムの情報セクションに表示されます。1,000 文字未満で指定してください。ユーザーが作成したテキストのみを含める。説明文は、ユーザーがメディアの内容を理解できるよう、コンテキストを加えたものにする必要があります。ファイル名、タグ、その他のメタデータなどの自動生成された文字列は含めないでください。 |
productUrl |
メディア アイテムの Google フォトの URL。このリンクは、ログインしている場合にのみ利用できます。アルバム検索で取得された URL は、アルバム内のアイテムを指します。 |
baseUrl |
メディア アイテムのバイトへの URL です。これをそのまま使用しないでください。使用する前に、この URL にパラメータを追加する必要があります。サポートされているパラメータの一覧については、デベロッパー向けドキュメントをご覧ください。たとえば、 |
mimeType |
メディア アイテムの MIME タイプ。例: |
mediaMetadata |
メディア アイテムに関連するメタデータ(高さ、幅、作成時間など)。 |
contributorInfo |
このメディア アイテムを追加したユーザーに関する情報。これは、共有アルバムの ID で |
filename |
メディア アイテムのファイル名。これは、Google フォト アプリのアイテムの情報セクションに表示されます。 |
MediaMetadata
メディア アイテムのメタデータ。
JSON 表現 |
---|
{ "creationTime": string, "width": string, "height": string, // Union field |
フィールド | |
---|---|
creationTime |
メディア アイテムが最初に作成された時刻(Google フォトにアップロードされた時刻ではありません)。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
width |
メディア アイテムの元の幅(ピクセル単位)。 |
height |
メディア アイテムの元の高さ(ピクセル単位)。 |
共用体フィールド metadata 。基になるメディアタイプに固有のメディア アイテムのメタデータ。metadata は次のいずれかになります。 |
|
photo |
写真のメディアタイプのメタデータ。 |
video |
動画のメディアタイプのメタデータ。 |
写真
写真に固有のメタデータ(ISO、レンズ焦点距離、露出時間など)。これらのフィールドの一部は、null または含まれていない可能性があります。
JSON 表現 |
---|
{ "cameraMake": string, "cameraModel": string, "focalLength": number, "apertureFNumber": number, "isoEquivalent": integer, "exposureTime": string } |
フィールド | |
---|---|
cameraMake |
写真を撮影したカメラのブランド。 |
cameraModel |
写真を撮影したカメラのモデル。 |
focalLength |
写真を撮影したカメラのレンズの焦点距離。 |
apertureFNumber |
写真を撮影したカメラレンズの絞りの f 値。 |
isoEquivalent |
写真を撮影したカメラの ISO。 |
exposureTime |
写真が撮影されたときのカメラの絞りの露出時間。 「 |
動画
動画に固有のメタデータ(FPS や処理ステータスなど)。これらのフィールドの一部は、null または含まれていない可能性があります。
JSON 表現 |
---|
{
"cameraMake": string,
"cameraModel": string,
"fps": number,
"status": enum ( |
フィールド | |
---|---|
cameraMake |
動画を撮影したカメラのブランド。 |
cameraModel |
動画を撮影したカメラのモデル。 |
fps |
動画のフレームレート。 |
status |
動画の処理ステータス。 |
VideoProcessingStatus
Google フォトにアップロードされている動画の処理ステータス。
列挙型 | |
---|---|
UNSPECIFIED |
動画の処理ステータスが不明です。 |
PROCESSING |
動画を処理しています。Google フォト アプリにこの動画のアイコンが表示されますが、まだ再生できません。 |
READY |
動画の処理が完了し、表示できるようになりました。重要: READY 状態でない動画をダウンロードしようとすると、失敗することがあります。 |
FAILED |
エラーが発生したため、動画を処理できませんでした。 |
ContributorInfo
メディア アイテムを追加したユーザーに関する情報。この情報が表示されるのは、アプリで作成した共有アルバム内にメディア アイテムが含まれ、共有スコープがある場合のみです。
JSON 表現 |
---|
{ "profilePictureBaseUrl": string, "displayName": string } |
フィールド | |
---|---|
profilePictureBaseUrl |
投稿者のプロフィール写真の URL。 |
displayName |
寄与者の表示名。 |
Methods |
|
---|---|
|
ユーザーの Google フォト ライブラリに 1 つ以上のメディア アイテムを作成します。 |
|
指定したメディア アイテム ID に対応するメディア アイテムのリストを返します。 |
|
指定されたメディア アイテム ID に対応するメディア アイテムを返します。 |
|
ユーザーの Google フォト ライブラリにあるすべてのメディア アイテムを一覧表示します。 |
|
指定された id でメディア アイテムを更新します。 |
|
ユーザーの Google フォト ライブラリ内のメディア アイテムを検索します。 |