このページは Cloud Translation API によって翻訳されました。

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

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

`400:badRequest`

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

`400:invalid`

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

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

postalAddress.postalCode が無効です。
postalAddress.countryCode は Google Workspace の再販の対象外です。
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`

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