신규 고객 계정 주문

새 고객 계정을 만들기 전에 다음 사항을 고려하세요.

고객 계정 만들기

  1. 고객 계정을 만들려면 다음 POST 요청을 사용하고 승인 토큰을 포함합니다.

    POST https://reseller.googleapis.com/apps/reseller/v1/customers

  2. 새 고객 계정 내에서 사용자를 만듭니다. 응답이 HTTP 409 Conflict 상태 코드를 반환하면 customerId가 이미 존재합니다. 고객 계정을 등록하기 전에 고객의 구독을 이전해야 합니다.

  3. 해당하는 경우 고객의 기본 언어를 변경합니다.

  4. 사용자를 최고 관리자 역할로 승격합니다. 관리자 계정을 만들 때 임시 무작위 비밀번호를 생성하거나 고객에게 비밀번호를 입력하라는 메시지를 표시할 수 있습니다.

  5. 고객에게 계정을 활성화하려면 관리 콘솔에 로그인하고 리셀러 계약을 통해 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"
  }
}

다음 단계