Đặ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 lưu ý 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 tài khoản đó có các chế độ cài đặt bổ sung của Google Workspace được mở khóa. Để 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ó thể, hãy thay đổi ngôn ngữ mặc định của khách hàng.

4. Thăng cấp người dùng lên 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 của Google và ký thoả thuận Google Workspace thông qua Đại lý để kích hoạt tài khoản của họ. Đại lý không được phép thay mặt khách hàng ký Điều khoản dịch vụ.

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 có Gmail và quyền truy cập đầy đủ của quản trị viên. Khi bạn tạo loại khách hàng này, hãy đặt customerType thành domain.
• Khách hàng được xác minh bằng 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 Google Workspace Essentials và Google Workspace 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ụ: [e-mail].

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ỉ áp dụng cho người dùng mới. Người dùng hiện tại vẫn giữ nguyên ngôn ngữ của họ sau khi bạn cập nhật ngôn ngữ mặc định. Do đó, hãy đặt ngôn ngữ mặc định của khách hàng trước khi bạn tạo người dùng.

Khách hàng mới có ngôn ngữ mặc định là tiếng Anh. Để thay đổi ngôn ngữ mặc định, hãy sử dụng phương thức 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, 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

• Các lỗi thường gặp về Reseller API
• Các lỗi thường gặp về Directory API