Khắc phục sự cố

Thông tin trong tài liệu này có thể giúp bạn khắc phục các vấ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 kêu gọi hành động về Liên kết gói thuê bao bị kẹt trên màn hình tải

Ví dụ về lỗi:

Biểu tượng tải

Hình 1. Lời kêu gọi hành động về Liên kết gói thuê bao không tải.

Để giải quyết vấn đề này, hãy kiểm tra những điều sau:

  • Đảm bảo rằng bạn thêm nguồn gốc của các trang, bao gồm cả miền phụ thử nghiệm, làm URL bổ sung trong phần cài đặt ấn bản của Trung tâm xuất bản.
    • Đảm bảo rằng trạng thái của URL là "Đã xác minh" thay vì "Xác minh".
  • Đối với các trường hợp triển khai Quyền truy cập mở rộng hoặc Reader Revenue Manager Enterprise, hãy đảm bảo rằng bạn thêm nguồn gốc của các trang, bao gồm cả miền phụ 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 trường hợp triển khai đó. Bạn cần thực hiện việc này trong Bảng điều khiển Google Cloud.

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 những điều sau:

  • Đảm bảo rằng bạn chấp nhận Điều khoản dịch vụ về Liên kết gói thuê bao trong Publisher Center. Để làm như vậy, 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 thử 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 bài kiểm tra tích hợp phía máy khách.

Lỗi về quyền khi gọi Subscription Linking API

Ví dụ về lỗi:

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

Để giải quyết vấn đề này, hãy kiểm tra những điều sau:

  • Đảm bảo rằng 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 thiết lập Liên kết gói thuê bao trong Publisher Center, hãy sử dụng Số dự án. Bạn có thể tìm thấy Số dự án trên trang tổng quan về dự án.
  • Đảm bảo rằng Subscription Linking API đã bật 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 quá trình thay đổi vai trò được truyền qua hệ thống có thể mất thời gian. Nếu bạn nhận được lỗi 403 khi thực hiện lệnh gọi API, ngay cả sau khi xác nhận rằng tài khoản dịch vụ của bạn có vai trò IAM chính xác, hãy chờ một lát rồi thử lại yêu cầu.

  • 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 từ dự án mà bạn đã thiết lập cho 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:

    Tham số 1 Vai trò
    Vai trò Quản trị viên liên kết gói thuê bao

  • Đảm bảo rằng bạn sử dụng đúng khoá tài khoản dịch vụ khi gọi Subscription Linking API. Kiểm tra các thuộc tính sau trong khoá tài khoản dịch vụ (tệp JSON):

    • type: Phải là service_account.
    • project_id: Phải là Mã dự án của Số dự án được chỉ định trong phần thiết lập Liên kết gói thuê bao.
    • client_email: Phải là cùng một tài khoản dịch vụ trong IAM dự án được chỉ định vai trò 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 mã thông báo Google OAuth 2.0 (https://oauth2.googleapis.com/token), hãy đảm bảo rằng mã thông báo đó còn hiệu lực và chưa hết hạn khi bạn gọi Subscription Linking API. Nếu mã thông báo hết hạn, bạn phải lấy mã thông báo mới.

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

    • ✅ Chỉ sử dụng Mã nhận dạng ấn bản đã định cấu hình: publications/example.com/readers/10078823/entitlements
    • ❌ Không sử dụng Mã nhận dạng ấn bản khác với mã nhận dạng được chỉ định trong cấu hình Liên kết gói thuê bao : publications/example-staging.com/readers/10078823/entitlements
    • ❌ Không thêm sản phẩm ấ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:

Nhắn tin 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 những điều sau:

  • Đảm bảo rằng bạn cung cấp đối tượng entitlements ở đúng định dạng. Xem ví dụ này .
  • Đảm bảo rằng product_id ở đị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 làm nổi bật trong kết quả tìm kiếm

Để giải quyết vấn đề này, hãy kiểm tra những điều sau:

Không thể thay đổi ngôn ngữ của thông báo lời kêu gọi hành động về Liên kết gói thuê bao

Lời kêu gọi hành động Liên kết gói thuê bao

Ngôn ngữ của lời kêu gọi hành động về Liên kết gói thuê bao được xác định theo chế độ cài đặt của người dùng. Bạn không thể ghi đè ngôn ngữ này trên toàn cầu.

Ngôn ngữ được xác định như sau:

  1. Nếu người dùng đã đăng nhập bằng Tài khoản Google, thì ngôn ngữ chính được đặt trong phần cài đặt Tài khoản Google (https://myaccount.google.com/language) sẽ được sử dụng.

  2. Nếu người dùng chưa đăng nhập, thì ngôn ngữ sẽ dựa trên chế độ cài đặt ngôn ngữ chính của trình duyệt hoặc hệ điều hành.

Lời kêu gọi hành động về Liên kết gói thuê bao không hỗ trợ tất cả các ngôn ngữ. Nếu ngôn ngữ chính của người dùng không được hỗ trợ, thì lời kêu gọi hành động có thể mặc định là tiếng Anh.