Google Play Catalog API를 사용하면 Google Play에 등록된 서드 파티 앱 스토어(3PAS)가 Google Play 앱 카탈로그의 업데이트를 폴링할 수 있습니다. 호출자는 마지막 일일 카탈로그 내보내기 이후 수정 또는 삭제된 앱의 카탈로그 세부정보를 가져올 수 있습니다.
엔드포인트, 메서드, 리소스 스키마의 전체 목록은 Google Play Catalog API 참조를 참고하세요.
시작하기 전에
Google Play Catalog API를 호출하려면 먼저 기본 시작 가이드를 완료하여 API 액세스, 서비스 사용자 인증 정보, Google Cloud 프로젝트를 설정해야 합니다.
API 설계 및 아키텍처
Google Play 카탈로그 내보내기는 24시간마다 생성됩니다. Google Play Catalog API는 마지막 내보내기 이후 발생한 업데이트를 가져오는 일중 폴링 메커니즘을 제공합니다.
- 업데이트 이벤트 폴링:
startTime및endTime구간으로appstorecatalog.recentUpdateEvents.list를 쿼리하여 수정되거나 삭제된 패키지 이름을 찾습니다. - 세부정보 보기 가져오기: 수정된 패키지 이름마다
appstorecatalog.recentAppViews.get을 호출하여 상세한CatalogAppView메타데이터를 가져옵니다.
API는 읽기 전용이며 지난 36시간 동안 발생한 이벤트만 반환하도록 제한됩니다. API에는 두 메서드 간에 공유되는 QPS 한도가 2개 있습니다.
1. 카탈로그 업데이트 이벤트 폴링
특정 시간 구간에서 변경된 패키지 목록을 가져오려면
appstorecatalog.recentUpdateEvents.list
메서드를 호출합니다.
요건을 충족하는 앱의 업데이트 이벤트만 반환됩니다. 앱이 충족해야 하는 요건은 다음과 같습니다.
- 호출 앱 스토어에 대해 카탈로그 포함을 선택했습니다.
- 미국(US) Google Play 스토어에 게시되어 제공되고 있습니다.
업데이트 유형 이해하기
MODIFICATION: 자격 요건을 충족하는 앱이 수정되거나, 처음 게시되거나, 미국을 타겟팅하기 시작하거나, 앱이 카탈로그를 새로 선택한 경우에 트리거됩니다.DELETION: 앱이 게시 취소되거나, 카탈로그 포함의 선택이 해제되거나, 정지 또는 차단되거나, 미국 타겟팅을 중지하는 경우에 트리거됩니다.
2. 카탈로그 앱 조회수 가져오기
MODIFICATION 이벤트와 함께 반환된 각 패키지의 경우 appstorecatalog.recentAppViews.get 메서드를 호출하여
업데이트된 카탈로그 세부정보를 가져올 수
있습니다.
3. 권장사항 및 동기화
스토어에서 일관된 카탈로그 데이터베이스를 유지하려면 다음 통합 가이드라인을 따르세요.
- 일일 내보내기 동기화: 일일 카탈로그 내보내기를 사용하여 자격 요건을 충족하는 앱의 전체 목록을 가져옵니다.
- (선택 사항) 일중 동기화: 가변적인 시간 구간을 사용하여
appstorecatalog.recentUpdateEvents.list엔드포인트를 정기적으로(예: 1분마다) 폴링합니다.nextPageToken을 사용하여 페이지로 나누기를 처리해야 합니다.- 업데이트 처리:
MODIFICATION이벤트의 경우appstorecatalog.recentAppViews.get을 사용하여 업데이트된CatalogAppView를 가져오고 로컬 데이터베이스를 업데이트합니다.DELETION이벤트의 경우 스토어 등록정보에서 앱을 삭제하거나 사용자에게서 숨깁니다.
- 반복되는 수정 이벤트 처리: 동일한 앱에 대해 여러 개
MODIFICATION 이벤트가 표시될 수 있습니다. 이는 앱이 쿼리된 시간 구간 동안
여러 번 수정되었음을 의미합니다.
appstorecatalog.recentAppViews.get은 항상 최신 수정 사항에 대한 앱 보기를 반환합니다.
- 업데이트 처리: