Đặ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 quy tắc hạn chế về mã quốc gia. Để xác nhận rằng quốc gia của một khách hàng được phê duyệt để bán lại, hãy kiểm tra Bảng điều khiển Chương trình kinh doanh dành cho Đối tác.
• Nếu tài khoản được tạo bằng cách nâng cấp từ tài khoản Gmail cá nhân 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ở khoá. Để biết thêm thông tin, xem Tạo email doanh nghiệp cho nhóm của bạn và Tạo bí danh email đại diện.

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à đưa mã thông báo uỷ quyền vào:

   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. 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 yêu cầu 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ý bán lại để kích hoạt tài khoản. Đại lý bán lại không được phép ký Điều khoản dịch vụ thay mặt khách hàng.

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

Bạn có thể tạo hai 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 đã 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 Google Workspace Essentials và Google Workspace Enterprise Essentials của Google Workspace.

Nội dung yêu cầu JSON sau đây là một ví dụ về 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 hoặc mã vùng của khách hàng, ví dụ: 94043.
• COUNTRY_CODE: Mã quốc gia gồm 2 ký tự theo tiêu chuẩn ISO 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à một ví dụ về 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 bất kỳ người dùng nào.

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 API Thư mục.

Sử dụng API Thư mục để 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

Đưa nội dung yêu cầu JSON sau đây vào:

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