このページでは、販売パートナーとして 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
パラメータを増やします。