Google Photos API の更新

投稿日: 2024 年 9 月

このページでは、Google フォト API に実施される具体的な変更について説明します。このページの詳細を確認して、使用しているメソッドとスコープにどのような影響があるかご確認ください。これらの変更に関するお知らせについて詳しくは、関連するブログ投稿をご覧ください。

Library API: 一般的なユースケースへの影響

以降のセクションでは、今後の変更が一般的なユースケースにどのように影響するかについて詳しく説明します。

メディア アイテムのアップロードとアルバムの作成

変更内容: なし。photoslibrary.appendonly スコープを使用して、メディア アイテムのアップロードとアルバムの作成を継続できます。

ご対応のお願い:

アプリでメディア アイテムをアップロードまたはアルバムを作成している場合は、photoslibrary スコープではなく photoslibrary.appendonly スコープを使用していることを確認してください。photoslibrary スコープは削除されます。

メディア アイテムとアルバムのリストの取得、検索、取得

変更内容: アプリで作成されたアルバムとメディア アイテムのみを一覧表示、検索、取得できるようになりました。

ご対応のお願い:

• アプリでユーザーがライブラリ全体から写真やアルバムを選択する必要がある場合は、新しい Google Photos Picker API を使用してください。これにより、ユーザーは特定のコンテンツへのアクセス権を安全かつユーザー フレンドリーな方法で付与できます。
• アプリがユーザーのライブラリ全体にアクセスしている場合は、アプリを再評価するか、別のアプローチを検討する必要があります。

共有と共有アルバム

変更内容: 共有アルバムと関連する API 関数（共有、共有解除、取得、参加、退出、リスト）は、2025 年 3 月 31 日以降、403 PERMISSION_DENIED を返します。

ご対応のお願い:

共有を自分で管理できるよう、Google フォト アプリをご案内します。アプリ内で明確な手順やディープリンクを用意して、ユーザーを誘導できます。

アプリが作成したアルバムの管理: エンリッチメントとアルバム コンテンツ

変更内容: コンセプトの一貫性を保つため、次の 3 つのメソッドに photoslibrary.edit.appcreateddata が追加されます。

• albums.addEnrichment
• albums.batchAddMediaItems
• albums.batchRemoveMediaItems

ご対応のお願い:

• アプリですでにこれらのメソッドを使用している場合は、photoslibrary.edit.appcreateddata スコープを採用して認可プロセスを簡素化することを検討してください。

Library API: 影響を受けるスコープとメソッド

Google Photos API の変更の一環として、次の更新を行いました。

更新された認可ページに記載されているとおり、2025 年 3 月 31 日以降、Library API から次のスコープが削除されます。

• photoslibrary.readonly
• photoslibrary.sharing
• photoslibrary

次のスコープは引き続き使用できます。

• photoslibrary.appendonly
• photoslibrary.readonly.appcreateddata
• photoslibrary.edit.appcreateddata

次の表に、影響を受ける Library API のメソッドとスコープを示します。

更新	メソッド	スコープ
これらのメソッドは、アプリで作成されたアルバムとメディア アイテムでのみ使用できるようになりました。	albums.create mediaItems.batchCreate	残りのスコープ: photoslibrary.appendonly 削除されたスコープ: photoslibrary photoslibrary.sharing
	albums.get albums.list mediaItems.batchGet mediaItems.get mediaItems.list mediaItems.search	残りのスコープ: photoslibrary.readonly.appcreateddata 削除されたスコープ: photoslibrary photoslibrary.readonly
これらの方法は利用できなくなります。	albums.share albums.unshare sharedAlbums.get sharedAlbums.join sharedAlbums.leave sharedAlbums.list	残りのスコープ: なし 削除されたスコープ: photoslibrary.sharing
これらのメソッドには photoslibrary.edit.appcreateddata が追加されます。 これらのメソッドは、アプリで作成されたアルバムとメディア アイテムでのみ使用できるようになりました。	albums.addEnrichment albums.batchAddMediaItems	残りのスコープ: photoslibrary.appendonly photoslibrary.edit.appcreateddata 削除されたスコープ: photoslibrary
	albums.batchRemoveMediaItems	残りのスコープ: photoslibrary.edit.appcreateddata 削除されたスコープ: photoslibrary
これらの方法は変更されません。	albums.patch mediaItems.patch	残りのスコープ: photoslibrary.edit.appcreateddata 削除されたスコープ: なし

Photos API ポリシーの更新

現在の利用規定ポリシーは、2025 年 3 月 31 日をもって、新しい Google Photos API ユーザーデータ / デベロッパー ポリシーに置き換えられます。新しいポリシーは現在プレビュー版でご利用いただけます。

Photos API ドキュメントの更新

今後のアップデートを反映し、開発エクスペリエンスをサポートするために、Photos API のドキュメントに大幅な変更を加えました。

• 統合された Photos API サイト: すべての Photos API リソースを 1 か所（このサイト）に統合し、デベロッパーの利便性を高めました。以下が表示されます。
  • 一元化されたリソース: Picker API と Library API の両方に関する、設定手順と一般的な使用ガイダンス、サポートとポリシーに関する情報をまとめたリソース。
  • 専用の API サイト: Picker API と Library API の詳細なガイド、リファレンス ドキュメント、コードサンプルが掲載されている個別のサイト
• Library API のコンテンツを更新: Library API のドキュメントを改訂し、サポート終了後の Library API の機能を反映しました。
• 以前のドキュメントの保持: 既存の統合を移行する必要があるデベロッパー向けに、元の Library API ドキュメントを保持しています。新しいプロジェクトを開始する場合は、更新されたドキュメントを使用してください。既存のプロジェクトを更新する場合は、移行中に必要に応じて以前のドキュメントと更新されたドキュメントの両方を参照してください。

よくある質問

Google フォト API の変更点

安全な写真選択のための新しい Google Photos Picker API が導入され、既存の Library API が更新されて、アプリで作成された写真と動画の管理に重点が置かれます。

これらの料金改定はいつから適用されますか？

これらの変更は 2025 年 3 月 31 日に有効になります。写真選択に Library API を使用している既存の統合を使用している場合は、できるだけ早く Picker API に移行することをおすすめします。

Library API にはどのような影響がありますか？

photoslibrary.readonly、photoslibrary.sharing、photoslibrary スコープは削除されます。これらのスコープのみに依存する API 呼び出しは、2025 年 3 月 31 日以降、403 PERMISSION_DENIED を返します。他のいくつかの呼び出しは、アプリによって作成された写真と動画のみを操作できるようになります。

変更の全容については、このページの対象となるスコープとメソッドの表をご覧ください。

アプリで影響を受けるスコープまたはメソッドを現在使用している場合はどうすればよいですか？

アプリで影響を受けるスコープまたはメソッドを使用している場合は、次の手順をおすすめします。

• 写真選択の場合: Google Photos Picker API に移行します。
• その他の機能の場合: 更新された Library API のドキュメントを確認し、変更内容を把握し、アプリで利用できなくなる可能性のある機能を特定します。ユースケースによっては、アプリの機能を調整したり、代替のソリューションを検討したりする必要があります。

Google Photos Picker API とは何ですか？

Picker API は、ユーザーが Google フォト ライブラリから写真や動画を選択し、シームレスにアプリに送り返せる、新しい安全な方法です。

今回の変更に関する詳細はどこで確認できますか？

現在表示されているこのページでは、すべての変更の概要と要約を確認できます。

サイトのその他のドキュメントは、更新された API を反映して更新されています。

変更を発表したこちらのブログ投稿をご覧ください。

他に不明な点がある場合や、アプリの移行についてサポートが必要な場合はどうすればよいですか？

デベロッパー ドキュメントについてご不明な点がございましたら、サポートページでサポートの詳細をご確認ください。