Khắc phục sự cố

Thông tin trong tài liệu này có thể giúp khắc phục những vấn đề mà bạn có thể gặp phải khi triển khai tính năng Liên kết gói thuê bao.

Lời nhắc Liên kết gói thuê bao bị lỗi trên màn hình tải

Ví dụ về lỗi:

Đang tải biểu tượng

Hình 1. Lời nhắc Liên kết gói thuê bao không tải được.

Để giải quyết vấn đề này, hãy kiểm tra các mục sau:

  • Đảm bảo bạn thêm nguồn gốc của các trang (bao gồm cả việc kiểm tra miền con) dưới dạng URL bổ sung trong chế độ cài đặt ấn bản của Trung tâm xuất bản.
  • Đối với các quá trình triển khai Extended Access (Quyền truy cập mở rộng) hoặc Reader Revenue Manager Enterprise, hãy nhớ thêm nguồn gốc của các trang (bao gồm cả miền con thử nghiệm) vào các nguồn gốc JavaScript được cho phép của Ứng dụng OAuth 2.0 mà bạn đã định cấu hình cho phương thức triển khai đó. Bạn cần thực hiện việc này trong Google Cloud Console.

Không liên kết được tài khoản

Ví dụ về lỗi:

Không liên kết được tài khoản

Hình 2. Vấn đề không liên kết được tài khoản.

Để giải quyết vấn đề này, hãy kiểm tra các mục sau:

  • Hãy nhớ chấp nhận Điều khoản dịch vụ về liên kết gói thuê bao trong Trung tâm xuất bản. Để thực hiện, hãy chuyển đến phần cài đặt Liên kết gói thuê bao rồi nhấp vào ký điều khoản dịch vụ về liên kết gói thuê bao.
  • Nếu Tài khoản Google đã được liên kết, bạn sẽ nhận được thông báo lỗi khi cố gắng liên kết lại gói thuê bao. Bạn phải huỷ liên kết gói thuê bao đó thông qua trang gói thuê bao trong Tài khoản Google trước khi lặp lại quy trình kiểm thử tích hợp phía máy khách.

Lỗi về quyền khi gọi Subscription Linking API (API Liên kết gói thuê bao)

Ví dụ về lỗi:

Mã 403
Thông điệp 'readerrevenuesubscriptionlinking.readerEntitlements.update' bị từ chối trên tài nguyên
'//readerrevenuesubscriptionlinking.googleapis.com/publications/example.com/readers/10078823/entitlements' (hoặc có thể không tồn tại)."

Để giải quyết vấn đề này, hãy kiểm tra các mục sau:

  • Đảm bảo bạn sử dụng cùng một dự án như đã chỉ định trong phần Thiết lập Liên kết gói thuê bao. Khi bạn thiết lập tính năng Liên kết gói thuê bao trong Trung tâm xuất bản, hãy sử dụng Số dự án. Bạn có thể tìm Số dự án từ trang tổng quan về dự án.
  • Hãy nhớ bật Subscription Linking API (API Liên kết gói thuê bao) trong dự án của bạn.
  • Trong phần Quản lý danh tính và quyền truy cập (IAM) của dự án, hãy đảm bảo rằng tài khoản dịch vụ được cấp vai trò là Quản trị viên liên kết gói thuê bao. Xin lưu ý rằng việc truyền thay đổi vai trò qua hệ thống có thể mất thời gian. Nếu bạn gặp lỗi 403 khi thực hiện lệnh gọi API, ngay cả sau khi bạn xác nhận rằng tài khoản dịch vụ của mình có vai trò quản lý danh tính và quyền truy cập (IAM) chính xác, hãy đợi trong giây lát rồi thử yêu cầu lại.

  • Nếu bạn không chắc nên sử dụng tài khoản dịch vụ nào hoặc liệu các tài khoản đó có vai trò IAM cần thiết hay không, hãy sử dụng Trình phân tích chính sách trong dự án mà bạn đã thiết lập cho tính năng Liên kết gói thuê bao. Tạo và chạy một truy vấn tuỳ chỉnh bằng các tham số truy vấn sau:

    Thông số 1 Role
    Role Quản trị viên liên kết gói thuê bao

  • Hãy đảm bảo bạn sử dụng đúng khoá tài khoản dịch vụ khi gọi Subscription Linking API (API Liên kết gói thuê bao). Kiểm tra các thuộc tính sau trong khoá tài khoản dịch vụ của bạn (tệp JSON):

    • loại: Phải là service_account.
    • project_id: Mã này phải là Mã dự án của Số dự án được chỉ định trong quy trình thiết lập Liên kết gói thuê bao.
    • client_email: Tài khoản này phải là cùng một tài khoản dịch vụ trong IAM của dự án được chỉ định vai trò Subscription linking Admin (Quản trị viên liên kết gói thuê bao).

  • Nếu bạn đã nhận được mã truy cập thông qua điểm cuối của mã thông báo Google OAuth 2.0 (https://oauth2.googleapis.com/token), hãy đảm bảo mã thông báo này hợp lệ và chưa hết hạn khi bạn gọi Subscription Linking API (API Liên kết gói thuê bao). Nếu mã thông báo hết hạn, bạn phải lấy một mã mới.

  • Nếu bạn sử dụng API REST, hãy đảm bảo rằng bạn dùng Mã nhận dạng ấn bản mà bạn đã cung cấp trong quá trình thiết lập Liên kết gói thuê bao. Ví dụ: nếu Mã nhận dạng ấn bản của bạn là example.com, thì URL yêu cầu phải chứa mã này.

    • ✅ Chỉ dùng Mã nhận dạng ấn bản đã thiết lập: publications/example.com/readers/10078823/entitlements
    • ❌ Đừng dùng Mã nhận dạng ấn bản khác với mã được chỉ định trong cấu hình Subscription linking (Liên kết gói thuê bao): publications/example-staging.com/readers/10078823/entitlements
    • ❌ Đừng đưa sản phẩm của ấn bản vào yêu cầu: publications/example.com:premium/readers/10078823/entitlements

Lỗi đối số không hợp lệ khi cập nhật quyền

Ví dụ về lỗi:

Thông điệp Lỗi: Yêu cầu chứa đối số không hợp lệ

Để giải quyết vấn đề này, hãy kiểm tra các mục sau:

  • Hãy đảm bảo bạn cung cấp đối tượng entitlements theo đúng định dạng. Hãy xem ví dụ này.
  • Đảm bảo product_id có định dạng publication_id:product.
    • ✅ Ví dụ hợp lệ: "product_id":"example.com:basic"
    • ❌ Ví dụ không hợp lệ: "product_id":"example.com"

Không thấy bài viết được đánh dấu trong kết quả tìm kiếm

Để giải quyết vấn đề này, hãy kiểm tra các mục sau: