Solución de problemas

La información que aparece en este documento está pensada para ayudarte a solucionar problemas que pueden surgir al implementar la vinculación de suscripciones.

La petición de vinculación de suscripciones se bloquea en la pantalla de carga

Ejemplo de error:

Símbolo de carga

Imagen 1. La petición de vinculación de suscripciones no se carga.

Para solucionar este problema, comprueba lo siguiente:

  • Asegúrate de añadir los orígenes de las páginas, incluidos los subdominios de pruebas, como URLs adicionales en la configuración de la publicación del Centro de editores.
  • Para las implementaciones de acceso ampliado o Reader Revenue Manager Enterprise, asegúrate de añadir los orígenes de las páginas, incluidos los subdominios de pruebas, a los orígenes de JavaScript autorizados del cliente de OAuth 2.0 que has configurado para dichas implementaciones. Esto se tiene que hacer en la consola de Google Cloud.

No se ha podido vincular la cuenta

Ejemplo de error:

No se ha podido vincular la cuenta

Imagen 2. Problema: No se ha podido vincular la cuenta.

Para solucionar este problema, comprueba lo siguiente:

  • Asegúrate de que has aceptado los Términos del Servicio para la Vinculación de Suscripciones en el Centro de editores. Para ello, ve a la configuración de Vinculación de suscripciones y haz clic en Firmar los términos del servicio para la vinculación de suscripciones.
  • Si la cuenta de Google ya se ha vinculado, se mostrará un mensaje de error cuando vuelvas a intentar vincular la suscripción. Debes desvincular la suscripción desde la página de suscripciones de la cuenta de Google para poder repetir la prueba de integración del lado del cliente.

Error de permisos al llamar a la API Subscription Linking

Ejemplo de error:

Código 403
Mensaje 'readerrevenuesubscriptionlinking.readerEntitlements.update' se ha denegado en el recurso
'//readerrevenuesubscriptionlinking.googleapis.com/publications/example.com/readers/10078823/entitlements'
(o puede que no exista).

Para solucionar este problema, comprueba lo siguiente:

  • Asegúrate de que usas el mismo proyecto que se ha especificado en la configuración de la vinculación de suscripciones. Cuando configures la vinculación de suscripciones en el Centro de editores, usa el número del proyecto. Puedes encontrar el número del proyecto en tu panel de proyectos.
  • Asegúrate de que la API Subscription Linking esté habilitada en tu proyecto.
  • En la Gestión de Identidades y Accesos del proyecto, asegúrate de que la cuenta de servicio tenga asignado el rol de administrador de la vinculación de suscripciones. Ten en cuenta que propagar el cambio de rol en todo el sistema puede llevar un tiempo. Si se produce el error 403 al hacer llamadas a la API incluso después de confirmar que tu cuenta de servicio tiene el rol correcto de gestión de identidades y accesos, espera unos minutos y vuelve a intentarlo.
  • Si no sabes con certeza qué cuentas de servicio usar o si tienen el rol necesario de gestión de identidades y accesos, utiliza el Analizador de políticas del proyecto que has configurado para la vinculación de suscripciones. Crea y ejecuta una consulta personalizada con los siguientes parámetros:

    Parámetro 1 Rol
    Rol Administrador de vinculación de suscripciones
  • Usa la clave de cuenta de servicio correcta cuando llames a la API Subscription Linking. Revisa las siguientes propiedades en tu clave de cuenta de servicio (archivo JSON):

    • type: debe ser service_account.
    • project_id: debe ser el ID del proyecto delnúmero del proyecto especificado en la configuración de la vinculación de suscripciones.
    • client_email: debe ser la misma cuenta de servicio de la gestión de identidades y accesos del proyecto que tiene asignado el rol de Administrador de vinculación de suscripciones.
  • Si has obtenido el token de acceso mediante el endpoint de token de Google OAuth 2.0 (https://oauth2.googleapis.com/token), comprueba que el token sea válido y que y que no haya caducado cuando llames a la API Subscription Linking. Si el token caduca, tendrás que obtener uno nuevo.

  • Si usas la API REST, debes emplear el ID de publicación que has proporcionado en la configuración de la vinculación de suscripciones. Por ejemplo, si tu ID de publicación es example.com, este ID debe figurar en la URL de la solicitud.

    • ✅ Usa solo el ID de publicación configurado: publications/example.com/readers/10078823/entitlements
    • ❌ No uses ningún otro ID de publicación que no sea el que has especificado en la configuración de la vinculación de suscripciones:publications/example-staging.com/readers/10078823/entitlements
    • ❌ No incluyas el producto de la publicación en la solicitud: publications/example.com:premium/readers/10078823/entitlements

Error de argumento no válido al actualizar el derecho

Ejemplo de error:

Mensaje Error: La solicitud contiene un argumento no válido

Para solucionar este problema, comprueba lo siguiente:

  • Asegúrate de que proporcionas el objeto entitlements en el formato correcto. Consulta este ejemplo.
  • Asegúrate de que product_id tenga el formato publication_id:product.
    • ✅ Ejemplo válido: "product_id":"example.com:basic"
    • ❌ Ejemplo no válido: "product_id":"example.com"

No se ven los artículos destacados en los resultados de búsqueda

Para solucionar este problema, comprueba lo siguiente: