Đặ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 quy định hạn chế theo 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 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 rằng tài khoản đó đã mở khoá 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à đưa mã 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 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. Thay đổi ngôn ngữ mặc định của khách hàng (nếu có).

4. Chuyển 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 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 đại lý Google Workspace để kích hoạt tài khoản. Đạ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 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à cần có quyền quản trị viên đầ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 qua 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 loại khách hàng này có thể mua 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ề 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 khách hàng của bạn, 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ã zip 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 qua 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 sẽ giữ lại 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 lệnh gọi PATCH hoặc UPDATE từ điểm cuối Khách hàng của API Thư mục.

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:

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

• Các lỗi thường gặp về API của đại lý
• Các lỗi thường gặp về Directory API