Reseller API に関する問題のトラブルシューティング

このページでは、Reseller API に関連して発生する可能性のある一般的な問題について説明します。

400:badRequest

このエラーは、サブスクリプションが一時停止または解約された場合に発生します。詳細については、サブスクリプションを有効にするをご覧ください。

400:invalid

このエラーは、さまざまな原因で発生する可能性があります。

customers.insert メソッドを使用している場合、次のいずれかの顧客オブジェクト パラメータが無効です。

  • postalAddress.postalCode が無効です。
  • Google Workspace の販売パートナー様として不適格な postalAddress.countryCode。
  • alternateEmail は customerDomain と同じドメインにすることはできません

この問題を解決するには、必要なパラメータが存在し、お客様に対して有効であることを確認します。

subscriptions.changeSeats メソッドを使用している場合、次のいずれかの問題が原因でこのエラーが発生した可能性があります。

  • 年間プランのシート数を減らすことはできません。更新設定の変更を検討してください。アカウントのアクティブ ユーザー数と同じシート数を（更新時に）自動的に設定します。
  • リクエストしたシート数が、アカウントの現在のユーザー数よりも少ない。シート数を減らすには、ユーザーを削除する必要があることをお客様に伝えます。
  • 誤ったシート パラメータを増やしました。FLEX プランの場合は maximumNumberOfSeats パラメータを増やし、ANNUAL プランの場合は numberOfSeats パラメータを増やします。
  • 読み取り専用パラメータである licensedNumberOfSeats パラメータを変更しようとしました。
  • 試用期間中、お客様のシート数の上限は 10 です。無料試用サブスクリプションから有料サービスを開始すると、試用期間が直ちに終了し、請求が開始され、10 席の上限が解除されます。

403:forbidden

このエラーは、お客様を所有していない場合、またはお客様が管理コンソールへの販売パートナーのアクセスを無効にしている場合に発生します。

403:usageLimits.dailyLimitExceeded

このエラーは、この API の呼び出しの 1 日の割り当てに達した場合に発生します。この問題を解決するには、バックオフ遅延を実装します。詳細については、使用量上限と割り当てをご覧ください。

多くの定期購入を取得しようとしている場合は、customerId パラメータまたは subscriptionId パラメータを指定せずに subscriptions.list メソッドを使用することを検討してください。呼び出しごとに最大 100 件の定期購入を返すことができます。pageToken パラメータを使用して、販売パートナー アカウントのすべてのサブスクリプションの取得を続行します。

403:usageLimits.accessNotConfigured

このエラーは、Google Cloud プロジェクトで API が有効になっていない場合に発生します。この問題を解決するには、Google Cloud コンソールに移動して API を有効にします。詳細については、Google Workspace API を有効にするをご覧ください。

404:notFound

customers.get メソッドを使用している場合、このエラーは、Google Workspace アカウントに顧客またはドメインが存在せず、ドメインが使用可能であることを意味します。

412:conditionNotMet

このエラーは、さまざまな問題が原因で発生します。

subscriptions.changeRenewalSettings メソッドの使用時にこのエラーが発生した場合は、次のコミットメント プランでのみこのメソッドを呼び出していることを確認してください。

  • ANNUAL_MONTHLY_PAY
  • ANNUAL_YEARLY_PAY

subscriptions.delete メソッドの使用時にこのエラーが発生した場合は、Google Workspace アカウントに管理者ユーザーが存在しないことを意味します。この問題を解決するには、一時的な管理者ユーザーを追加して、もう一度お試しください。

subscriptions.insert メソッドの使用時にこのエラーが発生した場合は、選択した SKU を再販できないか、新興市場の顧客に再販できないことを意味します。この問題を解決するには、該当する利用規約に同意します。

429:usageLimits.quotaExceeded

このエラーは、1 秒あたりのクエリ数の上限を超えた場合に発生します。この問題を解決するには、バックオフ再試行戦略を実装するか、結果をキャッシュに保存して API 呼び出しの回数を減らします。詳細については、使用量上限と割り当てをご覧ください。

多くの定期購入を取得しようとしている場合は、customerId パラメータまたは subscriptionId パラメータを指定せずに subscriptions.list メソッドを使用することを検討してください。呼び出しごとに最大 100 件の定期購入を返すことができます。pageToken パラメータを使用して、販売パートナー アカウントのすべてのサブスクリプションの取得を続行します。