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

このページでは、 Directory API を使用する。

400:badRequest

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

users.get メソッドを使用している場合は、userKey に渡された値を検証する パラメータは、ユーザーのメインのメールアドレス、エイリアスのメールアドレス、 あります。

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