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

Một trong những cách Google cung cấp dịch vụ sản phẩm của Google cho người dùng là thông qua các kênh phân phối dịch vụ, chẳng hạn như đại lý được uỷ quyền của Google Workspace. Khi làm việc với Reseller API, bạn cần hiểu rõ mối quan hệ theo khái niệm của đại lý với 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 và bán lại các giấy phép này cho khách hàng của Google. Đại lý có thể trực tiếp quản lý gói thuê bao của khách hàng hoặc nếu tuỳ chỉnh nhiều dịch vụ, đại lý có thể hợp tác với một đơn vị tích hợp dịch vụ để quản lý khách hàng.

Đạ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 từ 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. Nếu khách hàng cần thêm giấy phép, đại lý có thể sử dụng lệnh gọi API subscriptions.changeSeats để tăng số lượng giấy phép đã đặt hàng.
  • 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 này cho đạ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 các đơn vị tích hợp dịch vụ đối tác của đại lý) còn cung cấp cho khách hàng nhiều dịch vụ bổ sung như đào tạo, khuyến mãi, quảng cáo, định giá, tuỳ chỉnh việc 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 khi tính tổng số người dùng của một khách hàng.

Khách hàng

Khách hàng của Google bắt đầu bằng một tài khoản Google Workspace do đại lý định cấu hình. Khi thiết lập tài khoản của khách hàng, đại lý cung cấp tên miền chính, địa chỉ email thay thế và địa chỉ thực. Sau đó, đại lý cũng tạo một gói thuê bao cho từng 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 riêng lẻ. Để 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

Gói 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ý xác định các điều khoản thanh toán của riêng mình với khách hàng.

Reseller API hỗ trợ hệ thống thanh toán sau hằng tháng của Google Workspace, trong đó có một số gói thanh toán hiện có:

  • ANNUAL_MONTHLY_PAY: Cam kết hằng năm với các khoản thanh toán hằng tháng
  • ANNUAL_YEARLY_PAY: Cam kết hằng năm với một khoản thanh toán hằng 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 Cloud Identity miễn phí

Để biết thêm thông tin về các gói này, 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 của khách hàng Google với SKU của 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. Vai trò chính của đại lý là quản lý gói thuê bao của khách hàng Google.

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 mà đại lý chỉ định cho khách hàng.

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

Để 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ụ thương mại gồm một bộ tính năng chuyên biệt của dịch vụ và ứng dụng 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 sản phẩm này được xác định bằng một SKU sản phẩm. Trong phiên bản này, Reseller API cung cấp một gói thuê bao cho mỗi 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 phần Sản phẩm và SKU.