このページでは、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 呼び出しを減らします。詳細については、使用量上限と割り当てをご覧ください。
多数のサブスクリプションを取得する場合は、customerId
パラメータまたは subscriptionId
パラメータを指定せずに subscriptions.list
メソッドの使用を検討してください。呼び出しごとに最大 100 個のサブスクリプションを返すことができます。販売パートナー アカウントのすべてのサブスクリプションを取得するには、pageToken
パラメータを使用します。