API の上限と割り当て

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

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

この API の適切な使用方法について詳しくは、利用規定ポリシーをご覧ください。

一般的な割り当て制限

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

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

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

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

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

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

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

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

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

写真の保存と品質

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