API の上限と割り当て

Google フォト API に送信されたすべてのリクエストは割り当てにカウントされます。Google では、システムとユーザーを保護するためにこの制限を設けています。

API へのアクセスには、Google Developers プロジェクトの OAuth クライアント認証情報が必要です。このプロジェクトでは、アプリを構成するの説明にあるように、Photos API を有効にする必要があります。

この API の適切な使用方法について詳しくは、Google Photos API ユーザーデータ / デベロッパー ポリシーをご覧ください。

API の割り当て上限

各 API には、システムの信頼性と完全性を保護するための独自の割り当てがあります。429 エラーが表示された場合は、これらの割り当てのいずれかに達した可能性があります。これらのエラーのいずれかが表示された場合は、特定の期間に送信するリクエストの数を減らしてください。詳細については、失敗したリクエストの再試行指数バックオフをご覧ください。

Picker API の割り当て上限

Photos Picker API へのリクエストの割り当て制限は、1 プロジェクトにつき 1 分あたり 100,000 リクエストです。

メディアのバイトにアクセスする(ベース URL から写真または動画を読み込む)リクエストの割り当て上限は、1 プロジェクトにつき 1 分あたり 1,000,000 リクエストです。

Library API の割り当て上限

Library API へのリクエストの割り当て上限は、1 プロジェクトにつき 1 日あたり 10,000 リクエストです。これには、メディアのアップロード、メディアのリスト表示、フィルタの適用などのすべての API リクエストが含まれますが、ベース URL からのメディア バイトへのアクセスは含まれません。

メディアのバイトにアクセスする(ベース URL から写真または動画を読み込む)リクエストの割り当て制限は、1 プロジェクトにつき 1 日あたり 75,000 リクエストです。

割り当ての使用状況を確認する

利用可能な割り当てをどの程度使用しているかを確認したり、プロジェクトの使用制限を表示、変更したりするには、Google API Console の [割り当て] ページにアクセスして、[Photos Picker API] または [Photos Library API] を選択します。

割り当ての上限を超えた場合

Photos API へのリクエストの割り当ての上限を超えた場合、API はエラーコード 429 と、プロジェクトが割り当てを超えたことを示すメッセージを返します。詳細については、利用規約をご覧ください。

追加の割り当てをリクエストする

Google フォト パートナー プログラムは、割り当て制限を増加する必要がある大規模な一般ユーザー向けアプリケーションを対象としています。アプリケーションがこのカテゴリに属すると思われる場合は、パートナー プログラムにお問い合わせください。

写真の保存と品質

API で Google フォトにアップロードされたメディア アイテムはすべて、元の解像度(元の画質)で保存されます。ユーザーの保存容量にカウントされます。