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

このページでは、販売パートナーとして Directory API を使用する際に発生する可能性のある一般的な問題について説明します。

400:badRequest

このエラーは、メソッドに誤ったパラメータ値が渡された場合に発生します。

users.get メソッドを使用する場合は、userKey パラメータに渡された値が、ユーザーのメインのメールアドレス、エイリアス メールアドレス、または一意のユーザー ID のいずれかであることを確認します。

users.list メソッドを使用する場合は、次のパラメータを確認します。

  • customer パラメータ: customerId のみを使用してください。これは Google によって生成されたものです。実際の顧客のドメインは使用しないでください。顧客にセカンダリ ドメインがある場合、この パラメータを使用すると、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. ドメインを確認するときに、owners[] 呼び出しのリクエスト本文の webResource.insert パラメータに一時ユーザーを追加します。 200 レスポンスが返されるまでこの呼び出しを行います。
    3. ドメインが確認されたら、 users.patch または users.update メソッドを使用して、一時的なユーザー名を変更します。

  3. 顧客のドメインを確認できない場合は、次の操作を行います。

    1. users.insert メソッドを使用して一時的な管理者ユーザーを作成します。
    2. 顧客に一時ユーザーとしてログインし、管理コンソールからドメインを確認してもらいます。
    3. ドメインが確認されたら、顧客または販売パートナーが 一時的なユーザー名を変更できます。 users.patch メソッドまたは users.update メソッドを使用できます。

412:limitExceeded

このエラーは、顧客が最大シート数に達した場合に発生します。この問題を解決するには、subscriptions.changeSeats メソッドを使用します。サブスクリプション プランに応じて、次のいずれかを使用します。

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