このリリースノートを
購読してください。
このページは、Google Photos API が新しくリリースされるたびに更新されます。変更履歴には日付順にリリースが一覧表示され、新機能、バグの修正、その他の変更が記載されています。
ドキュメントとガイドは、使用できる最新バージョンを参照しています。
2025 年 4 月 1 日
メモ
このリリースでは、以前お知らせした Photos API の変更が実装されています。
- Library API から一部のスコープの削除。
- 複数のメソッドをアプリ作成コンテンツでのみ動作するように制限。
- 新しい Google Photos API ユーザーデータ / デベロッパー ポリシーが、以前の利用規約に代わって適用されます。
詳しくは、Google Photos API の更新をご覧ください。
2024 年 9 月 16 日
機能
- 安全でユーザー フレンドリーな写真選択のための新しい Picker API を導入しました。
メモ
このリリースでは、Library API の重要な変更(2025 年 3 月 31 日発効)を発表しました。
- Library API は、アプリによって作成された写真と動画のみを管理します。
photoslibrary.readonly
、photoslibrary.sharing
、photoslibrary
スコープの削除。- 複数の方法をアプリ作成コンテンツのみに制限。
詳細については、Google Photos API の更新のページをご覧ください。
2022 年 10 月 27 日
メモ
- 「Google フォトと Flutter を使用した写真共有アプリの作成」のコードラボは利用できなくなりました。他のサンプルを確認し、ガイド内のサンプルコードを参照してください。
2022 年 6 月 1 日
メモ
- アップロードのベスト プラクティスを追加しました。アップロード プロセスを明確にし、よくあるエラーとその回避方法を説明します。また、アップロードの効率を高めるためのヒントも提供します。
2021 年 10 月 27 日
機能
- Google フォト パートナー プログラム: プレミアム ティアのリリース。プレミアム ティアは、Google フォトの強力な機械学習を活用する一連の高度な API 機能です。
2021 年 9 月 29 日
機能
- 日付フィルタベースの検索結果を並べ替えるための新しいオプション。検索結果は新しい順または古い順に並べ替えることができます。これにより、検索が容易になり、より的確な検索結果が提供されるため、効率性が向上します。
2021 年 7 月 21 日
機能
- 再生ボタンのオーバーレイなしでサムネイルを読み込むための、動画ベース URL の新しい
-no
パラメータ。デフォルトでは、動画のサムネイルは再生ボタンのオーバーレイとともに読み込まれます。この新しいパラメータを使用すると、動画のサムネイルの再生ボタンを非表示にできます。
[解決済み] の問題
- 問題 181282432: 動画のサムネイルに再生ボタンのオーバーレイが常に表示される。
2021 年 5 月 25 日
[解決済み] の問題
- メディア アイテムの
photo
メタデータにexposureTime
プロパティが設定されていない。
2021 年 5 月 19 日
メモ
- モーション フォトのベース URL のドキュメントが更新され、Android モーション フォトと iOS Live Photos の
=dv
パラメータの動作が明確になりました。
2021 年 2 月 11 日
メモ
- 利用規定を更新し、広告に関するコンテンツとデータ使用の最小化を追加しました。
2020 年 7 月 7 日
機能
- Google フォトの新しい共有管理機能をサポートするように API が更新されました。共有アルバムの
shareInfo
プロパティの一部として、新しいフィールドisJoinable
が返されるようになりました。isJoinable
がtrue
の場合、API はユーザーを共有アルバムに追加できます。所有者が Google フォトのアルバムでリンク共有を無効にしている場合、isJoinable
はfalse
になり、API はそのアルバムにユーザーを追加できなくなります。 - 問題 111405623、116379853、117685011: アプリが作成したメディア アイテムのアルバムのタイトルとカバー写真の変更、説明の変更ができるようになりました。更新アクセス用の新しい
photoslibrary.edit.appcreateddata
認可スコープをリクエストします。
2020 年 2 月 17 日
機能
- 写真の最大アップロード ファイルサイズが 75 MB から 200 MB に引き上げられました。
- ファイルをアップロードする際は、バイトアップロード ステージで MIME タイプを指定する必要があります。
- メディア バイトのアップロードではなく、メディア アイテムを作成するときにファイル名を指定します。
simpleMediaItem
の新しいfileName
プロパティは UTF-8 文字列をサポートしています。メディア バイトをアップロードするときにメディア アイテムのファイル名を指定することはできますが、実装を更新することを強くおすすめします。
メモ
- 利用規定が更新され、データの使用と保存の最小化に重点を置いた詳細が追加されました。
- ベース URL のドキュメントが更新され、モーション写真が追加されました。
2019 年 8 月 16 日
機能
- 問題 131874809:
shareInfo
に新しいプロパティisOwned
を追加し、ユーザーが共有アルバムのオーナーかどうかを識別できるようにしました。詳しくは、デベロッパー ガイドのメディアの共有をご覧ください。
[解決済み] の問題
- 問題 131711405:
albums.list
レスポンスにshareableUrl
プロパティがありませんでした。 - 問題 113870729:
mediaItems.list
がページの境界で重複したメディア アイテムを返す場合がある問題を解決しました。 - 問題 93428763: 動画のメタデータの
status
フィールドが、利用可能な最高品質の動画のVideoProcessingStatus
を正しく返すようになりました。
2019 年 6 月 12 日
機能
- 問題 110188560: お気に入りとしてマークされているメディア アイテムを選択する新しい検索フィルタ
FeatureFilter
が追加されました。 ContentFilter
の新しいコンテンツ カテゴリ。特定のカテゴリ(ARTS
、CRAFTS
、FASHION
、HOUSES
、GARDENS
、FLOWERS
、HOLIDAYS
)に一致するメディア アイテムをフィルタします。
メモ
- UX ガイドラインを更新し、プロジェクトとアルバムの命名に関する説明を追加しました。
2019 年 5 月 7 日
Codelab
- 新しい Codelab: Google フォトと Flutter を使用した写真共有アプリの作成。Flutter で Google Photos Library API を使用して写真共有アプリを作成する方法を学習できます。詳しくは、サンプルガイドをご覧ください。
2019 年 4 月 29 日
機能
問題 109505022: 既存のメディア アイテムをアルバムに追加、アルバムから削除する新しい呼び出しが追加されました。
これらの呼び出しは、アプリケーションが作成したメディア アイテムとアルバムをサポートしています。詳しくは、デベロッパー ガイドのアルバムの管理をご覧ください。
メディア アイテムを作成するための REST 呼び出し
mediaItems.batchCreate
は、一部のメディア アイテムを作成できなかった場合に、部分的な成功を示す HTTP ステータス207 MULTI-STATUS
を返すようになりました。詳しくは、デベロッパー ガイドのメディアのアップロードをご覧ください。
メモ
- 最新バージョンのクライアント ライブラリには重大な変更が含まれます。
MediaItem
、Album
、DateRange
に関連するクラスは、新しい専用パッケージに移動されました。機能の変更はなく、クライアント ライブラリ内の場所のみが変更されました。Java クライアント ライブラリ(1.2.0)と PHP クライアント ライブラリ(1.2.0)のリリースノートをご覧ください。
2019 年 2 月 14 日
メモ
- ベース URL からメディアのバイトにアクセスするための新しい割り当て制限が追加されました。Google API Console でこの割り当てをモニタリングできます。
[解決済み] の問題
- 問題 124355983: 一部の共有メディア アイテムに対して
mediaItems.get
を呼び出すと 500 エラーが発生する問題を解決しました。
2019 年 1 月 21 日
[解決済み] の問題
- 問題 121998358:
albums.create
レスポンスにisWriteable
プロパティが含まれていない。
2019 年 1 月 7 日
[解決済み] の問題
- 問題 118464845:
mediaItems.list
が空のページを多数返す問題を解決しました。 - 問題 111714379:
mediaItems.search
がpageSize
の半分の値を返す問題を解決しました。
2018 年 11 月 30 日
機能
- ID を指定して複数のメディア アイテムを取得する新しい呼び出し
mediaItems.batchGet
が追加されました。 - 問題 111279349: 参加しているアルバムから退出する新しい呼び出し
sharedAlbums.leave
が追加されました。 - 問題 111279347: 共有アルバムをプライベートとしてマークする新しい呼び出し
albums.unshare
が追加されました。
[解決済み] の問題
- 問題 113978705:
mediaItems.batchCreate
で設定された説明が HTML エンティティに変換される問題を解決しました。 - 問題 114462217:
mediaItems.batchCreate
の動画ファイルにファイル名を設定できない問題を解決しました。 - 問題 118475587: メディア アイテムに対して無効なサービスの URL が返される問題を解決しました。
- 問題 111862704: ベース URL にアクセスすると 403 エラーが発生する問題を解決しました。
- 問題 115932469: 割り当てエラーでアップロードが失敗する問題を解決しました。
2018 年 9 月 6 日
機能
- Java と PHP のクライアント ライブラリが利用できるようになりました。
メモ
- Google Photos Library API の一般提供が開始されました。Library API デベロッパー プレビュー期間中のフィードバックと機能のリクエストに感謝いたします。
- Java および PHP のクライアント ライブラリの使用を開始するための新しいガイドをご覧ください。
- クライアント ライブラリの使用方法を示すために、Java および PHP のコード スニペットのサンプルがガイドに追加されました。
2018 年 9 月 5 日
機能
shareToken
を使用してアルバムを取得する新しい呼び出しsharedAlbums.get
。shareInfo
に新しいプロパティisJoined
を追加し、ユーザーが共有アルバムに参加しているかどうかを識別できるようにしました。
[解決済み] の問題
- 問題 79321120: 動画メディア アイテムの mediaItems.batchCreate レスポンスに
mimeType
プロパティが含まれていない問題を解決しました。 - 問題 79319272: mediaItems.batchCreate のレスポンスに
mediaMetadata
、contributorInfo
などのプロパティが含まれない問題を解決しました。 - 問題 110237685: CORS 関連のファイル アップロードの問題を解決しました。
- 問題 79318118: mediaItems.batchCreate 呼び出しでアルバムに複数のアイテムをアップロードする際に、順序の一貫性が保持されない問題を解決しました。
メモ
- 2018 年 9 月 5 日より前に ID(アルバム、メディア アイテム、エンリッチメント アイテムの ID など)を保存していた場合、形式が変更されたため機能しなくなります。アプリケーションで使用する新しい ID を取得する必要があります。
- アルバム リソースの
totalMediaItems
プロパティの名前がmediaItemsCount
に変更されました。 - mediaItems.list 呼び出しと mediaItems.search 呼び出しの
pageSize
パラメータの最大値が 100 に変更されました。pageSize
パラメータが指定されていない場合に返されるメディア アイテムのデフォルト数が 25 に変更されました。 - 2018 年 7 月 31 日にリリースされた
excludeNonAppCreatedData
](/photos/library/guides/apply-filters#nonapp-created)フィルタ機能を使用して、ライブラリ コンテンツを一覧表示する、メディアを共有する、メディア アイテムにアクセスするのガイドを更新しました。
2018 年 7 月 31 日
機能
- メディア アイテムを取得する新しい呼び出し
mediaItems.list
が追加されました。 - アプリが作成したアイテムを検索したりアルバムを取得したりする新しいフィルタ
excludeNonAppCreatedData
が追加されました。 - 画像にアクセスする新しいパラメータが追加されました。
- 問題 79871479: 切り抜き用の
c
パラメータ。画像を正確なサイズに切り抜きます。 - 問題 110343547、問題 111228390:
d
ダウンロード パラメータ。元の画像をダウンロードします。
- 問題 79871479: 切り抜き用の
sharedAlbums.join
呼び出しが アルバムを返すようになりました。- 問題 109655786:
album
に、カバー写真のメディア アイテム IDcoverPhotoMediaItemId
が含まれるようになりました。 - 問題 79656863:
mediaItem
にメディア アイテムのファイル名filename
が含まれるようになりました。
[解決済み] の問題
- 問題 79757390: アップロード リクエスト中にファイル名が設定されない問題を解決しました。メディアのアップロード ガイドの
X-Goog-Upload-File-Namefile
フィールドとX-Goog-Upload-Protocol
フィールドをご覧ください。 - 問題 80182372: 再開可能なアップロードでエラーが返される問題を解決しました。更新されたプロトコルについては、ガイドの新しい再開可能アップロードをご覧ください。
- 問題 79497397: albums.list レスポンスに
isWriteable
プロパティがない問題を解決しました。 - 問題 111143493:
PEOPLE
コンテンツ カテゴリ フィルタが不正確な結果を返す問題を解決しました。 - 問題 111056278:
BIRTHDAYS
コンテンツ カテゴリ フィルタがエラーを返す問題を解決しました。
プレビュー リリース - 2018 年 5 月 8 日
Library API の初期リリース。
既知の問題
GET mediaItem
は、受け取ったメディア アイテムid
が共有アルバムのメディア アイテムのもので、ユーザーがオーナーでない場合、エラーをスローします。batchCreate
呼び出しのレスポンスがmediaMetadata
またはcontributorInfo
を返さない。- メディア アイテムが動画の場合、
batchCreate
呼び出しはmimeType
を返しません。 - 複数のアイテムをアップロードする際に、
batchCreate
で順序の一過性が維持されない。 batchCreate
で、共有アルバムのオーナーとして共有アルバムにメディア アイテムを作成する際の順序指定(position
への追加)がサポートされていない。デフォルトではアルバムの最後に追加される。