Problemen oplossen

Met de informatie in dit document kun je problemen oplossen die je misschien tegenkomt wanneer je Abonnementen koppelen implementeert.

Tip: Open de JavaScript-console en zoek naar foutmeldingen van de swg.js-clientbibliotheek. Zo kun je mogelijke problemen in je implementatie identificeren.

De prompt om abonnementen te koppelen blijft hangen op het laadscherm

Voorbeeld van een fout:

Afbeelding 1. De prompt om abonnementen te koppelen laadt niet.

Controleer het volgende om dit probleem op te lossen:

• Zorg dat je de bronnen van de pagina's (inclusief subdomeinen die getest moeten worden) als extra URL's toevoegt in de publicatie-instellingen van het Publisher Center.
• Voor implementaties van Uitgebreide toegang of Reader Revenue Manager Enterprise moet je de bronnen van de pagina's (inclusief subdomeinen die getest moeten worden) toevoegen aan de geautoriseerde JavaScript-bronnen van de OAuth 2.0-client die je voor een dergelijke implementatie hebt geconfigureerd. Dit doe je in de Google Cloud Console.

Opmerking: Als je de bronnen onlangs hebt toegevoegd, kan het tot een uur duren voordat dergelijke bronnen toegang krijgen tot de swg.js-clientbibliotheek.

Account kon niet gekoppeld worden

Voorbeeld van een fout:

Afbeelding 2. Probleem met account dat niet gekoppeld kon worden

Controleer het volgende om dit probleem op te lossen:

• Zorg dat je de Servicevoorwaarden voor het koppelen van abonnementen accepteert in het Uitgeverscentrum. Ga hiervoor naar de instellingen van Abonnementen koppelen en klik op Teken de servicevoorwaarden voor het koppelen van abonnementen.
• Als het Google-account al gekoppeld is, krijg je een foutmelding als je het abonnement opnieuw probeert te koppelen. Je moet het abonnement ontkoppelen via de abonnementenpagina in het Google-account, voordat je de integratietest aan de clientzijde herhaalt.

Fout vanwege rechten bij het aanroepen van de Subscription Linking API

Voorbeeld van een fout:

Code	403
Bericht	'readerrevenuesubscriptionlinking.readerEntitlements.update' geweigerd op bron '//readerrevenuesubscriptionlinking.googleapis.com/publications/example.com/readers/10078823/entitlements' (of deze bestaat misschien niet).'

Controleer het volgende om dit probleem op te lossen:

• Zorg ervoor dat je hetzelfde project gebruikt als aangegeven in de configuratie van je abonnementskoppeling. Gebruik het projectnummer bij het instellen van je abonnementskoppeling in het Publisher Center. Je vindt het projectnummer in je projectdashboard.
• Zorg dat de Subscription Linking API aanstaat in je project.
• Zorg er in het project Identity and Access Management (IAM) voor dat het serviceaccount is toegekend met de rol van beheerder van de abonnementskoppeling. Houd er rekening mee dat het even kan duren voordat de rolverandering door het systeem is uitgevoerd. Als je een 403-foutmelding krijgt bij het uitvoeren van API-aanroepen, zelfs nadat je hebt bevestigd dat je serviceaccount de juiste IAM-rol heeft, wacht dan even en probeer je verzoek opnieuw.

• Als je niet zeker weet welke serviceaccounts je moet gebruiken en of ze de vereiste IAM-rol hebben, gebruik dan de Policy Analyzer van het project dat je hebt ingesteld voor de abonnementskoppeling. Maak een aangepaste query en voer deze uit met de volgende queryparameters:

  Parameter 1	Rol
  Rol	Beheerder van de abonnementskoppeling

• Zorg ervoor dat je de juiste sleutel van het serviceaccount gebruikt wanneer je de Subscription Linking API aanroept. Inspecteer de volgende property's in de sleutel van je serviceaccount (json-bestand):

  • type: dit moet service_account zijn.
  • project_id: dit moet het project-ID of het projectnummer zijn dat is ingevoerd bij de configuratie van de abonnementskoppeling.
    Opmerking: project-ID en projectnummer zijn 2 verschillende ID's die je vindt op je projectdashboard.
  • client_email: dit moet hetzelfde serviceaccount zijn in project IAM dat is toegewezen met de rol beheerder van de abonnementskoppeling.

• Als je het toegangstoken hebt verkregen via het eindpunt Google OAuth 2.0-token (https://oauth2.googleapis.com/token), zorg er dan voor dat het token geldig is en niet verlopen is wanneer je de Subscription Linking API's aanroept. Als het token verloopt, moet je een nieuwe aanvragen.

• Als je de REST API gebruikt, gebruik dan de Publicatie-ID die je hebt ingevuld in de configuratie voor Abonnementen koppelen. Als je Publicatie-ID bijvoorbeeld example.com is, dan moet de verzoek-URL deze bevatten.

  • ✅ Gebruik alleen de geconfigureerde Publicatie-ID: publications/example.com/readers/10078823/entitlements
  • ❌ Gebruik geen andere Publicatie-ID dan degene die je hebt ingevuld bij de configuratie voor Abonnementen koppelen:publications/example-staging.com/readers/10078823/entitlements
  • ❌ Neem het publicatieproduct niet op in het verzoek: publications/example.com:premium/readers/10078823/entitlements

Opmerking: Het kan enkele minuten of langer duren voordat de toestemmingswijziging in IAM van kracht wordt. Bekijk voor meer informatie Uitvoering van toegangsverandering.

Fout vanwege ongeldig argument bij het updaten van het toegangsrecht

Voorbeeld van een fout:

Bericht

Verzoek bevat een ongeldig argument

Controleer het volgende om dit probleem op te lossen:

• Zorg dat je het entitlements-object in de juiste indeling levert. Bekijk dit voorbeeld.
• Zorg dat product_id de indeling publication_id:product heeft.
  • ✅ Geldig voorbeeld: "product_id":"example.com:basic"
  • ❌ Ongeldig voorbeeld: "product_id":"example.com"

Artikelen worden niet gemarkeerd in de zoekresultaten

Controleer het volgende om dit probleem op te lossen:

• Zorg dat je de gestructureerde gegevens toevoegt aan al je artikelen. Gebruik de test voor uitgebreide resultaten om je gestructureerde gegevens te valideren.
• Zorg dat je een geldige productID in de gestructureerde gegevens zet die overeenkomt met een reeks product-ID's die je gebruikt om de toegangsrechten van de lezer te updaten.
• Gebruik een rapport met uitgebreide resultaten voor geabonneerde content in Search Console om eventuele problemen met betrekking tot je gestructureerde gegevens te bekijken.

Opmerking: Er gelden rangschikkingsfactoren wanneer we de functie Op basis van je abonnementen weergeven. Dit betekent dat het niet altijd zeker is dat je je nieuwsartikel ziet voor een bepaalde zoekterm.