Przewodnik dla programistów po interfejsie Play Catalog API

Interfejs Play Catalog API umożliwia sklepom innych firm z aplikacjami zarejestrowanym w Google Play sprawdzanie, czy w katalogu aplikacji Google Play pojawiły się aktualizacje. Elementy wywołujące mogą pobierać szczegóły katalogu aplikacji, które zostały zmodyfikowane lub usunięte od czasu ostatniego codziennego eksportu katalogu.

Pełną listę punktów końcowych, metod i schematów zasobów znajdziesz w dokumentacji interfejsu Play Catalog API.

Zanim zaczniesz

Zanim zaczniesz wywoływać interfejs Play Catalog API, musisz wykonać czynności opisane w głównym przewodniku dla początkujących, aby skonfigurować dostęp do interfejsu API, dane logowania usługi i projekt Google Cloud.

Projektowanie i architektura interfejsów API

Eksport Katalogu Google Play jest generowany co 24 godziny. Interfejs Play Catalog API udostępnia mechanizm odpytywania w ciągu dnia, który umożliwia pobieranie aktualizacji, które nastąpiły od czasu ostatniego eksportu:

  1. Sprawdzanie zdarzeń aktualizacji: wysyłasz zapytanie do interfejsu API appstorecatalog.recentUpdateEvents.list z określonymi parametrami startTime i endTime, aby sprawdzić, które nazwy pakietów zostały zmodyfikowane lub usunięte.
  2. Pobierz widoki szczegółowe: w przypadku każdej zmodyfikowanej nazwy pakietu wywołujesz funkcję appstorecatalog.recentAppViews.get, aby pobrać szczegółowe metadane CatalogAppView.

Interfejs API jest dostępny tylko do odczytu i może zwracać tylko zdarzenia, które miały miejsce w ciągu ostatnich 36 godzin. Interfejs API ma limit zapytań na sekundę wynoszący 2, który jest wspólny dla obu metod.

1. Sprawdzanie zdarzeń aktualizacji katalogu

Aby pobrać listę pakietów, które uległy zmianie w określonym przedziale czasu, wywołaj metodę appstorecatalog.recentUpdateEvents.list.

Zwracane są tylko zdarzenia aktualizacji kwalifikujących się aplikacji. Uprawnione aplikacje muszą:

  • Wyrażono zgodę na uwzględnienie w katalogu sklepu z aplikacjami do dzwonienia.
  • Opublikowana i dostępna w Stanach Zjednoczonych w Sklepie Google Play.

Rodzaje aktualizacji

  • MODIFICATION: wywoływane, gdy kwalifikująca się aplikacja zostanie zmodyfikowana, opublikowana po raz pierwszy, zacznie być kierowana na Stany Zjednoczone lub gdy aplikacja zostanie nowo dodana do Twojego katalogu.
  • DELETION: wywoływany, gdy aplikacja zostanie wycofana z publikacji, zrezygnuje z udziału w katalogu, zostanie zawieszona lub zablokowana albo przestanie kierować reklamy na Stany Zjednoczone.

2. Pobieranie wyświetleń aplikacji w katalogu

W przypadku każdego pakietu zwróconego ze zdarzeniem MODIFICATION możesz pobrać jego zaktualizowane szczegóły katalogu, wywołując metodę appstorecatalog.recentAppViews.get.

3. Sprawdzone metody i synchronizacja

Aby zachować spójną bazę danych katalogu w swoim sklepie, postępuj zgodnie z tymi wytycznymi dotyczącymi integracji:

  • Codzienna synchronizacja eksportu: importuj pełną listę kwalifikujących się aplikacji za pomocą codziennego eksportu katalogu.
  • (opcjonalnie) Synchronizacja w ciągu dnia: regularnie (np. co minutę) wysyłaj zapytania do punktu końcowego appstorecatalog.recentUpdateEvents.list z przesuwanym oknem czasowym. Upewnij się, że stronicowanie jest obsługiwane za pomocą parametru nextPageToken.
    • Aktualizacje procesu:
      • W przypadku zdarzeń MODIFICATION pobierz zaktualizowany element CatalogAppView za pomocą funkcji appstorecatalog.recentAppViews.get i zaktualizuj lokalną bazę danych.
      • W przypadku DELETION usuń aplikację z list w sklepie lub ukryj ją przed użytkownikami.
    • Obsługa powtarzających się zdarzeń modyfikacji: możesz zobaczyć wiele zdarzeń MODIFICATION dotyczących tej samej aplikacji. Oznacza to, że w okresie, którego dotyczy zapytanie, aplikacja była modyfikowana wielokrotnie. appstorecatalog.recentAppViews.get zawsze zwraca widok aplikacji z najnowszą modyfikacją.