Rozwiązywanie problemów

Informacje zawarte w tym dokumencie mogą pomóc Ci w rozwiązywaniu problemów, które możesz napotkać podczas wdrażania łączenia subskrypcji.

Prośba o połączenie subskrypcji zatrzymała się na ekranie wczytywania

Przykład błędu:

Symbol wczytywania

Rysunek 1. Nie można wczytać prośby o połączenie subskrypcji.

Aby rozwiązać ten problem:

  • Pamiętaj, aby w ustawieniach publikacji w Centrum wydawców dodać źródła stron, w tym ich subdomeny testowe, jako dodatkowe adresy URL.
  • W przypadku implementacji Rozszerzonego dostępu lub Menedżera przychodów od czytelników w wersji dla firm dodaj źródła stron, w tym testowanie subdomen, do autoryzowanych źródeł JavaScript klienta OAuth 2.0 skonfigurowanego na potrzeby takiej implementacji. Należy to zrobić w Google Cloud Console.

Nie udało się połączyć konta

Przykład błędu:

Nie udało się połączyć konta

Rysunek 2. Nie udało się połączyć konta.

Aby rozwiązać ten problem:

  • Pamiętaj, aby zaakceptować Warunki korzystania z usługi łączenia subskrypcji w Centrum wydawców. Aby to zrobić, otwórz ustawienia łączenia subskrypcji i kliknij Podpisz warunki korzystania z usługi łączenia subskrypcji.
  • Jeśli konto Google zostało już połączone, przy kolejnej próbie połączenia subskrypcji pojawi się komunikat o błędzie. Zanim powtórzysz test integracji po stronie klienta, musisz odłączyć subskrypcję na stronie subskrypcji na koncie Google.

Błąd uprawnień podczas wywoływania interfejsu Subscription Linking API

Przykład błędu:

Kod 403
przekaz, Odmowa 'readerrevenuesubscriptionlinking.readerEntitlements.update' w zasobie
'//readerrevenuesubscriptionlinking.googleapis.com/publications/example.com/readers/10078823/entitlements' (lub może on nie istnieć)”.

Aby rozwiązać ten problem:

  • Upewnij się, że używasz tego samego projektu określonego w konfiguracji łączenia subskrypcji. Podczas konfigurowania łączenia subskrypcji w Centrum wydawców użyj numeru projektu. Numer projektu znajdziesz w panelu projektu.
  • Sprawdź, czy w projekcie włączony jest interfejs Subscription Linking API.
  • W projekcie Identity and Access Management (IAM) sprawdź, czy konto usługi ma przypisaną rolę Administrator łączenia subskrypcji. Pamiętaj, że propagacja zmian ról w systemie może trochę potrwać. Jeśli podczas wykonywania wywołań interfejsu API pojawi się błąd 403, nawet po sprawdzeniu, czy Twoje konto usługi ma przypisaną prawidłową rolę uprawnień, poczekaj chwilę i spróbuj ponownie przesłać żądanie.

  • Jeśli nie masz pewności, których kont usługi użyć lub czy mają one wymagane role uprawnień, użyj Analizatora zasad z projektu, w którym skonfigurowano łączenie subskrypcji. Utwórz i uruchom niestandardowe zapytanie z tymi parametrami:

    Parametr 1 Rola
    Rola Administrator połączeń subskrypcji

  • Sprawdź, czy podczas wywoływania interfejsu Subscription Linking API używasz prawidłowego klucza konta usługi. Sprawdź te właściwości klucza konta usługi (pliku JSON):

    • type:musi to być konto usługi.
    • project_id: musi to być identyfikator projektu dla numeru projektu określonego w konfiguracji łączenia subskrypcji.
    • client_email: musi to być to samo konto usługi w uprawnieniach projektu, które ma przypisaną rolę administrator łączenia subskrypcji.

  • Jeśli token dostępu został uzyskany za pośrednictwem punktu końcowego tokena Google OAuth 2.0 (https://oauth2.googleapis.com/token), upewnij się, że jest prawidłowy i nie wygasł podczas wywoływania interfejsów Subscription Linking API. Jeśli token wygaśnie, musisz uzyskać nowy.

  • Jeśli korzystasz z interfejsu API typu REST, pamiętaj, aby użyć identyfikatora publikacji podanego w konfiguracji łączenia subskrypcji. Jeśli np. identyfikator publikacji to example.com, URL żądania musi go zawierać.

    • ✅ Użyj tylko skonfigurowanego identyfikatora publikacji: publications/example.com/readers/10078823/entitlements
    • ❌ Nie używaj identyfikatora publikacji innego niż ten określony w konfiguracji łączenia subskrypcji: publications/example-staging.com/readers/10078823/entitlements
    • ❌ Nie umieszczaj w żądaniu usługi publikacji: publications/example.com:premium/readers/10078823/entitlements

Podczas aktualizowania uprawnienia wystąpił błąd nieprawidłowego argumentu

Przykład błędu:

przekaz, Błąd: żądanie zawiera nieprawidłowy argument

Aby rozwiązać ten problem:

  • Obiekt entitlements musi mieć prawidłowy format. Zobacz ten przykład.
  • Upewnij się, że product_id ma format publication_id:product.
    • ✅ Prawidłowy przykład: "product_id":"example.com:basic"
    • ❌ Nieprawidłowy przykład: "product_id":"example.com"

Artykuły nie są wyróżnione w wynikach wyszukiwania

Aby rozwiązać ten problem: