Play Catalog API के लिए डेवलपर गाइड

**ध्यान दें:** Play Catalog API, 22 जुलाई, 2026 को लॉन्च होगा

Play Catalog API की मदद से, Google Play पर रजिस्टर किए गए तीसरे पक्ष के ऐप्लिकेशन स्टोर (3PAS), Google Play के ऐप्लिकेशन कैटलॉग में हुए अपडेट के बारे में जानकारी पा सकते हैं. कॉल करने वाले लोग, ऐसे ऐप्लिकेशन के कैटलॉग की जानकारी पा सकते हैं जिनमें रोज़ाना के कैटलॉग एक्सपोर्ट के बाद बदलाव किया गया है या जिन्हें हटा दिया गया है.

ध्यान दें: Play Catalog API, रोज़ाना के कैटलॉग एक्सपोर्ट के अलावा एक और विकल्प है. इससे भी वही जानकारी मिलती है. अगर आपको 24 घंटे से ज़्यादा पुराना डेटा नहीं चाहिए, तो इस एपीआई को इंटिग्रेट करना ज़रूरी नहीं है.

ध्यान दें: Play Catalog API का इस्तेमाल, हाल ही में बदले गए डेटा को पाने के लिए ही किया जा सकता है. इसका इस्तेमाल, पूरा कैटलॉग पाने के लिए नहीं किया जा सकता. सभी ऐप्लिकेशन का पूरा कैटलॉग पाने के लिए, कैटलॉग एक्सपोर्ट का इस्तेमाल किया जाना चाहिए.

एंडपॉइंट, तरीकों, और रिसॉर्स स्कीमा की पूरी सूची देखने के लिए, Play Catalog API का रेफ़रंस देखें.

शुरू करने से पहले

Play Catalog API को कॉल करने से पहले, आपको एपीआई ऐक्सेस, सेवा क्रेडेंशियल, और Google Cloud प्रोजेक्ट सेट अप करने के लिए, मुख्य शुरू करने के लिए गाइड पूरी करनी होगी.

---

एपीआई का डिज़ाइन और आर्किटेक्चर

Play Catalog एक्सपोर्ट, हर 24 घंटे में जनरेट होता है. Play Catalog API, एक दिन में कई बार पोलिंग करने का तरीका उपलब्ध कराता है. इससे, पिछले एक्सपोर्ट के बाद हुए अपडेट की जानकारी पाई जा सकती है:

1. अपडेट इवेंट के लिए पोल करना: यह पता लगाने के लिए कि किन पैकेज के नाम में बदलाव किया गया है या किन पैकेज को मिटाया गया है, appstorecatalog.recentUpdateEvents.list startTime और endTime विंडो के साथ क्वेरी करें.
2. ज़्यादा जानकारी वाले व्यू फ़ेच करना: बदलाव किए गए हर पैकेज के नाम के लिए, ज़्यादा जानकारी वाला CatalogAppView मेटाडेटा फ़ेच करने के लिए, appstorecatalog.recentAppViews.get को कॉल करें.

यह एपीआई, सिर्फ़ पढ़ने की अनुमति देता है. साथ ही, यह सिर्फ़ पिछले 36 घंटों में हुए इवेंट की जानकारी दिखाता है. इस एपीआई की QPS सीमा, दोनों तरीकों के लिए मिलाकर दो है.

---

1. कैटलॉग अपडेट इवेंट के लिए पोल करना

किसी तय समय विंडो में बदले गए पैकेज की सूची पाने के लिए, appstorecatalog.recentUpdateEvents.list तरीके को कॉल करें.

सिर्फ़ ज़रूरी शर्तें पूरी करने वाले ऐप्लिकेशन के लिए, अपडेट इवेंट दिखाए जाते हैं. ज़रूरी शर्तें पूरी करने वाले ऐप्लिकेशन ये होने चाहिए:

• कॉल करने वाले ऐप्लिकेशन स्टोर के लिए, कैटलॉग में शामिल किए जाने के लिए ऑप्ट-इन किया गया हो.
• Google Play Store पर, अमेरिका (यूएस) में पब्लिश किया गया हो और उपलब्ध हो.

ध्यान दें: हमारा सुझाव है कि अपडेट इवेंट के लिए बार-बार पोल करें. जैसे, हर मिनट में एक बार. बार-बार पोल न करने पर, एक साथ कई अपडेट इवेंट दिखाए जा सकते हैं. इससे, उन्हें समय पर प्रोसेस करना मुश्किल हो सकता है.

अपडेट के टाइप के बारे में जानकारी

• MODIFICATION: यह तब ट्रिगर होता है, जब ज़रूरी शर्तें पूरी करने वाले किसी ऐप्लिकेशन में बदलाव किया जाता है, उसे पहली बार पब्लिश किया जाता है, वह अमेरिका को टारगेट करना शुरू करता है या जब ऐप्लिकेशन ने हाल ही में आपके कैटलॉग के लिए ऑप्ट-इन किया हो.
• DELETION: यह तब ट्रिगर होता है, जब किसी ऐप्लिकेशन को अनपब्लिश किया जाता है, उसे कैटलॉग में शामिल न करने के लिए ऑप्ट-आउट किया जाता है, उसे निलंबित या ब्लॉक किया जाता है या वह अमेरिका को टारगेट करना बंद कर देता है.

---

2. कैटलॉग में मौजूद ऐप्लिकेशन के व्यू पाना

MODIFICATION इवेंट के साथ दिखाए गए हर पैकेज के लिए, उसके अपडेट किए गए कैटलॉग की जानकारी appstorecatalog.recentAppViews.get तरीके को कॉल करके पाई जा सकती है.

ध्यान दें: 'नहीं मिला' से जुड़ी गड़बड़ियां
अगर पिछले 36 घंटों में, अनुरोध किए गए पैकेज के नाम के लिए कोई अपडेट इवेंट नहीं हुआ है, तो appstorecatalog.recentAppViews.get तरीका, NOT_FOUND गड़बड़ी (404) दिखाता है. ऐसे में, आपको रोज़ाना के पूरे कैटलॉग एक्सपोर्ट का इस्तेमाल करना चाहिए.

---

3. सबसे सही तरीके और सिंक करना

अपने स्टोर पर कैटलॉग का डेटाबेस एक जैसा बनाए रखने के लिए, इंटिग्रेशन से जुड़े इन दिशा-निर्देशों का पालन करें:

• रोज़ाना के एक्सपोर्ट को सिंक करना: रोज़ाना के कैटलॉग एक्सपोर्ट का इस्तेमाल करके, ज़रूरी शर्तें पूरी करने वाले ऐप्लिकेशन की पूरी सूची इंपोर्ट करें.
• (ज़रूरी नहीं) एक दिन में कई बार सिंक करना: समय की बदलती विंडो के साथ, appstorecatalog.recentUpdateEvents.list एंडपॉइंट को नियमित तौर पर (जैसे, हर मिनट में एक बार) पोल करें. nextPageToken का इस्तेमाल करके, पेज पर नंबर डालने की सुविधा को मैनेज करें.
  • अपडेट प्रोसेस करना:
    • MODIFICATION इवेंट के लिए, appstorecatalog.recentAppViews.get का इस्तेमाल करके, अपडेट किया गया CatalogAppView फ़ेच करें और अपने स्थानीय डेटाबेस को अपडेट करें.
    • DELETION इवेंट के लिए, अपने स्टोर की लिस्टिंग से ऐप्लिकेशन हटाएं या उसे उपयोगकर्ताओं से छिपाएं.
  • बार-बार होने वाले बदलाव के इवेंट को मैनेज करना: हो सकता है कि आपको एक ही ऐप्लिकेशन के लिए, कई MODIFICATION इवेंट दिखें. इसका मतलब है कि क्वेरी की गई समय विंडो में, ऐप्लिकेशन में कई बार बदलाव किया गया है. appstorecatalog.recentAppViews.get हमेशा, सबसे हाल के बदलाव का ऐप्लिकेशन व्यू दिखाएगा.