投稿日: 2024 年 9 月
このページでは、Google フォト API に実施される具体的な変更について説明します。メソッドとスコープの仕組みを理解するには、このページの詳細をご覧ください 影響が生じる可能性があります。これらの新機能の発表について詳しくは、 関連するブログ投稿をご覧ください。
Library API: 一般的なユースケースへの影響
以下のセクションでは、今後の変更が一般的な用途に及ぼす影響について詳しく説明します。 対応できます
メディア アイテムのアップロードとアルバムの作成
変更内容: なし。引き続きメディア アイテムをアップロードし、
photoslibrary.appendonly スコープを使用してアルバムを作成する
対処方法:
アプリでメディア アイテムをアップロードまたはアルバムを作成している場合は、photoslibrary スコープではなく photoslibrary.appendonly スコープを使用していることを確認してください。「
photoslibrary 個のスコープを削除しています。
メディア アイテムとアルバムの一覧表示、検索、取得
変更内容: アプリで作成されたアルバムとメディア アイテムのみを一覧表示、検索、取得できるようになりました。
対処方法:
- ユーザーがアプリ内で写真やアルバム全体を選択する必要がある場合は、 新しい Google フォト選択ツール API。これにより ユーザー フレンドリーな方法で、ユーザーが特定のコンテンツへのアクセスを許可できます。
- アプリがユーザーのライブラリ全体にアクセスしている場合は、アプリを再評価するか、別のアプローチを検討する必要があります。
共有と共有アルバム
変更点: 共有アルバムと関連する API 関数（共有、
共有解除、取得、参加、退出、リストなど）を指定すると、403 PERMISSION_DENIED が返されます。
2025 年 3 月 31 日
対処方法:
ユーザー自身で共有を管理できるように Google フォト アプリをご案内してください。Google Chat では アプリ内で明確な手順やディープリンクを提供すること。
アプリによって作成されたアルバムの管理: エンリッチメントとアルバムの内容
変更点: photoslibrary.edit.appcreatedata が
概念的に一貫性を持たせるには、次の 3 つの方法があります。
albums.addEnrichmentalbums.batchAddMediaItemsalbums.batchRemoveMediaItems
対処方法:
- アプリですでにこれらのメソッドを使用している場合は、
photoslibrary.edit.appcreatedataスコープを採用して認可プロセスを簡素化することを検討してください。
Library API: 影響を受けるスコープとメソッド
Google Photos API の変更の一環として、以下の変更を行いました。 あります。
更新された承認の ページでは、 は、2025 年 3 月 31 日以降、Library API から削除されます。
photoslibrary.readonlyphotoslibrary.sharingphotoslibrary
次のスコープはそのまま残ります。
photoslibrary.appendonlyphotoslibrary.readonly.appcreateddataphotoslibrary.edit.appcreateddata
次の表に、影響を受ける Library API のメソッドとスコープを示します。
| 更新 | メソッド | スコープ |
|---|---|---|
| これらのメソッドは、アプリで作成されたアルバムとメディア アイテムでのみ使用できるようになりました。これには、Picker API で選択され、Library API でユーザーのライブラリに追加されたメディア アイテムが含まれます。 | 残りのスコープ:
|
|
残りのスコープ:
|
||
| これらの方法は利用できなくなります。 | 残りのスコープ:
|
|
これらのメソッドには photoslibrary.edit.appcreatedata が追加されます。これらのメソッドは、アプリで作成されたアルバムとメディア アイテムでのみ使用できるようになりました。これには、Picker API で選択され、Library API でユーザーのライブラリに追加されたメディア アイテムが含まれます。 |
残りのスコープ:
|
|
残りのスコープ:
|
||
| これらのメソッドに変更はありません。 | 残りのスコープ:
|
Photos API に関するポリシーの更新
現在の利用規定ポリシーは、2025 年 3 月 31 日をもって、新しい Photos API ユーザーデータ / デベロッパー ポリシーに置き換えられます。新しいポリシーは プレビューします。
Photos API ドキュメントの更新
この変更を反映するため、Photos API ドキュメントに大幅な変更を加えました。 今後のアップデートと開発エクスペリエンスのサポート:
- 統合された Photos API サイト: Photos API のすべてのリソースを統合しました
を 1 つの便利な場所（このサイト）に統合することで、
優れたエクスペリエンスが実現しますここには以下の項目が表示されます。
- リソースの一元化: 設定手順と一般的なリソースの組み合わせ 使用ガイダンスを確認し、 のサポートとポリシー情報を Picker API と Library API の両方を利用できます
- 専用 API サイト: 詳細なガイドがある個別のサイト Picker のリファレンス ドキュメント、コードサンプル API とライブラリ API
- 最新の Library API コンテンツ: Library API のドキュメント は、廃止期間後の機能を反映するよう改訂されています。 更新されたドキュメントでは、ラベルによって変更箇所がハイライト表示され、 変更または削除されたコンテンツ（対応する以前のコンテンツへのリンクを含む） 移行時に参照できるようにしておきます
- 従来のドキュメントの保持: 元の Library API を保持しています。 ドキュメントをご覧ください。 既存の統合を移行する必要があります。新しいプロジェクトを開始する場合は、次のコマンドを使用します。 更新されたドキュメントをご覧ください。条件 更新する場合は、従来のプロジェクト タイプと更新されたプロジェクト 必要に応じて移行を進めることができます。
よくある質問
Google Photos API にはどのような変更がありますか？
安全に写真を選択するための新しい Google Photos Picker API を導入します と既存の Library API を更新して、写真と動画の管理に注力できるようにしました。 自動的に作成します。
これらの料金改定はいつから適用されますか？
これらの変更は 2025 年 3 月 31 日に有効になります。Google は、 写真の選択に Library API を使用して移行する既存の統合 Picker API を使用してください。
Library API にはどのような影響がありますか？
photoslibrary.readonly、photoslibrary.sharing、photoslibrary
削除されます。これらのスコープのみに依存する API 呼び出しでは、
403 PERMISSION_DENIED。他のいくつかの呼び出しは、アプリによって作成された写真と動画のみを操作するように制限されます。
変更内容の一覧は、このページ上部の表でご確認いただけます。
影響を受けるスコープやメソッドを現在アプリが使用している場合は、どうすればよいですか？
影響を受けるスコープやメソッドをアプリで使用している場合は、 次のとおりです。
- 写真選択の場合: Google Photos Picker API に移行します。
- その他の機能については、更新された Library API ドキュメントをご確認ください。 アプリの変更内容を理解し、適切に機能しなくなる可能性がある なります。ユースケースによっては、アプリの機能を調整したり、代替のソリューションを検討したりする必要があります。
Google Photos Picker API とは何ですか？
Picker API は、デベロッパーがユーザーが写真を選択できるようにする新しい安全な方法です 写真やアルバムを共有し、シームレスに 説明します。Picker API には堅牢な写真選択機能が備わっており、 個々のアイテムの選択、アルバム内のすべてのアイテムの選択、 Google フォトライブラリの
今回の変更に関する詳細はどこで確認できますか？
現在見ているこのページの内容 概要を確認できます
サイトのその他のドキュメントは、更新された API を反映して更新されています。
変更を発表したこちらのブログ投稿をご覧ください。
アプリケーションの移行についてさらに質問がある場合やサポートが必要な場合はどうすればよいですか？
デベロッパー向けドキュメントについてご不明な点がある場合は、サポート のページをご覧ください。