Fehlerbehebung

Die Informationen in diesem Dokument können dir bei der Behebung von Problemen helfen, die du bei der Implementierung der Aboverknüpfung haben könntest.

Aufforderung zur Aboverknüpfung hängt auf dem Ladebildschirm

Fehlerbeispiel:

Ladesymbol

Abbildung 1: Die Aufforderung zur Aboverknüpfung wird nicht geladen.

So behebst du das Problem:

  • Achte darauf, die Quellen der Seiten, einschließlich Test-Subdomains, in den Einstellungen der Publikation im Publisher Center als zusätzliche URLs hinzuzufügen.
  • Bei Implementierungen des erweiterten Zugriffs oder Reader Revenue Manager Enterprise-Implementierungen solltest du darauf achten, die Quellen der Seiten, einschließlich Test-Subdomains, den autorisierten JavaScript-Quellen des OAuth 2.0-Clients hinzuzufügen, den du für die Implementierung konfiguriert hast. Dazu musst du die Google Cloud Console verwenden.

Das Konto konnte nicht verknüpft werden

Fehlerbeispiel:

Das Konto konnte nicht verknüpft werden

Abbildung 2: Problem: Das Konto konnte nicht verknüpft werden.

So behebst du das Problem:

  • Achte darauf, dass du die Nutzungsbedingungen für die Aboverknüpfung im Publisher Center akzeptiert hast. Rufe dazu die Einstellungen der Aboverknüpfung auf und klicke auf Nutzungsbedingungen für die Aboverknüpfung akzeptieren.
  • Wurde das Google-Konto bereits verknüpft, erhältst du beim wiederholten Versuch, das Abo zu verknüpfen, eine Fehlermeldung. Du musst erst die Verknüpfung des Abos auf der Aboseite im Google-Konto aufheben, bevor du den Integrationstest clientseitig wiederholen kannst.

Berechtigungsfehler beim Abrufen der Subscription Linking API

Fehlerbeispiel:

Code 403
Nachricht 'readerrevenuesubscriptionlinking.readerEntitlements.update' wurde für die Ressource
'//readerrevenuesubscriptionlinking.googleapis.com/publications/example.com/readers/10078823/entitlements' verweigert (oder ist möglicherweise nicht vorhanden).“

So behebst du das Problem:

  • Achte darauf, dass du das in der Aboverknüpfung angegebene Projekt verwendest. Verwende die Projektnummer bei der Einrichtung der Aboverknüpfung im Publisher Center. Die Projektnummer findest du im Dashboard des Projekts.
  • Achte darauf, dass die Subscription Linking API in deinem Projekt aktiviert ist.
  • Achte darauf, dass dem Dienstkonto in der Identitäts- und Zugriffsverwaltung (IAM) des Projekts die Rolle Administrator von Aboverknüpfungen zugewiesen wurde. Es kann eine Weile dauern, bis die Rollenänderungen im System übernommen werden. Sollte bei API-Aufrufen ein 403-Fehler auftreten, nachdem du die korrekte IAM-Rolle des Dienstkontos bestätigt hast, warte einige Momente und versuche es dann erneut.

  • Wenn du dir nicht sicher bist, welche Dienstkonten du verwenden solltest oder ob diese über die erforderliche IAM-Rolle verfügen, verwende den Policy Analyzer aus dem Projekt, das du für die Aboverknüpfung eingerichtet hast. Erstelle eine benutzerdefinierte Abfrage mit den folgenden Suchparametern und führe sie aus:

    Parameter 1 Rolle
    Rolle Administrator von Aboverknüpfungen

  • Achte darauf, dass du beim Abrufen der Subscription Linking API den korrekten Dienstkontoschlüssel verwendest. Sieh dir die folgenden Attribute deines Dienstkontoschlüssels (JSON-Datei) an:

    • type: Muss „service_account“ sein.
    • project_id: Muss die Projekt-ID der Projektnummer sein, die bei der Einrichtung der Aboverknüpfung angegeben wurde.
    • client_email: Muss dasselbe Dienstkonto im IAM des Projekts sein, dem die Rolle Administrator von Aboverknüpfungen zugewiesen wurde.

  • Wenn du das Zugriffstoken durch den Google OAuth 2.0-Token-Endpunkt (https://oauth2.googleapis.com/token) erhalten hast, stelle sicher, dass das Token noch gültig ist, wenn du Subscription Linking APIs abrufst. Wenn das Token abläuft, musst du ein neues Token abrufen.

  • Wenn du die REST API verwendest, achte darauf, dass du die Publikations-ID nutzt, die du bei der Einrichtung der Aboverknüpfung angegeben hast. Beispiel: Wenn deine Publikations-ID example.com lautet, muss die Anfrage-URL diesen Wert enthalten.

    • ✅ Nutze nur die konfigurierte Publikations-ID: publications/example.com/readers/10078823/entitlements
    • ❌ Nutze keine andere Publikations-ID außer der ID, die in der Konfiguration der Aboverknüpfung angegeben wurde: publications/example-staging.com/readers/10078823/entitlements
    • ❌ Die Anfrage darf das Publikationsprodukt nicht enthalten: publications/example.com:premium/readers/10078823/entitlements

Fehler „Ungültiges Argument“ beim Aktualisieren der Berechtigung

Fehlerbeispiel:

Nachricht Fehler: Anfrage enthält ungültiges Argument

So behebst du das Problem:

  • Achte darauf, dass das entitlements-Objekt im richtigen Format angegeben ist. Siehe dieses Beispiel.
  • Achte darauf, dass product_id das Format publication_id:product hat.
    • ✅ Gültiges Beispiel: "product_id":"example.com:basic"
    • ❌ Ungültiges Beispiel: "product_id":"example.com"

In den Suchergebnissen werden keine Artikel hervorgehoben

So behebst du das Problem: