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 Workspace가 아닌 다른 Google 제품

이 문제를 해결하려면 다음 단계를 따르세요.

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