Wymagania dotyczące integracji

Aby wdrożyć funkcję Subskrybuj z Google, musisz wykonać podane niżej czynności, ale w niektórych przypadkach (np. w przypadku konfiguracji witryny lub zaplecza) nie trzeba wdrażać niektórych z nich. W tych wymaganiach dotyczących implementacji termin „Publisher” ma takie samo znaczenie jak „You” (Ty) w Załączniku do Umowy dystrybucyjnej dla deweloperów w Google Play dotyczącym subskrypcji z Google.

  1. Konto dewelopera w Google Play:

    Wydawca musi utworzyć konto dewelopera w Google Play, przesłać aplikację i włączyć w niej płatności. Wydawca musi opublikować aplikację w środowisku produkcyjnym lub użyć istniejącej aplikacji produkcyjnej.

  2. Konfiguracja publikacji: wydawca musi współpracować z przedstawicielami Google ds. rozwiązań technicznych, aby skonfigurować określone punkty konfiguracji, których Google wymaga do skonfigurowania integracji, w tym adresy URL wymaganych punktów końcowych interfejsu API, zasoby logo/marki, szczegóły SKU, adresy URL polityki prywatności i Warunków korzystania z usługi. Konfigurację należy przeprowadzić dla każdej zintegrowanej publikacji.

  3. Znacznik strony: wydawca musi dodać dane strukturalne, które obejmują identyfikator publikacji (odpowiadający identyfikatorowi w konfiguracji publikacji) i etykietę uprawnień. uporządkowane dane muszą się znajdować na wszystkich stronach artykułów, w tym w dokumentach na komputery i urządzenia mobilne;

  4. Integracja klienta swg.js: wydawca musi zintegrować klienta JavaScript Google ze swoją witryną publikacji. Wydawca musi uwzględnić bibliotekę klienta swg.js na wszystkich stronach, na których może zostać włączona blokada dostępu, w tym w artykułach, które są częścią implementacji blokady dostępu po stronie serwera. Musi też wywołać funkcję getEntitlements z biblioteki swg.js i odpowiednio obsłużyć odpowiedź z tej funkcji.

    W zakresie, w jakim wydawca tworzy wersje mobilne swoich stron, a te strony mobilne mogą potencjalnie uruchamiać paywalle, strony mobilne muszą być skonfigurowane z użytkownikiem paywalla mobilnego, który używa uprawnień SwG, aby zachować uprawnienia użytkowników SwG.

  5. Integracja z Androidem: jeśli wydawca sprzedaje różne zestawy kodów SKU na Androida i w internecie lub jeśli ma kilka aplikacji dla tej samej publikacji, musi zaktualizować aplikacje na Androida, aby sprawdzać zakup subskrypcji, a także wywołać interfejs API Subskrybuj z Google Publication i odpowiednio przyznać dostęp.

  6. Zaloguj się przez Google: wydawca musi uwzględnić opcję Zaloguj się przez Google na wszystkich stronach logowania w internecie oraz wdrożyć odpowiednie biblioteki GIS w przypadku aplikacji na iOS i Androida.

    Implementacja funkcji Zaloguj się przez Google musi sprawdzać interfejs API Subskrypcji z Google Publication, aby upewnić się, że jeśli konto Google ma już uprawnienia powiązane z wydawcą, to konto Google jest powiązane z istniejącym kontem użytkownika w witrynie wydawcy. Jeśli interfejs API subskrypcji Google Publication wskazuje, że użytkownik ma uprawnienia, o których wydawca nie wie, wydawca przyzna odpowiedni dostęp znanym użytkownikom. Jeśli jednak użytkownik jest nieznany, wydawca uruchomi proces opóźnionego tworzenia konta.

    Jeśli aplikacja internetowa lub mobilna wydawcy jest całkowicie bezpłatna i nie blokuje dostępu za pomocą płatnego paywalla, logowanie przez Google nie jest wymagane. Dodatkowo w rzadkich przypadkach, gdy wydawca nie prowadzi systemu zarządzania użytkownikami (czyli całkowicie polega na usłudze Subskrybuj z Google do zarządzania transakcjami użytkowników), integracja z Google nie jest wymagana (ani możliwa).

  7. Procesor tworzenia konta po zakupie: wydawca musi utworzyć konta dla użytkowników po dokonaniu zakupu.

    W internecie wydawca musi mieć możliwość przekazania zdarzeń subskrypcji i danych uprawnień swg.js do infrastruktury wydawcy. W przypadku zakupów dokonanych na platformach Google lub w aplikacji wydawca musi obsłużyć opóźnione tworzenie konta. Otrzyma powiadomienia o tworzeniu konta za pomocą Pub/Sub lub interfejsu Publication API.

    Wydawca musi zasubskrybować zdarzenia Play Cloud lub Reader Revenue Pub/Sub w ramach infrastruktury wydawcy.

    Aby zażądać danych profilu użytkownika i subskrypcji z interfejsu API stanu subskrypcji Google, wydawca musi użyć danych o zakupach z zdarzeń subskrypcji. Po uzyskaniu tych danych interfejs API zarządzania kontem musi:

    1. utworzyć konto z informacjami z profilu użytkownika otrzymanymi od Google i powiązać z nim subskrypcję;
    2. dołącz profil użytkownika Google i dane subskrypcji do istniejącego konta użytkownika w witrynie wydawcy.

    Jeśli wydawca nie prowadzi systemu zarządzania użytkownikami (czyli całkowicie polega na usłudze Subskrybuj z Google do zarządzania transakcjami użytkowników), nie jest konieczne (ani możliwe) utworzenie konta po zakupie.

  8. Integracja z iOS: jeśli wydawca ma treści płatne powiązane z subskrypcją Google SKU w aplikacji na iOS, po użyciu logowania Google wydawca musi sprawdzić backend pod kątem uprawnień. Jeśli nie znajdzie żadnych uprawnień, musi wywołać interfejs API subskrypcji Google Publication, aby sprawdzić uprawnienia i w razie potrzeby przyznać dostęp.

  9. Łączenie subskrypcji: na końcu dowolnego procesu zakupu nieprzetwarzanego za pomocą funkcji Subskrybuj z Google wydawca musi zintegrować funkcję łączenia subskrypcji, aby umożliwić użytkownikom połączenie ich konta Google. Aby wdrożyć łączenie subskrypcji, wydawcy muszą utworzyć projekt Google Cloud.

  10. Wymagania dla wydawców z Niemiec – wydawcy z Niemiec muszą:

    1. Umieścić zrozumiały i czytelny przycisk anulowania w każdej chwili dostępny na ich stronie dla subskrybentów w Niemczech z tekstem „Anuluj umowy” [„Verträge hier kündigen”] lub jego odpowiednikiem.
    2. Kierować treści na użytkowników w Niemczech, którzy zasubskrybowali ich publikację za pomocą funkcji Subskrybuj za pomocą Google, i kliknąć przycisk anulowania, aby przejść na stronę https://support.google.com/googleplay/contact/cancel_sub_request i poprosić o anulowanie subskrypcji.
    3. Odpowiadaj subskrybentom, którzy nieprawidłowo próbują anulować subskrypcję zakupioną za pomocą usługi Subskrybuj z Google, przesyłając jasne i jednoznaczne oświadczenie informujące subskrybenta, że powinien odwiedzić stronę https://support.google.com/googleplay/contact/cancel_sub_request, aby anulować umowę zakupioną za pomocą usługi Subskrybuj z Google.