신규 고객 계정 주문

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

  • 국가 코드 제한사항이 적용될 수 있습니다. 고객의 국가에서 재판매가 승인되었는지 확인하려면 파트너 판매 콘솔을 확인하세요.
  • 일반 Gmail 계정에서 도메인 이름이 있는 비즈니스 이메일로 업그레이드하여 계정을 만든 경우 계정에 추가 Google Workspace 설정이 잠금 해제되어 있는지 확인합니다. 자세한 내용은 팀의 비즈니스 이메일 만들기비즈니스 이메일 별칭 만들기를 참고하세요.

고객 계정 만들기

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

    POST https://reseller.googleapis.com/apps/reseller/v1/customers
    
  2. 신규 고객의 계정에서 사용자를 만듭니다. 응답이 HTTP 409 Conflict 상태 코드를 반환하면 customerId가 이미 있는 것입니다. 고객 계정을 등록하기 전에 고객의 구독을 이전해야 합니다.

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

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

  5. 고객에게 계정을 활성화하려면 관리 콘솔에 로그인하고 리셀러를 통한 Google Workspace 계약에 서명해야 한다고 안내합니다. 리셀러가 고객을 대신하여 서비스 약관에 서명할 수 없습니다.

고객 유형

Google Workspace에서는 두 가지 유형의 고객을 만들 수 있습니다.

  • 도메인 인증 고객. 이러한 고객은 Gmail이 필요하며 전체 관리자 액세스 권한이 필요합니다. 이 유형의 고객을 만들 때 customerTypedomain로 설정합니다.
  • 이메일 인증 고객. 이러한 고객은 도메인을 소유하거나 관리하지 않습니다. 이 유형의 고객을 만들 때 customerTypeteam로 설정합니다. 이러한 유형의 고객은 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"
  }
}

다음 단계