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

このページでは、販売者として 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 以外）。

この問題を解決するには、次の操作を行います。

  1. users.get メソッドを呼び出します。

    200 レスポンスが返された場合、そのユーザーはお客様の Google Workspace アカウントにすでに存在します。このユーザーをアカウントに追加することはできません。

    403 forbidden レスポンスが返された場合、プライマリ メール パラメータのドメインが再販されたお客様のものではないか、プライマリ メールが以前に別の Google サービスで使用されているかです。このユーザーを正常に追加するには、まずお客様のドメインの所有権を確認する必要があります。

  2. お客様のドメインの所有権を確認できる場合は、次の手順を行います。

    1. users.insert メソッドを使用して一時的な管理者ユーザーを作成し、ドメインの最終的な確認手順までプロビジョニングを続行します。
    2. ドメインを確認する際は、webResource.insert 呼び出しのリクエスト本文の owners[] パラメータに、一時ユーザーを追加します。200 レスポンスが返されるまでこの呼び出しを行います。
    3. ドメインの確認が完了したら、users.patch メソッドまたは users.update メソッドを使用して、一時的なユーザー名の名前を変更します。

  3. お客様のドメインの所有権を確認できない場合は、次の手順を行います。

    1. users.insert メソッドを使用して一時的な管理者ユーザーを作成します。
    2. お客様に、一時ユーザーとしてログインし、管理コンソールからドメインの所有権を確認していただきます。
    3. ドメインの所有権の確認が完了したら、お客様またはお客様の代理人が一時的なユーザー名の名前を変更できます。users.patch メソッドまたは users.update メソッドを使用できます。

412:limitExceeded

このエラーは、お客様が座席数の上限に達した場合に発生します。この問題を解決するには、subscriptions.changeSeats メソッドを使用し、サブスクリプション プランに応じて以下を使用します。

  • FLEXIBLE の場合は、maximumNumberOfSeats パラメータを増やします。
  • ANNUAL の場合は、numberOfSeats パラメータを増やします。