새 고객 계정을 만들기 전에 다음 사항을 고려하세요.
- 국가 코드 제한이 적용될 수 있습니다. 고객의 국가에서 재판매가 승인되었는지 확인하려면 Partner Sales Console을 확인하세요.
- 일반 Gmail 계정에서 도메인 이름이 있는 비즈니스 이메일로 업그레이드하여 계정을 만든 경우 계정에 추가 Google Workspace 설정이 잠금 해제되어 있는지 확인합니다. 자세한 내용은 팀을 위한 비즈니스 이메일 만들기 및 비즈니스 이메일 별칭 만들기를 참고하세요.
고객 계정 만들기
고객 계정을 만들려면 다음
POST
요청을 사용하고 승인 토큰을 포함합니다.POST https://reseller.googleapis.com/apps/reseller/v1/customers
새 고객 계정 내에서 사용자를 만듭니다. 응답이 HTTP
409 Conflict
상태 코드를 반환하면customerId
가 이미 존재합니다. 고객 계정을 등록하기 전에 고객의 구독을 이전해야 합니다.해당하는 경우 고객의 기본 언어를 변경합니다.
사용자를 최고 관리자 역할로 승격합니다. 관리자 계정을 만들 때 임시 무작위 비밀번호를 생성하거나 고객에게 비밀번호를 입력하라는 메시지를 표시할 수 있습니다.
고객에게 계정을 활성화하려면 관리 콘솔에 로그인하고 리셀러 계약을 통해 Google Workspace에 서명해야 한다고 알립니다. 리셀러는 고객을 대신하여 서비스 약관에 서명할 수 없습니다.
고객 유형
Google Workspace에서는 다음 두 가지 유형의 고객을 만들 수 있습니다.
- 도메인 인증 고객 이러한 고객에게는 Gmail과 전체 관리자 액세스 권한이 필요합니다. 이 유형의 고객을 만들 때는
customerType
를domain
로 설정합니다. - 이메일 인증 고객 이러한 고객은 도메인을 소유하거나 관리하지 않습니다. 이 유형의 고객을 만들 때는
customerType
를team
로 설정합니다. 이러한 유형의 고객은 Google Workspace의 Essentials 및 Enterprise Essentials 버전을 구매할 수 있습니다.
다음 JSON 요청 본문은 도메인 인증 고객의 예입니다.
{ "customerDomain": "DOMAIN_NAME", "customerType": "domain", "postalAddress": { "contactName": "NAME", "organizationName": "ORGANIZATION_NAME", "postalCode": "POSTAL_CODE", "countryCode": "COUNTRY_CODE" }, "alternateEmail": "EMAIL_ADDRESS" }
다음을 바꿉니다.
DOMAIN_NAME
: 고객의 도메인입니다(예:example.com
).NAME
: 고객 이름입니다(예:Alex Cruz
).ORGANIZATION_NAME
: 고객의 조직 이름입니다(예:Example Organization
).POSTAL_CODE
: 고객의 우편번호(예:94043
)COUNTRY_CODE
: 고객의 2자리 ISO 국가 코드입니다.EMAIL_ADDRESS
: 고객의 이메일 주소입니다(예:cruz@example.com
).
응답에 HTTP 200
상태 코드와 새 고객 정보가 반환됩니다.
{ "kind": "reseller#customer", "customerId": "CUSTOMER_ID", "customerDomain": "DOMAIN_NAME", "customerType": "domain", "postalAddress": { "kind": "customers#address", "contactName": "NAME", "organizationName": "ORGANIZATION_NAME", "postalCode": "POSTAL_CODE", "countryCode": "COUNTRY_CODE", }, "alternateEmail": "EMAIL_ADDRESS" }
다음 JSON 요청 본문은 이메일 인증 고객의 예입니다.
{ "customerDomain": "DOMAIN_NAME", "customerType": "team", "primaryAdmin": { "primaryEmail": "EMAIL_ADDRESS" }, "postalAddress": { "contactName": "NAME", "organizationName": "ORGANIZATION_NAME", "postalCode": "POSTAL_CODE", "countryCode": "COUNTRY_CODE" }, "alternateEmail": "EMAIL_ADDRESS" }
응답에 HTTP 200
상태 코드와 새 고객 정보가 반환됩니다.
{ "kind": "reseller#customer", "customerId": "CUSTOMER_ID", "customerDomain": "DOMAIN_NAME, "customerType": "team", "primaryAdmin": { "primaryEmail": "EMAIL_ADDRESS" }, "postalAddress": { "kind": "customers#address", "contactName": "NAME", "organizationName": "ORGANIZATION_NAME", "postalCode": "POSTAL_CODE", "countryCode": "COUNTRY_CODE", }, "alternateEmail": "EMAIL_ADDRESS" }
고객의 기본 언어 변경하기
고객의 기본 언어는 신규 사용자를 만들 때만 적용됩니다. 개발자가 기본 언어를 업데이트한 후에도 기존 사용자는 현재 언어를 유지합니다. 따라서 사용자를 만들기 전에 고객 기본 언어를 설정해야 합니다.
새로 생성된 고객의 기본 언어는 영어입니다. 기본 언어를 변경하려면 Directory API 고객 엔드포인트에서 PATCH
또는 UPDATE
호출을 사용하세요.
Directory API를 사용하여 고객의 기본 language
값을 업데이트합니다.
PATCH https://reseller.googleapis.com/admin/directory/v1/customers/CUSTOMER_ID
다음 JSON 요청 본문을 포함합니다.
{ "language":"LANGUAGE_CODE" }
다음을 바꿉니다.
CUSTOMER_ID
: 고객의 고유 식별자입니다(예:C0123456
).LANGUAGE_CODE
: 허용되는 언어 코드입니다(예: 스페인어의 경우es
).
성공적인 JSON 응답은 HTTP 200
상태 코드와 업데이트된 고객 리소스를 반환합니다.
{ "alternateEmail": "EMAIL_ADDRESS", "customerCreationTime": "2022-12-12T23:04:10.620Z", "customerDomain": "DOMAIN_NAME", "id": "CUSTOMER_ID", "kind": "admin#directory#customer", "language": "LANGUAGE_CODE", "postalAddress": { "contactName": "NAME", "countryCode": "COUNTRY_CODE", "organizationName": "ORGANIZATION_NAME", "postalCode": "POSTAL_CODE" } }