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

Trước khi bạn tạo tài khoản khách hàng mới, hãy xem xét 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 xem 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 người dùng 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 đó đã được 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 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à bao gồ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ột mã trạng thái HTTP 409 Conflict, thì tức là 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 hạng 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 và ký thoả thuận về 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 ký Điều khoản dịch vụ thay mặt cho khách hàng.

Các kiểu khách hàng

Bạn có thể tạo hai kiểu khách hàng trên Google Workspace:

• Khách hàng được xác minh bằng miền. Những khách hàng này cần có Gmail và cần quyền truy cập của 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 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 thuộc nhóm 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 dưới đây là một ví dụ về khách hàng đã xác minh bằng miền:

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

Thay thế các đoạn mã 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ã ZIP hoặc mã bưu chính của khách hàng, ví dụ: 94043.
• COUNTRY_CODE: mã quốc gia ISO gồm 2 ký tự của khách hàng của bạn.
• 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 dưới đây là ví dụ về một khách hàng đã xác minh bằng 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 cho khách hàng trước khi tạo người dùng bất kỳ.

Một 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 một khách hàng:

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

Bao gồm nội dung yêu cầu JSON sau:

{
  "language":"LANGUAGE_CODE"
}

Thay thế các đoạn mã sau:

• CUSTOMER_ID: giá trị nhận dạng duy nhất của 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 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 đại lý
• Các lỗi thường gặp về API Thư mục