Yêu cầu về việc tích hợp

Để triển khai tính năng Đăng ký bằng Google, bạn thường phải hoàn tất các nhiệm vụ triển khai bên dưới. Tuy nhiên, trong một số trường hợp (ví dụ: trang web hoặc cấu hình phụ trợ), bạn có thể không cần triển khai một số nhiệm vụ. Trong các Yêu cầu triển khai này, thuật ngữ "Nhà xuất bản" có cùng ý nghĩa với "Bạn" trong Phụ lục về việc Đăng ký bằng Google của Thoả thuận phân phối dành cho nhà phát triển của Google Play.

  1. Tài khoản nhà phát triển trên Google Play:

    Nhà xuất bản phải tạo tài khoản nhà phát triển trên Google Play, tải ứng dụng lên và bật tính năng thanh toán cho ứng dụng. Nhà xuất bản phải phát hành ứng dụng trong phiên bản chính thức hoặc sử dụng một ứng dụng chính thức hiện có.

  2. Cấu hình ấn bản: Nhà xuất bản phải làm việc với người đại diện giải pháp kỹ thuật của Google để thiết lập một số điểm cấu hình nhất định mà Google yêu cầu để thiết lập chế độ tích hợp, bao gồm: URL cho các điểm cuối API bắt buộc, tài sản biểu trưng/thương hiệu, thông tin chi tiết về SKU, chính sách quyền riêng tư và URL Điều khoản dịch vụ. Bạn phải thực hiện cấu hình này cho mỗi ấn bản được tích hợp.

  3. Mã đánh dấu trang: Nhà xuất bản phải thêm dữ liệu có cấu trúc bao gồm mã ấn bản (tương ứng với mã trong Cấu hình ấn bản) và nhãn quyền. Dữ liệu có cấu trúc phải có trên tất cả các trang bài viết, bao gồm cả tài liệu dành cho máy tính và thiết bị di động.

  4. Tích hợp ứng dụng swg.js: Nhà xuất bản phải tích hợp ứng dụng JavaScript của Google vào trang web ấn bản của họ. Nhà xuất bản phải đưa thư viện ứng dụng swg.js vào tất cả các trang có thể kích hoạt một tường phí, bao gồm cả các bài viết thuộc quá trình triển khai tường phí phía máy chủ, đồng thời phải gọi hàm getEntitlements swg.js và xử lý phản hồi từ hàm đó một cách thích hợp.

    Trong phạm vi Nhà xuất bản tạo phiên bản trang dành cho thiết bị di động và các trang dành cho thiết bị di động này có thể kích hoạt tường phí, các trang dành cho thiết bị di động phải được định cấu hình bằng một tường phí dành cho thiết bị di động sử dụng các quyền SwG để tuân thủ các quyền của người dùng SwG.

  5. Tích hợp Android: Trong phạm vi Nhà xuất bản đang bán các nhóm SKU khác nhau trên Android so với web, hoặc trong trường hợp Nhà xuất bản có nhiều ứng dụng cho cùng một ấn bản, Nhà xuất bản phải cập nhật các ứng dụng Android để kiểm tra giao dịch mua gói thuê bao, đồng thời gọi API ấn bản Đăng ký bằng Google và cấp quyền truy cập một cách thích hợp.

  6. Đăng nhập bằng Google: Nhà xuất bản phải đưa tuỳ chọn Đăng nhập bằng Google vào tất cả trang đăng nhập cho web và triển khai các thư viện GIS có liên quan cho Ứng dụng iOS và Android.

    Việc triển khai tính năng Đăng nhập bằng Google này phải kiểm tra API ấn bản Đăng ký bằng Google để đảm bảo rằng nếu Tài khoản Google đã có quyền được liên kết với nhà xuất bản, thì Tài khoản Google đó sẽ được liên kết với tài khoản hiện có của người dùng trên trang web của Nhà xuất bản. Nếu API Đăng ký bằng ấn bản của Google cho biết người dùng có quyền mà Nhà xuất bản không biết, thì Nhà xuất bản sẽ cấp quyền truy cập thích hợp cho những người dùng đã biết. Tuy nhiên, nếu người dùng không xác định, thì Nhà xuất bản sẽ khởi chạy Quy trình tạo tài khoản bị trì hoãn.

    Nếu sản phẩm ứng dụng web hoặc ứng dụng di động của Nhà xuất bản cung cấp trải nghiệm hoàn toàn miễn phí và không có hàng rào truy cập bằng tường phí, thì bạn không bắt buộc phải sử dụng tính năng Đăng nhập bằng Google. Ngoài ra, trong trường hợp hiếm hoi mà nhà xuất bản không duy trì hệ thống quản lý người dùng (tức là nhà xuất bản hoàn toàn dựa vào tính năng Đăng ký bằng Google để quản lý giao dịch của người dùng), thì bạn không cần (hoặc không thể) tích hợp tính năng Đăng nhập bằng Google.

  7. Trình xử lý tạo tài khoản sau khi mua: Nhà xuất bản phải tạo tài khoản cho người dùng sau khi mua hàng.

    Trên web, Nhà xuất bản phải có thể chuyển lại các sự kiện thuê bao swg.js và dữ liệu quyền cho cơ sở hạ tầng Nhà xuất bản. Đối với các giao dịch mua được thực hiện trên các nền tảng của Google hoặc trong ứng dụng, Nhà xuất bản phải xử lý việc tạo tài khoản bị trì hoãn và sẽ nhận được thông báo tạo tài khoản thông qua Pub/Sub hoặc API ấn bản.

    Nhà xuất bản phải đăng ký các sự kiện Play Cloud hoặc Reader Revenue Pub/Sub trong cơ sở hạ tầng của Nhà xuất bản.

    Nhà xuất bản phải sử dụng dữ liệu giao dịch mua từ các sự kiện đăng ký để yêu cầu hồ sơ người dùng và dữ liệu gói thuê bao từ API Trạng thái gói thuê bao của Google. Sau khi nhận được dữ liệu đó, Account Management API phải:

    1. tạo một tài khoản bằng thông tin hồ sơ người dùng do Google cung cấp và liên kết gói thuê bao với tài khoản đó; hoặc
    2. nối hồ sơ người dùng và dữ liệu thuê bao trên Google vào một tài khoản người dùng hiện có trên trang web của Nhà xuất bản.

    Trong trường hợp nhà xuất bản không duy trì hệ thống quản lý người dùng (tức là nhà xuất bản hoàn toàn dựa vào tính năng Đăng ký bằng Google để quản lý giao dịch của người dùng), thì không cần thiết (hoặc không thể) tạo tài khoản sau khi mua.

  8. Tích hợp iOS: Nếu Nhà xuất bản có nội dung có tường phí được liên kết với SKU Đăng ký bằng Google trong một ứng dụng iOS, sau khi sử dụng tính năng Đăng nhập bằng Google, Nhà xuất bản phải kiểm tra phần phụ trợ của họ để biết các quyền và nếu không tìm thấy quyền nào, hãy gọi API ấn bản Đăng ký bằng Google để kiểm tra các quyền và cấp quyền truy cập nếu có.

  9. Liên kết gói thuê bao: Khi kết thúc bất kỳ quy trình mua hàng nào không được xử lý bằng tính năng Đăng ký bằng Google, Nhà xuất bản phải tích hợp chức năng Liên kết gói thuê bao để cung cấp cho người dùng lựa chọn liên kết Tài khoản Google của họ. Nhà xuất bản sẽ cần tạo một dự án trên Google Cloud để triển khai tính năng liên kết gói thuê bao.

  10. Yêu cầu đối với nhà xuất bản ở Đức: Các nhà xuất bản ở Đức phải thực hiện những yêu cầu sau:

    1. Làm nổi bật nút huỷ được dán nhãn rõ ràng và dễ đọc. Nút này luôn xuất hiện trên trang web của bạn dành cho những người đăng ký ở Đức với nội dung "Huỷ hợp đồng ở đây" [“Verträge hier kündigen”] hoặc một từ tương đương, rõ ràng.
    2. Hướng dẫn những người dùng ở Đức đã đăng ký ấn phẩm của bạn thông qua tính năng Đăng ký bằng Google và nhấp vào nút huỷ của bạn để https://support.google.com/googleplay/contact/cancel_sub_request yêu cầu huỷ gói thuê bao của họ.
    3. Hãy phản hồi những người đăng ký cố gắng huỷ gói thuê bao đã mua thông qua tính năng Đăng ký bằng Google theo cách không chính xác bằng một tuyên bố rõ ràng và không gây hiểu lầm, cho người đăng ký biết rằng họ nên truy cập vào https://support.google.com/googleplay/contact/cancel_sub_request để yêu cầu huỷ hợp đồng đã mua thông qua tính năng Đăng ký bằng Google.