月間投稿クォータ
月間投稿クォータは、1 つのプロファイルが暦月内に送信できる投稿リクエスト（POST /post）の数を制限します。
- 各プロファイルには個別のクォータとカウントがあります。Primary Profile と各 User Profile は別々にカウントされます。
- クォータの量はプランによって異なります。各プランの量は料金をご覧ください。
- Ayrshare ダッシュボードから送信した投稿もカウントされます。
クォータのリセット時期
月間投稿クォータは、毎月 1 日の 00:07 UTC からリセットされます。すべてのアカウントに反映されるまで数分かかる場合があります。リセット日はすべてのアカウントで同じで、請求日とは関係ありません。- 更新の請求書を支払っても、クォータはリセットされません。
- プランを変更すると、Primary Profile のカウントはすぐにリセットされます。User Profile のカウントは 1 日まで維持されます。
- 月の途中で契約した場合、カウントはゼロから始まります。次のリセットは引き続き 1 日です。
- リセットは UTC 基準です。南北アメリカでは、前月の最終日の夜にリセットされます。
クォータにカウントされるもの
- 1 件の投稿リクエストは 1 回としてカウントされます。対象のプラットフォーム数は関係ありません。5 つのプラットフォームへの投稿も 1 回です。
- 失敗した投稿もカウントされます。 Ayrshare が投稿の送信を試みた場合、一部またはすべてのプラットフォームで失敗してもカウントされます。たとえば、ソーシャルネットワークが投稿を拒否した場合や、アカウントが連携されていない場合です。
- ブロックされた投稿もカウントされます。 あるプラットフォームで同じ失敗が繰り返されたために Ayrshare がブロックした投稿もカウントされます。
- スケジュール投稿は公開時にカウントされます。スケジュールを設定した時点ではありません。
- 送信前に拒否されたリクエスト（コード 106 で拒否されたリクエストなど）。
- 対象のすべてのプラットフォームで投稿検証に失敗した投稿。少なくとも 1 つのプラットフォームで検証を通過して送信された場合は、カウントされます。
クォータを使い切った場合
プロファイルが月間投稿クォータを使い切ると、次のようになります。- 新しい投稿リクエストは、HTTP
429とcode: 106を返します。後で公開するよう投稿をスケジュールするリクエストも含みます。 - その他の投稿関連リクエストも、リセットまで
code: 106を返します。たとえば、投稿の取得、削除、再試行や、投稿のアナリティクスです。 - 公開時刻を迎えたスケジュール投稿は
code: 106で失敗します。リセット後に自動で公開されることはありません。クォータのリセット後に再度送信してください。
使用量の確認
User Profile の詳細（GET /user）を呼び出します。User Profile を確認するには、その Profile-Key ヘッダーを追加してください。
monthlyPostCount：今月カウントされた投稿数。monthlyPostQuota：月間の上限。クォータが 10,000 以上の場合（Business プランなど）は省略されます。上限は引き続き適用されます。monthlyApiCallsは別のカウンターであり、投稿クォータではありません。
誤ってクォータを使い切らないために
失敗した投稿もカウントされるため、失敗する投稿を再試行し続けるループがあると、何も公開されないままクォータをすべて使い切ってしまう可能性があります。- 再び失敗するエラーを自動で再試行しないでください。まず原因を解決してください（アカウントの再連携など）。
- 再試行で成功する可能性があるエラー（
retryAvailable: trueのものなど）だけを再試行し、再試行の回数を制限してください。 - 想定外の急増に気付けるよう、
monthlyPostCountを定期的に確認してください。