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 API Đại lý, điều quan trọng là bạn phải hiểu được mối quan hệ 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 nhà tích hợp dịch vụ để quản lý khách hàng.

Đại lý có thể chọn trong số 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 vòng một năm. Khách hàng có thể tạo tối đa số lượng giấy phép, nhưng nhà bán lẻ sẽ được tính phí theo 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.
  • 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í cho đại lý đối với giấy phép này. Hợp đồng của đại lý với Google mô tả giá, thông số kỹ thuật và số lượng giấy phép tối đa.

Cùng với việc quản lý giấy phép của người dùng, đại lý (hoặc các nhà tích hợp dịch vụ đối tác) cung cấp cho khách hàng nhiều dịch vụ bổ sung như đào tạo, chương trình 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 khi tính 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 một tài khoản Google Workspace mà nhà bán 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, email thay thế và địa chỉ thực. Sau đó, nhà bán 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 riêng lẻ. Để biết thêm thông tin, hãy xem bài viết Đặt tài khoản khách hàng mới.

Kế hoạch

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 họ với khách hàng.

API Đại lý hỗ trợ hệ thống thanh toán sau theo tháng của Google Workspace. Hệ thống này có một số gói thanh toán:

  • ANNUAL_MONTHLY_PAY: Cam kết hằng năm với phương thức 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 lượng dùng thử có thể thay đổi, tối đa là 30 ngày.
    • Hạn mức gửi thư hằng ngày trên Gmail là 500 thư/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 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ý các gói thuê bao của khách hàng Google.

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

Mỗi gói thuê bao có một giá trị nhận dạng duy nhất, subscriptionId. Vì subscriptionId thay đổi khi gói thuê bao thay đổi, nên đừng sử dụng giá trị subscriptionId làm khoá cho dữ liệu ổn định. 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 sản phẩm thương mại của một nhóm dịch vụ và tính năng ứng dụng chuyên biệt 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 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, API Đại lý 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.