Risoluzione dei problemi

Le informazioni in questo documento possono aiutarti a risolvere i problemi che potresti riscontrare durante l'implementazione della funzionalità Collegamento degli abbonamenti.

Richiesta di collegamento degli abbonamenti bloccata sulla schermata di caricamento

Esempio di errore:

Simbolo di caricamento

Figura 1. La richiesta di collegamento degli abbonamenti non viene caricata.

Per risolvere il problema, verifica quanto segue:

  • Assicurati di aggiungere le origini delle pagine, inclusi i sottodomini di test, come URL aggiuntivi nelle impostazioni della pubblicazione nel Centro editori.
  • Per le implementazioni di accesso esteso o Reader Revenue Manager Enterprise, assicurati di aggiungere le origini delle pagine, compresi i sottodomini di test ai sottodomini origini JavaScript autorizzate del client OAuth 2.0 configurato per questa implementazione. Questa operazione deve essere effettuata nella console Google Cloud.

Impossibile collegare l'account

Esempio di errore:

Impossibile collegare l'account

Figura 2. Problema Impossibile collegare l'account.

Per risolvere il problema, verifica quanto segue:

  • Assicurati di accettare i Termini di servizio per il collegamento degli abbonamenti nel Centro editori. A questo scopo, vai alle impostazioni Collegamento degli abbonamenti e fai clic su Firma i Termini di servizio per il collegamento degli abbonamenti.
  • Se l'Account Google è già stato collegato, riceverai un messaggio di errore quando cercherai di nuovo di collegare l'abbonamento. Prima di ripetere il test di integrazione lato client devi scollegare l'abbonamento tramite la pagina Abbonamenti nell'Account Google.

Errore relativo alle autorizzazioni durante la chiamata dell'API Subscription Linking

Esempio di errore:

Codice 403
Messaggio 'readerrevenuesubscriptionlinking.readerEntitlements.update' negata per la risorsa
'//readerrevenuesubscriptionlinking.googleapis.com/publications/example.com/readers/10078823/entitlements' (oppure la risorsa potrebbe non esistere)."

Per risolvere il problema, verifica quanto segue:

  • Assicurati di usare lo stesso progetto specificato nella configurazione di Collegamento degli abbonamenti. Quando configuri Collegamento degli abbonamenti nel Centro editori, usa il numero di progetto. Il numero di progetto si trova nella dashboard dei progetti.
  • Assicurati che l'API Subscription Linking sia attiva nel tuo progetto.
  • Nel progetto Identity and Access Management (IAM), assicurati di aver assegnato il ruolo di Amministratore collegamento abbonamenti al service account. Tieni presente che la propagazione della modifica del ruolo nel sistema potrebbe richiedere un po' di tempo. Se ricevi l'errore 403 mentre effettui chiamate API anche dopo aver confermato che il service account ha il ruolo IAM corretto, attendi qualche minuto e riprova a inviare la richiesta.

  • Se non sai quale service account usare o se ha il ruolo IAM necessario, usa Policy Analyzer nel progetto configurato per Collegamento degli abbonamenti. Crea ed esegui una query personalizzata con i seguenti parametri:

    Parametro 1 Ruolo
    Ruolo Amministratore collegamento abbonamenti

  • Assicurati di usare la chiave del service account corretta per chiamare l'API Subscription Linking. Controlla le seguenti proprietà nella chiave dell'account di servizio (file JSON):

    • type: deve essere service_account.
    • project_id: deve essere l'ID progetto del numero di progetto specificato nella configurazione di Collegamento degli abbonamenti.
    • client_email: deve corrispondere al service account del progetto IAM a cui è stato assegnato il ruolo di Amministratore collegamento abbonamenti.

  • Se hai ottenuto il token di accesso tramite l'endpoint token di Google OAuth 2.0 (https://oauth2.googleapis.com/token), assicurati che il token sia valido e non scaduto quando chiami le API Subscription Linking. Se il token scade, dovrai richiederne uno nuovo.

  • Se usi l'API REST, assicurati di usare l'ID pubblicazione specificato nella configurazione di Collegamento degli abbonamenti. Ad esempio, se il tuo ID pubblicazione è example.com, deve essere presente nell'URL della richiesta.

    • ✅ Usa soltanto l'ID pubblicazione configurato: publications/example.com/readers/10078823/entitlements
    • ❌ Non usare un ID pubblicazione diverso da quello specificato nella configurazione di Collegamento degli abbonamenti: publications/example-staging.com/readers/10078823/entitlements
    • ❌ Non includere il prodotto di pubblicazione nella richiesta: publications/example.com:premium/readers/10078823/entitlements

Errore relativo a un argomento non valido durante l'aggiornamento del diritto

Esempio di errore:

Messaggio Errore: La richiesta contiene un argomento non valido

Per risolvere il problema, verifica quanto segue:

  • Assicurati di specificare l'oggetto entitlements nel formato corretto. Guarda questo esempio.
  • Assicurati che product_id sia nel formato publication_id:product.
    • ✅ Esempio valido: "product_id":"example.com:basic"
    • ❌ Esempio non valido: "product_id":"example.com"

Gli articoli messi in evidenza non vengono mostrati nei risultati di ricerca

Per risolvere il problema, verifica quanto segue: