고객의 계정 정보 검색 및 업데이트

리셀러 API를 사용하여 고객 정보를 검색하고 업데이트하려면 다음 두 가지 방법 중 하나로 고객을 찾을 수 있습니다.

  • 고객의 고유 식별자(예: C0123456)
  • 고객의 도메인 이름(예: example.com)

고객의 계정 정보 검색

고객의 계정 정보를 검색하려면 다음 GET 요청을 사용하고 승인 토큰을 포함합니다.

GET https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

CUSTOMER_ID을 고객의 고유 식별자 또는 도메인 이름으로 바꿉니다.

응답 반환

고객의 계정 정보를 검색하면 다음 응답 중 하나가 표시될 수 있습니다.

  • 전체 고객 설정을 반환합니다. 이 고객은 기존 고객 중 하나입니다. 리셀러 API를 사용하면 이 고객의 계정 및 구독 설정을 관리할 수 있습니다.

  • 최소한의 고객 계정 정보를 반환합니다. 응답에서 customerId, customerDomain, customerType만 반환되면 Google 또는 다른 리셀러가 고객을 관리하는 것입니다. 이 고객에 대해 다른 이메일 인증 고객을 만들 수 없습니다. 이 고객을 관리하려면 다음 단계를 따르세요.

    1. 고객의 이전 가능한 모든 정기 결제를 검색하여 정기 결제 이전 가능 여부 및 이전을 위한 최소 사용자 라이선스 수를 확인합니다.
    2. 구독을 이전합니다.

  • Multiple teams exist on this domain를 반환합니다. 이 도메인에는 연결된 팀 고객이 한 명 이상 있습니다. 이 도메인에 다른 팀을 추가하려면 다음 단계를 따르세요.

    1. 고객 계정을 주문합니다.
    2. 도메인의 도메인 확인 고객을 만들려면 고객에게 Google을 통해 직접 구독을 구매하고 도메인을 확인하고 기존 팀을 인계한 다음 구독을 계정으로 이전하도록 요청합니다.

  • HTTP 404 오류를 반환합니다. 이 고객은 Google을 처음 사용하며 계정이 없습니다. 이 고객을 관리하려면 다음 단계를 따르세요.

    1. 고객의 기본 도메인 이름과 고유한 Google 고객 식별자가 일치하지 않을 수 있는 이전 고객 데이터가 고객 레코드에 보관되어 있지 않은지 확인합니다. 이전에 삭제한 Google 계정이 복원되면 계정이 동일한 customerDomain 값을 유지하더라도 새 계정으로 취급되며 새 customerId 값을 갖게 됩니다.
    2. 신규 고객 계정 주문
    3. 새 고객 계정의 구독을 만듭니다.

고객의 설정 업데이트하기

리셀러 API를 사용하면 customerType를 업데이트할 수 없지만 team 고객의 도메인을 확인하고 domain 고객이 될 수 있습니다.

고객의 설정을 업데이트하려면 다음 PUT 요청을 사용하고 고객의 고유 식별자를 포함합니다.

PUT https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

JSON 요청 본문은 다음 고객 설정을 업데이트합니다.

{
  "customerId": "C0CUSTOMER_ID123456",
  "customerDomain": "DOMAIN_NAME",
  "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).

성공적인 JSON 응답은 HTTP 200 상태 코드와 업데이트된 고객 설정을 반환합니다.

{
  "kind": "reseller#customer",
  "customerId": "CUSTOMER_ID",
  "customerDomain": "DOMAIN_NAME",
  "postalAddress": {
    "kind": "customers#address",
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE",
  },
  "alternateEmail": "EMAIL_ADDRESS"
}