Đặ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ể có các quy định hạn chế về mã quốc gia. Để xác nhận rằng quốc gia đượ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ừ Gmail dành cho người dùng cá nhân tài khoản với một 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, hãy xem 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 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, 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 gói thuê bao của khách hàng.

3. Nếu có thể, hãy thay đổi thư mục mặc định của khách hàng.

4. Quảng bá người dùng đế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 tạo mật khẩu ngẫu nhiên 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 qua đại lý để kích hoạt tài khoản của mình. Đại lý bị cấm ký Điều khoản dịch vụ vào thay mặt cho khách hàng.

Các kiểu 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 được xác minh bằng miền. Những khách hàng này cần Gmail và cần toàn quyền truy cập 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. Khi bạn tạo loại khách hàng này, hãy đặt customerType thành team Những kiểu khách hàng này có thể mua Kiến thức cơ bản và thông tin cơ bản dành cho doanh nghiệp của các phiên bản Google Workspace khác nhau.

Nội dung yêu cầu JSON sau đây là ví dụ về một khách hàng được 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ế đoạn mã sau:

• DOMAIN_NAME: miền của khách hàng của bạn (ví dụ: example.com
• NAME: tên khách hàng của bạn (ví dụ: Alex Cruz).
• ORGANIZATION_NAME: tổ chức của khách hàng của bạn tên (ví dụ: Example Organization).
• POSTAL_CODE: mã ZIP hoặc mã bưu điện của khách hàng của bạn—cho ví dụ: 94043.
• COUNTRY_CODE: 2 ký tự của khách hàng của bạn Mã quốc gia theo ISO.
• EMAIL_ADDRESS: địa chỉ email của khách hàng của bạn—cho ví dụ: [e-mail].

Khi phản hồi thành công, hệ thống sẽ trả về mã trạng thái HTTP 200 và mã trạng thái của khách hàng mới của bạn:

{
  "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 được 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"
}

Khi phản hồi thành công, hệ thống sẽ trả về mã trạng thái HTTP 200 và mã trạng thái của khách hàng mới của bạn:

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

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 PATCH hoặc UPDATE lệnh gọi từ Directory API Khách hàng điểm cuối.

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

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

{
  "language":"LANGUAGE_CODE"
}

Thay thế đoạn mã sau:

• CUSTOMER_ID: giá trị nhận dạng riêng biệt của khách hàng—ví dụ: C0123456
• LANGUAGE_CODE: đã chấp nhận mã ngôn ngữ —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 dành cho khách hàng:

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