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