Truy xuất & cập nhật thông tin tài khoản của khách hàng

Để truy xuất và cập nhật thông tin của khách hàng bằng cách sử dụng API dành cho người bán lại, bạn có một trong hai cách để tra cứu khách hàng:

  • Giá trị nhận dạng duy nhất của khách hàng (ví dụ: C0123456
  • Tên miền của khách hàng (ví dụ: example.com

Truy xuất thông tin tài khoản của khách hàng

Để truy xuất thông tin tài khoản của khách hàng, hãy sử dụng yêu cầu GET sau và bao gồm mã thông báo uỷ quyền:

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

Thay thế CUSTOMER_ID bằng mã duy nhất của khách hàng của bạn giá trị nhận dạng hoặc tên miền của bạn.

Trả về phản hồi

Khi truy xuất thông tin tài khoản của khách hàng, bạn có thể nhận được một trong các câu trả lời sau:

  • Trả về chế độ cài đặt đầy đủ của khách hàng. Khách hàng là một trong những khách hàng hiện tại. Khi sử dụng API dành cho người bán lại, bạn có thể quản lý việc này chế độ cài đặt gói thuê bao và tài khoản của khách hàng.

  • Trả về thông tin tài khoản khách hàng tối thiểu. Nếu chỉ trả lời trả về customerId, customerDomaincustomerType, Google hoặc một đại lý khác quản lý khách hàng. Bạn không thể tạo một tài khoản khác xác minh bằng email cho khách hàng. Để quản lý khách hàng này, hãy làm theo các bước sau:

    1. Truy xuất tất cả gói thuê bao có thể chuyển cho khách hàng nắm được liệu có thể chuyển gói thuê bao hay không và số lượng giấy phép người dùng tối thiểu để chuyển.
    2. Chuyển gói thuê bao.
  • Trả về Multiple teams exist on this domain. Miền này có một hoặc nhiều khách hàng nhóm được liên kết. Để thêm một đội khác với miền này, hãy làm theo các bước sau:

    1. Đặt hàng một tài khoản khách hàng.
    2. Để tạo một khách hàng được xác minh bằng miền cho miền đó, hãy yêu cầu khách hàng đó mua gói thuê bao trực tiếp qua Google và xác minh miền của họ, tiếp quản các nhóm hiện có sau đó chuyển gói thuê bao đó sang tài khoản của bạn.
  • Trả về lỗi HTTP 404. Khách hàng này mới sử dụng Google và không có tài khoản. Để quản lý khách hàng này, hãy làm theo các bước sau:

    1. Xác nhận rằng hồ sơ khách hàng của bạn không lưu giữ dữ liệu khách hàng cũ bằng tên miền chính của khách hàng và tên duy nhất có thể không khớp Mã nhận dạng khách hàng của Google. Khi một Tài khoản Google đã bị xoá trước đó đã khôi phục thì tài khoản này sẽ được coi là một tài khoản mới và có customerId mới mặc dù tài khoản có thể giữ lại cùng một customerDomain giá trị.
    2. Đặt hàng một tài khoản khách hàng mới.
    3. Tạo gói thuê bao cho tài khoản khách hàng mới này.

Cập nhật chế độ cài đặt của khách hàng

Khi sử dụng API Đại lý, bạn không cập nhật được customerType nhưng có thể xác minh miền của khách hàng team và trở thành khách hàng domain.

Để cập nhật chế độ cài đặt của khách hàng, hãy sử dụng yêu cầu PUT sau và thêm giá trị nhận dạng riêng biệt cho khách hàng của bạn:

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

Nội dung yêu cầu JSON sẽ cập nhật các chế độ cài đặt sau đây của khách hàng:

{
  "customerId": "C0CUSTOMER_ID123456",
  "customerDomain": "DOMAIN_NAME",
  "postalAddress": {
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE"
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

Thay thế đoạn mã sau:

  • DOMAIN_NAME: miền của khách hàng của bạn (ví dụ: example.com
  • NAME: tên khách hàng của bạn (ví dụ: Alex Cruz).
  • ORGANIZATION_NAME: tổ chức của khách hàng của bạn tên (ví dụ: Example Organization).
  • POSTAL_CODE: mã ZIP hoặc mã bưu điện của khách hàng của bạn—cho ví dụ: 94043.
  • COUNTRY_CODE: 2 ký tự của khách hàng của bạn Mã quốc gia theo ISO.
  • EMAIL_ADDRESS: địa chỉ email của khách hàng của bạn—cho ví dụ: cruz@example.com.

Phản hồi JSON thành công sẽ trả về mã trạng thái HTTP 200 và cài đặt khách hàng:

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