Directory API 문제 해결

이 페이지에서는 API와 관련하여 발생할 수 있는 몇 가지 일반적인 문제에 대해 설명합니다. Directory API를 사용할 수 없습니다.

400:badRequest

이 오류는 잘못된 매개변수 값이 메서드에 전달되었을 때 발생합니다.

users.get 메서드를 사용하는 경우 값이 userKey에 전달되었는지 확인합니다. 매개변수는 사용자의 기본 이메일 주소, 별칭 이메일 주소 또는 고유 사용자 ID입니다.

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 응답을 받으면 기본 이메일 매개변수가 리셀러 고객이 아니거나 기본 이메일이 사용되었습니다. 고객의 도메인이 있어야 하며 먼저 인증을 받아야 이 사용자를 추가할 수 있습니다.

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