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

리셀러 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. 도메인 인증 고객을 만들려면 고객에게 직접 요금제를 구매하고 도메인을 인증한 후, 다음에 요금제를 이전하도록요청합니다.

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

    1. 기본 도메인 이름과 고유한 Google 고객 식별자가 일치하지 않는 이전 고객 데이터가 기록에 없는지 확인합니다. 삭제된 계정이 복원되면 새 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"
}