Tổng quan về API dành cho đại lý

Google cung cấp sản phẩm cho người dùng thông qua các kênh phân phối như đại lý uỷ quyền của Google Workspace. Khi làm việc với Reseller API, bạn phải hiểu được mối quan hệ khái niệm giữa đại lý, khách hàng, gói thanh toán, SKU sản phẩm và giấy phép.

Đại lý

Đại lý mua giấy phép người dùng của Google rồi bán lại cho khách hàng. Đại lý có thể trực tiếp quản lý gói thuê bao của khách hàng hoặc làm việc với một đơn vị tích hợp dịch vụ để quản lý khách hàng khi tuỳ chỉnh nhiều dịch vụ.

Đại lý có thể chọn một trong các gói sau:

  • cam kết hằng năm: Đại lý mua một số lượng giấy phép cố định của Google trong một năm. Khách hàng có thể tạo tối đa số lượng giấy phép, nhưng đại lý sẽ bị tính phí cho số lượng giấy phép đã đặt hàng. Để tăng số lượng giấy phép, đại lý có thể sử dụng phương thức subscriptions.changeSeats.
  • linh hoạt: Mỗi khi khách hàng tạo một người dùng mới, Google sẽ tính phí giấy phép đối với đại lý. Hợp đồng của đại lý với Google mô tả giá, quy cách và số lượng giấy phép tối đa.

Ngoài việc quản lý giấy phép người dùng, đại lý hoặc đối tác tích hợp dịch vụ của đại lý còn cung cấp cho khách hàng các dịch vụ như đào tạo, khuyến mãi, quảng cáo, định giá, tuỳ chỉnh triển khai, khắc phục sự cố và bảo trì.

Giấy phép

Giấy phép cho phép người dùng có Tài khoản Google truy cập vào các dịch vụ của Google Workspace. Khi khách hàng chỉ định giấy phép cho người dùng, giấy phép đó sẽ trở thành giấy phép đang hoạt động. Chỉ những giấy phép đang hoạt động mới được tính vào tổng số người dùng của khách hàng.

Khách hàng

Khách hàng của Google bắt đầu bằng tài khoản Google Workspace do đại lý định cấu hình. Khi thiết lập tài khoản, đại lý sẽ cung cấp tên miền chính, email thay thế và địa chỉ thực. Đại lý cũng tạo một gói thuê bao cho mỗi SKU sản phẩm mà khách hàng có thể sử dụng. Khách hàng lưu trữ từng tài khoản người dùng. Để biết thêm thông tin, hãy xem bài viết Đặt hàng tài khoản khách hàng mới.

Gói

Kế hoạch xác định các điều khoản thanh toán của đại lý với Google. Các gói này không xác định mối quan hệ thanh toán giữa đại lý và khách hàng của họ. Đại lý tự xác định các điều khoản thanh toán với khách hàng.

Reseller API hỗ trợ hệ thống trả sau hằng tháng của Google Workspace, có các gói thanh toán sau:

  • ANNUAL_MONTHLY_PAY: Cam kết hằng năm và thanh toán hằng tháng.
  • ANNUAL_YEARLY_PAY: Cam kết hằng năm và thanh toán một lần mỗi năm.
  • FLEXIBLE: Gói không cam kết thanh toán hằng tháng.
  • TRIAL: Gói dùng thử miễn phí.
    • Thời gian dùng thử có thể thay đổi, tối đa là 30 ngày.
    • Hạn mức gửi hằng ngày của Gmail là 500 thư cho mỗi người dùng.
  • FREE: Gói miễn phí chỉ dành cho gói thuê bao Phiên bản Cloud Identity miễn phí.

Để biết thêm thông tin, hãy xem bài viết Chọn gói thanh toán cho khách hàng.

Gói đăng ký

Gói thuê bao quản lý mối quan hệ giữa gói thanh toán, SKU sản phẩm, giấy phép người dùng, trạng thái dùng thử miễn phí 30 ngày và các lựa chọn gia hạn của khách hàng Google. Vai trò chính của đại lý là quản lý các gói thuê bao này.

Trong Reseller API, gói thuê bao là một tài nguyên API chính. Nó xác định các chế độ cài đặt cho gói thanh toán, giấy phép, thời gian dùng thử miễn phí 30 ngày, việc gia hạn và đơn đặt hàng của người bán lại. Một khách hàng có thể có nhiều gói thuê bao, mỗi gói cho một SKU sản phẩm được chỉ định cho họ.

Mỗi gói thuê bao đều có một giá trị nhận dạng riêng biệt, subscriptionId. Vì subscriptionId sẽ thay đổi khi gói thuê bao thay đổi, nên đừng dùng biến này làm khoá cho dữ liệu liên tục.

Để biết thêm thông tin, hãy xem bài viết Quản lý gói thuê bao.

Sản phẩm và SKU sản phẩm

Sản phẩm là một dịch vụ và ứng dụng thương mại của Google. Một sản phẩm có thể có các phiên bản tuỳ chỉnh về điều khoản, giá và các thông tin chi tiết khác trong thoả thuận. Mỗi phiên bản được xác định bằng một SKU sản phẩm. Reseller API cung cấp các gói thuê bao cho SKU trong các sản phẩm Google Workspace, Google Vault và Google Drive. Để biết thêm thông tin, hãy xem bài viết Sản phẩm và SKU.