Đặt hàng tài khoản khách hàng mới

Trước khi tạo tài khoản khách hàng mới, hãy cân nhắc những điều sau:

  • Có thể áp dụng các hạn chế về mã quốc gia. Để xác nhận rằng quốc gia của khách hàng được phê duyệt để bán lại, hãy kiểm tra Partner Sales Console.
  • Nếu tài khoản được tạo bằng cách nâng cấp từ tài khoản Gmail thông thường lên email doanh nghiệp có tên miền, hãy đảm bảo rằng tài khoản đó có các chế độ cài đặt bổ sung của Google Workspace. Để biết thêm thông tin, hãy xem bài viết Tạo email doanh nghiệp cho nhóm của bạn và Tạo email đại diện cho doanh nghiệp.

Tạo tài khoản khách hàng

  1. Để tạo tài khoản khách hàng, hãy sử dụng yêu cầu POST sau đây và thêm mã thông báo uỷ quyền:

    POST https://reseller.googleapis.com/apps/reseller/v1/customers

  2. Trong tài khoản của khách hàng mới, hãy tạo một người dùng. Nếu phản hồi trả về mã trạng thái HTTP 409 Conflict, thì customerId đã tồn tại. Trước khi đăng ký tài khoản khách hàng, bạn phải chuyển các gói thuê bao của khách hàng.

  3. Nếu có, hãy thay đổi ngôn ngữ mặc định của khách hàng.

  4. Chuyển người dùng sang vai trò quản trị viên cấp cao. Khi tạo tài khoản quản trị viên, bạn có thể tạo mật khẩu ngẫu nhiên tạm thời hoặc nhắc khách hàng cung cấp mật khẩu.

  5. Thông báo cho khách hàng rằng họ phải đăng nhập vào Bảng điều khiển dành cho quản trị viên và ký thoả thuận Google Workspace thông qua Đại lý để kích hoạt tài khoản của họ. Người bán lại không được phép ký Điều khoản dịch vụ thay mặt cho khách hàng.

Các loại khách hàng

Bạn có thể tạo 2 loại khách hàng trên Google Workspace:

  • Khách hàng đã xác minh miền. Những khách hàng này cần Gmail và cần có quyền quản trị đầy đủ. Khi bạn tạo loại khách hàng này, hãy đặt customerType thành domain.
  • Khách hàng đã xác minh email. Những khách hàng này không sở hữu hoặc quản lý miền của họ. Khi bạn tạo loại khách hàng này, hãy đặt customerType thành team. Những khách hàng này có thể mua các phiên bản Essentials và Enterprise Essentials của Google Workspace.

Nội dung yêu cầu JSON sau đây là ví dụ về một khách hàng đã xác minh miền:

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

Thay thế nội dung sau:

  • DOMAIN_NAME: miền của khách hàng – ví dụ: example.com
  • NAME: tên của khách hàng – ví dụ: Alex Cruz.
  • ORGANIZATION_NAME: tên tổ chức của khách hàng – ví dụ: Example Organization.
  • POSTAL_CODE: mã bưu chính của khách hàng – ví dụ: 94043.
  • COUNTRY_CODE: mã quốc gia theo tiêu chuẩn ISO gồm 2 ký tự của khách hàng.
  • EMAIL_ADDRESS: địa chỉ email của khách hàng – ví dụ: cruz@example.com.

Phản hồi thành công sẽ trả về mã trạng thái HTTP 200 và thông tin của khách hàng mới:

{
  "kind": "reseller#customer",
  "customerId": "CUSTOMER_ID",
  "customerDomain": "DOMAIN_NAME",
  "customerType": "domain",
  "postalAddress": {
    "kind": "customers#address",
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE",
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

Nội dung yêu cầu JSON sau đây là ví dụ về một khách hàng đã xác minh email:

{
  "customerDomain": "DOMAIN_NAME",
  "customerType": "team",
  "primaryAdmin": {
    "primaryEmail": "EMAIL_ADDRESS"
  },
  "postalAddress": {
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE"
  },
 "alternateEmail": "EMAIL_ADDRESS"
}

Phản hồi thành công sẽ trả về mã trạng thái HTTP 200 và thông tin của khách hàng mới:

{
  "kind": "reseller#customer",
  "customerId": "CUSTOMER_ID",
  "customerDomain": "DOMAIN_NAME,
  "customerType": "team",
  "primaryAdmin": {
    "primaryEmail": "EMAIL_ADDRESS"
  },
  "postalAddress": {
    "kind": "customers#address",
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE",
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

Thay đổi ngôn ngữ mặc định của khách hàng

Ngôn ngữ mặc định của khách hàng chỉ được áp dụng cho người dùng mới khi họ được tạo. Người dùng hiện tại vẫn giữ nguyên ngôn ngữ hiện tại ngay cả sau khi bạn cập nhật ngôn ngữ mặc định. Do đó, bạn phải đặt ngôn ngữ mặc định của khách hàng trước khi tạo người dùng.

Khách hàng mới tạo có ngôn ngữ mặc định là tiếng Anh. Để thay đổi ngôn ngữ mặc định, hãy sử dụng các lệnh gọi PATCH hoặc UPDATE từ điểm cuối Khách hàng của Directory API.

Sử dụng Directory API để cập nhật giá trị language mặc định cho khách hàng:

PATCH https://reseller.googleapis.com/admin/directory/v1/customers/CUSTOMER_ID

Thêm nội dung yêu cầu JSON sau đây:

{
  "language":"LANGUAGE_CODE"
}

Thay thế nội dung sau:

  • CUSTOMER_ID: giá trị nhận dạng duy nhất cho khách hàng của bạn, ví dụ: C0123456
  • LANGUAGE_CODE: một mã ngôn ngữ được chấp nhận – ví dụ: es cho tiếng Tây Ban Nha.

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

{
  "alternateEmail": "EMAIL_ADDRESS",
  "customerCreationTime": "2022-12-12T23:04:10.620Z",
  "customerDomain": "DOMAIN_NAME",
  "id": "CUSTOMER_ID",
  "kind": "admin#directory#customer",
  "language": "LANGUAGE_CODE",
  "postalAddress": {
    "contactName": "NAME",
    "countryCode": "COUNTRY_CODE",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE"
  }
}

Các bước tiếp theo