Play Catalog API Geliştirici Kılavuzu

.

Play Catalog API, Google Play'e kayıtlı üçüncü taraf uygulama mağazalarının (3PAS) Google Play uygulama kataloğundaki güncellemeleri sorgulamasına olanak tanır. Arayanlar, son günlük katalog dışa aktarma işleminden sonra değiştirilen veya kaldırılan uygulamaların katalog ayrıntılarını alabilir.

Uç noktaların, yöntemlerin ve kaynak şemalarının tam listesi için Play Catalog API Referansı'na bakın.

Başlamadan Önce

Play Catalog API'ye çağrı yapabilmeniz için API erişiminizi, hizmet kimlik bilgilerinizi ve Google Cloud projenizi ayarlamak üzere ana Başlangıç Kılavuzu'nu tamamlamanız gerekir.

API Tasarımı ve Mimarisi

Play Kataloğu dışa aktarma işlemi 24 saatte bir oluşturulur. Play Catalog API, son dışa aktarma işleminden bu yana gerçekleşen güncellemeleri almak için gün içi yoklama mekanizması sağlar:

  1. Güncelleme etkinlikleri için yoklama: Hangi paket adlarının değiştirildiğini veya silindiğini bulmak için appstorecatalog.recentUpdateEvents.list ile startTime ve endTime aralığında sorgu gönderirsiniz.
  2. Ayrıntılı görünümleri getirme: Değiştirilen her paket adı için appstorecatalog.recentAppViews.get çağrısı yaparak ayrıntılı CatalogAppView meta verilerini getirirsiniz.

API salt okunurdur ve yalnızca son 36 saat içinde gerçekleşen etkinlikleri döndürmekle sınırlıdır. API'nin, her iki yöntem arasında paylaşılan 2 QPS sınırı vardır.

1. Katalog güncelleme etkinlikleri için yoklama

Belirli bir zaman aralığında değişen paketlerin listesini almak için appstorecatalog.recentUpdateEvents.list yöntemini çağırın.

Yalnızca uygun uygulamalar için güncelleme etkinlikleri döndürülür. Uygun uygulamalar şu özelliklere sahip olmalıdır:

  • Arama uygulama mağazası için katalog eklemeyi etkinleştirmiş olmanız gerekir.
  • Google Play Store'da yayınlanmış ve ABD'de kullanıma sunulmuş olmalıdır.

Güncelleme Türlerini Anlama

  • MODIFICATION: Uygun bir uygulama değiştirildiğinde, ilk kez yayınlandığında, ABD'yi hedeflemeye başladığında veya kataloğunuza yeni eklendiğinde tetiklenir.
  • DELETION: Bir uygulamanın yayından kaldırılması, katalogda yer almayı devre dışı bırakması, askıya alınması veya engellenmesi ya da ABD'yi hedeflemeyi bırakması durumunda tetiklenir.

2. Katalog Uygulaması Görüntülemelerini Alma

MODIFICATION etkinliğiyle döndürülen her paket için appstorecatalog.recentAppViews.get yöntemini çağırarak güncellenmiş katalog ayrıntılarını getirebilirsiniz.

3. En İyi Uygulamalar ve Senkronizasyon

Mağazanızda tutarlı bir katalog veritabanı bulundurmak için aşağıdaki entegrasyon kurallarını uygulayın:

  • Günlük dışa aktarma senkronizasyonu: Günlük katalog dışa aktarma özelliğini kullanarak uygun uygulamaların tam listesini içe aktarın.
  • (isteğe bağlı) Gün İçi Senkronizasyon: appstorecatalog.recentUpdateEvents.list uç noktasını düzenli olarak (ör. her dakika) hareketli bir zaman aralığıyla sorgulayın. nextPageToken kullanarak sayfalara ayırma işlemini yaptığınızdan emin olun.
    • Süreç Güncellemeleri:
      • MODIFICATION etkinlikleri için appstorecatalog.recentAppViews.get kullanarak güncellenen CatalogAppView öğesini getirin ve yerel veritabanınızı güncelleyin.
      • DELETION etkinlikleri için uygulamayı mağazanızın listelemelerinden kaldırın veya kullanıcılardan gizleyin.
    • Tekrarlanan Değişiklik Etkinliklerini İşleme: Aynı uygulama için birden fazla DEĞİŞİKLİK etkinliği görebilirsiniz. Bu, uygulamanın sorgulanan zaman aralığında birden fazla kez değiştirildiği anlamına gelir. appstorecatalog.recentAppViews.get her zaman en son değişikliğin uygulama görünümünü döndürür.