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

리셀러 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을 처음 사용하며 Google에 문의하지 않은 경우 계정이 있어야 합니다. 이 고객을 관리하려면 다음 단계를 따르세요.

    1. 고객 기록에 이전 고객 데이터가 보관되어 있지 않은지 고객의 기본 도메인 이름과 고유 도메인 이름의 잠재적인 불일치 Google 고객 식별자입니다. 이전에 삭제한 Google 계정이 새 계정으로 간주되어 새 customerId이(가) 적용됩니다. 값이 동일하더라도 계정에 동일한 customerDomain이 유지될 수 있습니다. 값으로 사용됩니다.
    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"
}