このページでは、販売者として Directory API を使用する際に発生する可能性のある一般的な問題について説明します。
400:badRequest
このエラーは、メソッドに正しくないパラメータ値が渡された場合に発生します。
users.get メソッドを使用する場合は、userKey パラメータに渡される値がユーザーのプライマリ メールアドレス、エイリアス メールアドレス、または一意のユーザー ID のいずれかであることを確認します。
users.list メソッドを使用する場合は、次のパラメータを確認します。
customerパラメータ: Google が生成したcustomerIdのみを使用します。実際の顧客のドメインは使用しないでください。このパラメータを使用することをおすすめします。お客様がセカンダリ ドメインを使用している場合、domainパラメータを使用すると、その特定のドメインのメールアドレスを持つユーザーのみが返されます。domainパラメータ: 実際のお客様のドメインのみを使用します。Google が生成した
customerIdは使用しないでください。
403:domainCannotUseApis
このエラーは、お客様が Admin SDK API への販売パートナー アクセスを無効にしている場合に発生します。この問題を解決するには、Admin SDK API へのアクセスを再度有効にするようお客様に依頼します。詳細については、API アクセスの制御をご覧ください。
現在のライセンス ユーザー数を取得しようとしてこのエラーが発生した場合は、users.list メソッドを呼び出す代わりに、サブスクリプション リソースの licensedNumberOfSeats フィールドを使用します。
403:forbidden
このエラーは、お客様を所有していない場合、またはお客様が管理コンソールへの販売パートナーのアクセスを無効にしている場合に発生します。
この問題を解決するには、呼び出しを行う前に customers.get メソッドを呼び出して顧客の販売パートナー所有権を確認するか、管理コンソールで販売パートナーによるアクセスを再度有効にするよう顧客に依頼します。詳しくは、顧客の管理コンソールにアクセスするをご覧ください。
403:usageLimits.accessNotConfigured
このエラーは、Google Cloud プロジェクトで API が有効になっていない場合に発生します。この問題を解決するには、Google Cloud コンソールに移動して API を有効にします。詳細については、Google Workspace API を有効にするをご覧ください。
409:duplicate
このエラーは、新しいユーザーを追加しようとしたときに、お客様のメインのメールアドレスが次のいずれかにすでに存在する場合に発生します。
- 追加しようとしている現在の Google Workspace アカウント。
- 別の Google サービス（Google Workspace 以外）。
この問題を解決するには、次の操作を行います。
users.getメソッドを呼び出します。200レスポンスが返された場合、ユーザーはすでに顧客の Google Workspace アカウントに存在します。このユーザーをアカウントに追加することはできません。403 forbiddenレスポンスが返された場合、メインのメール パラメータのドメインが再販されたお客様ではないか、メインのメールが以前に別の Google サービスで使用されたことがあり、このユーザーを正常に追加するには、まずお客様のドメインを検証する必要があります。お客様のドメインの所有権を確認できる場合は、次の手順を行います。
users.insertメソッドを使用して一時的な管理者ユーザーを作成し、最終的なドメイン認証の手順までプロビジョニングを続行します。- ドメインの確認時に、
webResource.insert呼び出しのリクエストの本文のowners[]パラメータに一時ユーザーを追加します。200レスポンスが返されるまでこの呼び出しを行います。 - ドメインの確認が完了したら、
users.patchメソッドまたはusers.updateメソッドを使用して、一時的なユーザー名を変更します。
お客様のドメインの所有権を確認できない場合は、次の手順を行います。
users.insertメソッドを使用して一時的な管理者ユーザーを作成します。- お客様に仮のユーザーとしてログインしていただき、管理コンソールからドメインの所有権を確認していただきます。
- ドメインの確認が完了したら、お客様またはパートナー様が仮のユーザー名を変更できます。
users.patchメソッドまたはusers.updateメソッドのいずれかを使用できます。
412:limitExceeded
このエラーは、お客様がシートの上限に達したときに発生します。この問題を解決するには、subscriptions.changeSeats メソッドを使用し、サブスクリプション プランに応じて次のいずれかを使用します。
FLEXIBLEの場合は、maximumNumberOfSeatsパラメータを増やします。ANNUALの場合は、numberOfSeatsパラメータを増やします。