Руководство разработчика API каталога игр

API каталога приложений Play позволяет сторонним магазинам приложений (3PAS), зарегистрированным в Google Play, запрашивать обновления каталога приложений Google Play. Пользователи могут получать подробную информацию о каталоге для приложений, которые были изменены или удалены с момента последнего ежедневного экспорта каталога.

Полный список конечных точек, методов и схем ресурсов см. в справочнике API Play Catalog .

Прежде чем начать

Прежде чем отправлять запросы к API каталога Play, необходимо выполнить основное руководство по началу работы , чтобы настроить доступ к API, учетные данные сервиса и проект Google Cloud.

Проектирование и архитектура API

Экспорт каталога игр осуществляется каждые 24 часа. API каталога игр предоставляет механизм внутридневного опроса для получения обновлений, произошедших с момента последнего экспорта:

  1. Опрос событий обновления : Вы запрашиваете appstorecatalog.recentUpdateEvents.list с указанием startTime и endTime чтобы узнать, какие имена пакетов были изменены или удалены.
  2. Получение подробных представлений : для каждого измененного имени пакета вызывается appstorecatalog.recentAppViews.get для получения подробных метаданных CatalogAppView .

API предназначен только для чтения и может возвращать только события, произошедшие за последние 36 часов. API имеет ограничение на количество запросов в секунду (QPS) в 2, которое используется обоими методами.

1. Опрос событий обновления каталога.

Чтобы получить список пакетов, изменившихся за определенный промежуток времени, вызовите метод appstorecatalog.recentUpdateEvents.list .

Возвращаются только события обновления для соответствующих приложений. Соответствующие приложения должны быть:

  • Согласились на включение в каталог магазина приложений для звонков.
  • Опубликовано и доступно в США (США) в магазине Google Play.

Понимание типов обновлений

  • MODIFICATION : Запускается при модификации соответствующего приложения, его первой публикации, начале ориентации на рынок США или при добавлении приложения в ваш каталог.
  • DELETION : Эта функция срабатывает, когда приложение снимается с публикации, исключается из каталога, приостанавливается или блокируется, или перестает ориентироваться на рынок США.

2. Получение представлений приложения каталога

Для каждого пакета, возвращенного с событием MODIFICATION , вы можете получить обновленные сведения о нем в каталоге, вызвав метод appstorecatalog.recentAppViews.get .

3. Передовые методы и синхронизация

Для обеспечения согласованности базы данных каталога в вашем магазине следуйте этим рекомендациям по интеграции:

  • Ежедневная синхронизация экспорта : импортируйте полный список подходящих приложений с помощью ежедневного экспорта каталога .
  • (необязательно) Внутридневная синхронизация : Регулярно (например, каждую минуту) опрашивайте конечную точку appstorecatalog.recentUpdateEvents.list с помощью скользящего временного окна. Убедитесь, что вы обрабатываете пагинацию с использованием nextPageToken .
    • Обновления процессов :
      • Для событий MODIFICATION получите обновленный CatalogAppView с помощью appstorecatalog.recentAppViews.get и обновите локальную базу данных.
      • Для событий DELETION удалите приложение из списка товаров в вашем магазине или скройте его от пользователей.
    • Обработка повторяющихся событий модификации : Вы можете увидеть несколько событий MODIFICATION для одного и того же приложения. Это означает, что приложение было изменено несколько раз в течение запрашиваемого временного интервала. appstorecatalog.recentAppViews.get всегда вернет представление приложения с последней модификацией.