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 パラメータを増やします。