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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2. कैटलॉग ऐप्लिकेशन के व्यू वापस लाए जा रहे हैं

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

3. सबसे सही तरीके और सिंक्रनाइज़ेशन

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

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