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 パラメータを使用して、販売パートナー アカウントのすべてのサブスクリプションを取得し続けます。