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 매개변수를 늘립니다.