Hướng dẫn cho nhà phát triển Play Catalog API

Play Catalog API cho phép các cửa hàng ứng dụng bên thứ ba (3PAS) đã đăng ký trên Google Play thăm dò các bản cập nhật cho danh mục ứng dụng của Google Play. Phương thức gọi có thể truy xuất thông tin chi tiết về danh mục cho những ứng dụng đã được sửa đổi hoặc xoá kể từ lần xuất danh mục hằng ngày gần nhất.

Để xem danh sách đầy đủ các điểm cuối, phương thức và giản đồ tài nguyên, hãy xem Tài liệu tham khảo về Play Catalog API.

Trước khi bắt đầu

Bạn phải hoàn thành Hướng dẫn bắt đầu chính để thiết lập quyền truy cập API, thông tin xác thực dịch vụ và dự án Google Cloud trước khi có thể thực hiện lệnh gọi đến Play Catalog API.

Thiết kế và cấu trúc API

Báo cáo xuất Danh mục trên Play được tạo mỗi 24 giờ. Play Catalog API cung cấp một cơ chế thăm dò trong ngày để truy xuất các bản cập nhật xảy ra kể từ lần xuất gần đây nhất:

  1. Bỏ phiếu cho các sự kiện cập nhật: Bạn truy vấn appstorecatalog.recentUpdateEvents.list bằng cửa sổ startTime và endTime để tìm tên gói đã được sửa đổi hoặc xoá.
  2. Tìm nạp chế độ xem chi tiết: Đối với mỗi tên gói đã được sửa đổi, bạn gọi appstorecatalog.recentAppViews.get để tìm nạp siêu dữ liệu chi tiết CatalogAppView.

API này chỉ có thể đọc và chỉ được phép trả về những sự kiện đã xảy ra trong 36 giờ qua. API có giới hạn QPS là 2 được chia sẻ giữa cả hai phương thức.

1. Bỏ phiếu cho các sự kiện cập nhật danh mục

Để truy xuất danh sách các gói đã thay đổi trong một khoảng thời gian cụ thể, hãy gọi phương thức appstorecatalog.recentUpdateEvents.list.

Chỉ những sự kiện cập nhật cho các ứng dụng đủ điều kiện mới được trả về. Ứng dụng đủ điều kiện phải:

  • Chọn đưa vào danh mục cho cửa hàng ứng dụng gọi.
  • Đã xuất bản và có mặt tại Hoa Kỳ trên Cửa hàng Google Play.

Tìm hiểu về các loại nội dung cập nhật

  • MODIFICATION: Kích hoạt khi một ứng dụng đủ điều kiện được sửa đổi, xuất bản lần đầu, bắt đầu nhắm đến Hoa Kỳ hoặc khi ứng dụng mới chọn tham gia danh mục của bạn.
  • DELETION: Kích hoạt khi một ứng dụng bị huỷ xuất bản, chọn không tham gia đưa vào danh mục, bị tạm ngưng hoặc bị chặn, hoặc ngừng nhắm đến Hoa Kỳ.

2. Truy xuất các khung hiển thị ứng dụng trong danh mục

Đối với mỗi gói được trả về bằng sự kiện MODIFICATION, bạn có thể tìm nạp thông tin chi tiết mới nhất về danh mục của gói đó bằng cách gọi phương thức appstorecatalog.recentAppViews.get.

3. Các phương pháp hay nhất và đồng bộ hoá

Để duy trì cơ sở dữ liệu danh mục nhất quán trên cửa hàng của bạn, hãy làm theo các nguyên tắc tích hợp sau:

  • Đồng bộ hoá dữ liệu xuất hằng ngày: Nhập toàn bộ danh sách ứng dụng đủ điều kiện bằng cách sử dụng tính năng xuất danh mục hằng ngày.
  • (không bắt buộc) Đồng bộ hoá trong ngày: Thường xuyên thăm dò điểm cuối appstorecatalog.recentUpdateEvents.list (ví dụ: mỗi phút) bằng một khung thời gian di chuyển. Đảm bảo bạn xử lý việc phân trang bằng cách sử dụng nextPageToken.
    • Thông tin cập nhật về quy trình:
      • Đối với các sự kiện MODIFICATION, hãy tìm nạp CatalogAppView đã cập nhật bằng cách sử dụng appstorecatalog.recentAppViews.get và cập nhật cơ sở dữ liệu cục bộ.
      • Đối với các sự kiện DELETION, hãy xoá ứng dụng khỏi trang thông tin của cửa hàng hoặc ẩn ứng dụng khỏi người dùng.
    • Xử lý các sự kiện sửa đổi lặp lại: Bạn có thể thấy nhiều sự kiện SỬA ĐỔI cho cùng một ứng dụng. Điều này có nghĩa là ứng dụng đã được sửa đổi nhiều lần trong khung thời gian được truy vấn. appstorecatalog.recentAppViews.get sẽ luôn trả về chế độ xem ứng dụng của nội dung sửa đổi gần đây nhất.