Google Play सेटअप

Refund Sensor एक सर्विस अकाउंट से Google Play से जुड़ता है जिसे आप अपने ही Google Cloud प्रोजेक्ट में बनाते हैं। यह कभी समाप्त नहीं होता और दोबारा अधिकृत करने की ज़रूरत नहीं। आपको चाहिए:

• आपके Play Console के मालिक अकाउंट पर एक Google Cloud प्रोजेक्ट (मुफ़्त वाला भी ठीक है)।
• एक सर्विस अकाउंट जिसकी JSON कुंजी आप डाउनलोड कर सकें।
• उस अकाउंट को दिया गया Play Console एक्सेस और साथ में Pub/Sub Admin।
• जिन पैकेज नाम या Play Store URL का बचाव करना है।

1. अपने Play Console के मालिक अकाउंट से Google Cloud Console खोलें, और एक प्रोजेक्ट चुनें या बनाएँ। बाएँ मेन्यू में IAM & Admin खोलें और Service accounts पर क्लिक करें।
2. + Create service account पर क्लिक करें, इसे RefundSensor Google Play API जैसा नाम दें, फिर Create and continue और Done पर क्लिक करें। यहाँ वैकल्पिक भूमिकाएँ छोड़ सकते हैं।
3. सर्विस अकाउंट ईमेल कॉपी करें (यह .iam.gserviceaccount.com पर समाप्त होता है)। अगले चरणों में इसकी ज़रूरत होगी।
4. सर्विस अकाउंट खोलें, Keys टैब पर जाएँ, Add key → Create new key पर क्लिक करें, JSON चुनें, और Create पर क्लिक करें। Google एक .json फ़ाइल डाउनलोड करता है। इसे सुरक्षित रखें; Google इसे दोबारा डाउनलोड नहीं करने देगा।

आपके प्रोजेक्ट में दो Google API सक्षम करने होते हैं (हर प्रोजेक्ट में एक बार)। Google Cloud Console में, अपना प्रोजेक्ट चुने हुए, हर एक को खोजें और सक्षम करें:

• Google Play Android Developer API, जो सर्विस अकाउंट को आपके रिफ़ंड और ऑर्डर डेटा पढ़ने देती है।
• Cloud Pub/Sub API, जो रीयल-टाइम रिफ़ंड नोटिफ़िकेशन चलाती है। पक्का करें कि यह Cloud Pub/Sub है, न कि Pub/Sub Lite, जो एक अलग उत्पाद है।

Refund Sensor में Add app खोलें, Google Play चुनें, और .json कुंजी फ़ाइल अपलोड करें। हम इसे Google से सत्यापित करते हैं और AES-256-GCM से स्टोरेज में एन्क्रिप्ट करके रखते हैं।

सर्विस अकाउंट को Play Console में आमंत्रित करें और उसे दो जगह वित्तीय एक्सेस दें, क्योंकि रिफ़ंड (रद्द खरीदारी) डेटा अकाउंट स्तर पर पढ़ा जाता है:

1. Google Play Console में Users and permissions → Invite new users खोलें और सर्विस अकाउंट ईमेल चिपकाएँ। सेव करते ही सर्विस अकाउंट सक्रिय हो जाता है; यह ख़ुद आमंत्रण स्वीकार नहीं करता।
2. App permissions के तहत, जिस-जिस ऐप का बचाव करना है उसे जोड़ें और View financial data व Manage orders and subscriptions चालू करें।
3. Account permissions टैब (आसानी से छूट जाता है) पर जाएँ और Financial data के तहत View financial data, orders and cancellation survey responses व Manage orders and subscriptions चालू करें, फिर सेव करें।

रीयल-टाइम नोटिफ़िकेशन एक Pub/Sub टॉपिक के ज़रिए Refund Sensor तक पहुँचते हैं जिसे हम आपके लिए बनाते और जोड़ते हैं, इसलिए Play Console में चिपकाने को कुछ नहीं है। इसे सिर्फ़ Pub/Sub प्रबंधित करने की अनुमति चाहिए। IAM & Admin → IAM में Grant access पर क्लिक करें, अपने सर्विस अकाउंट ईमेल को principal के रूप में चिपकाएँ, भूमिका Pub/Sub Admin (roles/pubsub.admin) चुनें, और सेव करें। Pub/Sub Admin चुनें, Pub/Sub Lite Admin नहीं; Lite भूमिका काम नहीं करती और ऑटो सेटअप विफल होने का सबसे आम कारण है।

Add apps चरण में, प्रति पंक्ति एक Play Store URL या पैकेज नाम चिपकाएँ (पैकेज नाम Play Store लिंक में ?id= के बाद का मान है, जैसे com.yourcompany.app)। Refund Sensor आयात से पहले हर एक को कनेक्ट किए अकाउंट के Play Console एक्सेस के विरुद्ध जाँचता है, और जो नहीं दिखते उन्हें चिह्नित करता है।

API सक्षम और Pub/Sub Admin दिए जाने पर, ऐप आयात करना अपने आप टॉपिक और पुश सब्सक्रिप्शन बना देता है और उसे ऐप के RTDN एंडपॉइंट के रूप में दर्ज करता है। फिर ऐप Awaiting first refund event दिखाता है जब तक Google पहला असली इवेंट न पहुँचाए (Google की तरफ़ कोई टेस्ट बटन नहीं है)। अगर ऑटो-सेटअप कभी विफल हो, तो ऐप कार्ड Real-time notifications not set up और इस गाइड पर वापस जाने का लिंक दिखाता है।

हर Google Play रिफ़ंड पर आपत्ति नहीं की जा सकती। सामान्य उपयोगकर्ता रिफ़ंड Google ख़ुद तय करता है, इसलिए वे दिखने के लिए दर्ज होते हैं पर उन पर आपत्ति नहीं होती।

जिस एकमात्र रिफ़ंड का आप सच में जवाब दे सकते हैं वह है समीक्षा में चल रहा चार्जबैक (Google का pendingRefundReviewNotification)। यह लगभग 24 घंटे देता है और पहले जवाब को मानता है। Refund Sensor इसका अस्वीकृति सिफ़ारिश के साथ अपने आप जवाब देता है, विंडो के भीतर पर्याप्त पहले।

एक सुरक्षा के तौर पर, Refund Sensor Google की Voided Purchases API से भी मिलान करता है, ताकि जब कुछ आपत्ति करने को न भी हो, तब भी हर रिफ़ंड और रद्द खरीदारी आपके डैशबोर्ड में दर्ज हो।