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

리셀러 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"
}