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

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

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

고객의 계정 정보 검색

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

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

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

응답 반환

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

  • 전체 고객 설정을 반환합니다. 고객이 기존 고객 중 한 명입니다. Reseller 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. 이 새 고객 계정에 대한 구독을 만듭니다.

고객 설정 업데이트

Reseller 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"
}