Informacje zawarte w tym dokumencie mogą pomóc w rozwiązywaniu problemów, które mogą wystąpić podczas wdrażania linkowania subskrypcji.
Prośba o połączenie subskrypcji utknęła na ekranie wczytywania
Przykład błędu:
Rysunek 1. Nie wczytuje się prompt łączenia subskrypcji.
Aby rozwiązać ten problem, sprawdź te kwestie:
- Pamiętaj, aby w ustawieniach publikacji w Centrum wydawców dodać źródła stron, w tym subdomeny testowe, jako dodatkowe adresy URL.
- Upewnij się, że stan adresu URL to „Zweryfikowano”, a nie „Weryfikuję”.
- W przypadku implementacji Rozszerzonego dostępu lub Reader Revenue Managera Enterprise dodaj źródła stron, w tym subdomeny testowe, do autoryzowanych źródeł JavaScript klienta OAuth 2.0 skonfigurowanego pod kątem takiej implementacji. Musisz to zrobić w konsoli Google Cloud.
Nie udało się połączyć konta
Przykład błędu:
Rysunek 2. Problem z niemożliwością połączenia konta.
Aby rozwiązać ten problem, sprawdź te kwestie:
- W Centrum wydawców zaakceptuj Warunki korzystania z usługi łączenia subskrypcji. Aby to zrobić, otwórz ustawienia Łączenie subskrypcji i kliknij Zaakceptuj warunki korzystania z funkcji łączenia subskrypcji.
- Jeśli konto Google jest już połączone, podczas ponownej próby 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
|
| Wiadomość | 'readerrevenuesubscriptionlinking.readerEntitlements.update'
odmówiono dostępu do zasobu |
Aby rozwiązać ten problem, sprawdź te kwestie:
- Upewnij się, że używasz tego samego projektu, który został określony w sekcji Konfiguracja łączenia subskrypcji. Podczas konfigurowania łączenia subskrypcji w Centrum wydawców użyj numeru projektu. Numer projektu znajdziesz w panelu projektu.
- Sprawdź, czy w projekcie jest włączony 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 rozpowszechnienie zmian roli w systemie może zająć trochę czasu. Jeśli podczas wykonywania wywołań interfejsu API pojawi się błąd 403, mimo że Twoje konto usługi ma prawidłową rolę uprawnień, odczekaj kilka chwil i spróbuj ponownie wysłać żądanie.
Jeśli nie masz pewności, których kont usługi użyć ani czy mają one wymaganą rolę uprawnień, użyj analizatora zasad z projektu, w którym skonfigurowano łączenie subskrypcji. Utwórz i wykonaj zapytanie niestandardowe z tymi parametrami zapytania:
Parametr 1 Rola Rola Administrator połączeń subskrypcji Pamiętaj, aby podczas wywoływania interfejsu Subscription Linking API używać prawidłowego klucza konta usługi. Sprawdź te właściwości w kluczu konta usługi (pliku JSON):
- type: musi to być service_account.
- project_id: musi być identyfikatorem projektu 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 pomocą punktu końcowego tokenu OAuth 2.0 Google (https://oauth2.googleapis.com/token), upewnij się, że token jest prawidłowy i nie wygasł w momencie wywołania interfejsów Subscription Linking API. Jeśli token wygaśnie, musisz uzyskać nowy.
Jeśli korzystasz z interfejsu REST API, upewnij się, że używasz identyfikatora publikacji podanego w ramach konfiguracji łączenia subskrypcji. Jeśli na przykład identyfikator publikacji to
example.com, adres URL żądania musi go zawierać.- ✅ Użyj tylko skonfigurowanego identyfikatora publikacji:
publications/example.com/readers/10078823/entitlements - ❌ Nie używaj identyfikatora publikacji innego niż podany w konfiguracji łączenia subskrypcji:
publications/example-staging.com/readers/10078823/entitlements - ❌ Nie uwzględniaj w prośbie usługi publikacji:
publications/example.com:premium/readers/10078823/entitlements
- ✅ Użyj tylko skonfigurowanego identyfikatora publikacji:
Błąd nieprawidłowego argumentu podczas aktualizowania uprawnienia
Przykład błędu:
| Wiadomość | Błąd: żądanie zawiera nieprawidłowy argument |
Aby rozwiązać ten problem, sprawdź te kwestie:
- Upewnij się, że obiekt
entitlementsma prawidłowy format. Zobacz ten przykład. - Sprawdź, czy
product_idma formatpublication_id:product.- ✅ Przykład prawidłowej wartości:
"product_id":"example.com:basic" - ❌ Przykład nieprawidłowy:
"product_id":"example.com"
- ✅ Przykład prawidłowej wartości:
Nie wyświetlają się artykuły wyróżnione w wynikach wyszukiwania
Aby rozwiązać ten problem, sprawdź te kwestie:
- Dodaj dane strukturalne do wszystkich artykułów. Aby sprawdzić uporządkowane dane, użyj testu wyników z elementami rozszerzonymi.
- Upewnij się, że w uporządkowanych danych umieścisz prawidłowy element
productID, który odpowiada zestawowi identyfikatorów produktów, których używasz do aktualizowania uprawnień czytelnika. - Aby sprawdzić, czy występują jakieś problemy z Twoimi danymi strukturalnymi, skorzystaj z raportu o wynikach z elementami rozszerzonymi dotyczącego „subskrybowanych treści” w Search Console.
Nie można zmienić języka wezwania do działania w wiadomości dotyczącej łączenia subskrypcji
Język wezwania do działania dotyczącego łączenia subskrypcji jest określany przez ustawienia użytkownika. Nie można go zastąpić globalnie.
Język jest określany w ten sposób:
Jeśli użytkownik jest zalogowany na swoje konto Google, używany jest język podstawowy ustawiony w ustawieniach konta Google (https://myaccount.google.com/language).
Jeśli użytkownik nie jest zalogowany, język jest wybierany na podstawie ustawień języka w przeglądarce lub systemie operacyjnym.
Wezwania do działania dotyczące łączenia subskrypcji nie są obsługiwane we wszystkich językach. Jeśli język główny użytkownika nie jest obsługiwany, przycisk wezwania do działania może domyślnie wyświetlać angielski.
##