इंटिग्रेशन के लिए ज़रूरी शर्तें

Subscribe with Google के इंटिग्रेशन के काम में नीचे दिए गए एलिमेंट शामिल हैं. आम तौर पर, Subscribe with Google सिस्टम के साथ इंटिग्रेशन के लिए, हर एलिमेंट का होना ज़रूरी है. हो सकता है कि कुछ मामलों में, प्रकाशक की खास परिस्थितियों की वजह से किसी दिए गए कॉम्पोनेंट की ज़रूरत न पड़े. नीचे दिए गए संदर्भ में, इन मामलों के बारे में बताया जाएगा. प्रदर्शन A में, “प्रकाशक” शब्द का वही मतलब होता है जो डेवलपर का होता है.

  1. Google Play डेवलपर खाता: प्रकाशक को Google Play डेवलपर खाता बनाना होगा, एक ऐप्लिकेशन अपलोड करना होगा, और ऐप्लिकेशन को बिलिंग के लिए चालू करना होगा. प्रकाशक को ऐप्लिकेशन, प्रोडक्शन में प्रकाशित करना होगा या किसी मौजूदा प्रोडक्शन ऐप्लिकेशन का इस्तेमाल करना होगा.
  2. प्रकाशन कॉन्फ़िगरेशन: कॉन्फ़िगरेशन के खास बिंदुओं को सेट अप करने के लिए, प्रकाशक को तकनीकी तौर पर समस्या का हल करने वाले Google के प्रतिनिधियों के साथ काम करना होगा. इन आइटम में ज़रूरी एपीआई एंडपॉइंट के लिए यूआरएल, लोगो/ब्रैंडिंग एसेट, SKU का ब्यौरा, निजता नीति का यूआरएल, और ऐसी अन्य जानकारी शामिल होती है जिसकी ज़रूरत Google को इंटिग्रेशन सेट अप करने के लिए होती है. यह कॉन्फ़िगरेशन, इंटिग्रेट किए गए हर प्रकाशन के लिए होना ज़रूरी है.
  3. पेज मार्कअप: प्रकाशक को लेख के सभी पेजों पर स्ट्रक्चर्ड डेटा जोड़ना होगा. इस डेटा में एक प्रकाशन आईडी (प्रकाशन कॉन्फ़िगरेशन में मौजूद आईडी जैसा) और एक एनटाइटलमेंट लेबल शामिल होता है. डेटा एएमपी दस्तावेज़ों के साथ-साथ लेख के सभी पेजों पर होना ज़रूरी है.
  4. SwG.js क्लाइंट इंटिग्रेशन: प्रकाशक को, Google javascript क्लाइंट को अपनी प्रकाशन वेबसाइट में इंटिग्रेट करना होगा. प्रकाशक को लेख के ऐसे सभी पेजों पर Swg.js क्लाइंट लाइब्रेरी शामिल करनी होगी जहां paywall ट्रिगर किया जा सकता है. इसमें वे लेख भी शामिल होंगे जो सर्वर-साइड paywall को लागू करने में शामिल रहे हैं. साथ ही, प्रकाशक को SwG.js getEntitlements फ़ंक्शन को कॉल करना होगा और उस फ़ंक्शन से मिलने वाले रिस्पॉन्स के हिसाब से काम करना होगा.

    जिस हद तक प्रकाशक अपने पेजों के एएमपी वर्शन तैयार करता है और ये एएमपी पेज संभावित रूप से paywall को ट्रिगर करते हैं, एएमपी पेजों को AMP-subscriptions-google के लिए कॉन्फ़िगर किया जाना ज़रूरी है. इससे SwG उपयोगकर्ता के एनटाइटलमेंट का सम्मान होगा.

  5. Google News: अगर प्रकाशक को उस कॉन्टेंट का ऐक्सेस मिलता है जिसे उसने Google News के किसी प्रॉडक्ट में दिखाया है, तो उसे अपने Google News कॉन्फ़िगरेशन को अपडेट करना होगा, ताकि वह SwG के साथ काम कर सके. इसका मतलब है कि जो SKU ये वहां बेचता है वह इसके उन ही प्रॉडक्ट पर काम करेगा जिसका मालिकाना हक़ उसके पास है और जिसे वही मैनेज करता है और उस सदस्यता को ये कहीं और बेच सकता है--या तो अपने परचेज़ फ़्लो की मदद से या किसी SwG परचेज़ फ़्लो की मदद से--यह Google News पर पहचाना जा सकता है और इसकी अनुमति भी है. जिस हद तक प्रकाशक Google News के संदर्भ में एएमपी दस्तावेज़ों का इस्तेमाल करना चाहता है, उसे AMP-subscriptions-google का इस्तेमाल करने के लिए, इन दस्तावेज़ों को कॉन्फ़िगर करना होगा. इससे उपयोगकर्ता के एनटाइटलमेंट की ठीक से पहचाना हो सकेगी.

  6. Android इंटिग्रेशन: जिस हद तक प्रकाशक Android बनाम वेब पर SKU के अलग-अलग सेट बेच रहा है, या अगर प्रकाशक के पास एक ही प्रकाशन के लिए कई ऐप्लिकेशन हैं, तो प्रकाशक को सदस्यता खरीद की जांच के लिए अपने Android ऐप्लिकेशन को अपडेट करना होगा. साथ ही, Subscribe with Google प्रकाशक एपीआई को कॉल करके, सही तरीके से ऐक्सेस देना होगा.
  7. Google साइन-इन: प्रकाशक को वेब, iOS ऐप्लिकेशन, और Android ऐप्लिकेशन के लिए, सभी लॉगिन पेजों पर Google साइन-इन का विकल्प शामिल करना होगा.

    इस Google साइन इन वाले विकल्प को लागू करने के लिए Subscribe with Google एपीआई की जांच करनी होगी, ताकि यह पक्का किया जा सके कि अगर Google खाते के पास प्रकाशक के साथ पहले से जोड़ा गया एनटाइटलमेंट है, तो वह खाता प्रकाशक की साइट पर, उपयोगकर्ता के मौजूदा खाते से जुड़ा होता है. प्रकाशक की वेबसाइट पर, अगर Subscribe with Google प्रकाशन एपीआई यह बताता है कि उपयोगकर्ता के पास कोई ऐसा एनटाइटलमेंट है जिसकी जानकारी प्रकाशक को नहीं है, तो प्रकाशक उन उपयोगकर्ताओं को उचित तरीके से ऐक्सेस देगा जिन्हें वो जानता है. साथ ही, वह उन उपयोगकर्ताओं के लिए स्थगित खाता बनाने वाला फ़्लो लॉन्च करेगा जिन्हें वह नहीं जानता.

    अगर कोई प्रकाशक वेब या मोबाइल ऐप्लिकेशन प्रॉडक्ट पूरी तरह से मुफ़्त सेवा उपलब्ध कराता है और जिसे ऐक्सेस करने के लिए paywall ज़रूरी नहीं है, तो Google साइन-इन ज़रूरी नहीं है. इसके अलावा, असामान्य मामले में जहां कोई प्रकाशक यूज़र मैनेजमेंट सिस्टम का रखरखाव नहीं करता है (जैसे, उपयोगकर्ता से जुड़े लेन-देन के मैनेजमेंट के लिए, प्रकाशक पूरी तरह से Subscribe with Google पर भरोसा करता है), तो वहां Google साइन-इन इंटिग्रेशन की ज़रूरत (या संभव) नहीं है.

  8. खरीदारी के बाद खाता बनाने वाला हैंडलर: प्रकाशकों को खरीदारी के बाद आने वाले उपयोगकर्ताओं के लिए खाते बनाने होंगे.

    वेब पर, प्रकाशक के लिए ज़रूरी है कि वह swg.js सदस्यता से जुड़े इवेंट और एनटाइटलमेंट डेटा प्रकाशक इंफ़्रास्ट्रक्चर को लौटा सके. Google News पर और Android इन-ऐप बिलिंग के ज़रिए की जाने वाली खरीदारी के लिए, प्रकाशक को अपनी वेबसाइट पर, स्थगित खाता बनाने वाले फ़्लो का इस्तेमाल swg.js के ज़रिए तब करनी चाहिए, जब वे उपयोगकर्ता वेबसाइट पर आते हों.

    एएमपी खरीदारी के लिए, अगर कोई प्रकाशक एएमपी पर खरीदारी की प्रक्रिया लागू करता है, तो प्रकाशक को प्रकाशक इंफ़्रास्ट्रक्चर में Play Cloud Pub/Sub इवेंट की सदस्यता लेनी होगी.

    प्रकाशक को, Google की सदस्यता स्थिति API से उपयोगकर्ता प्रोफ़ाइल और सदस्यता डेटा का अनुरोध करने के लिए, सदस्यता इवेंट से खरीदारी के डेटा का इस्तेमाल करना होगा. उस डेटा के मिलने के बाद, Account Management API को या तो:

    1. Google के उपलब्ध कराए गए उपयोगकर्ता प्रोफ़ाइल की जानकारी की मदद से एक खाता बनाना होगा और सदस्यता को उस खाते से जोड़ देना होगा या
    2. प्रकाशक की साइट पर मौजूद उपयोगकर्ता खाते में, Google उपयोगकर्ता प्रोफ़ाइल और सदस्यता डेटा जोड़ना होगा.

    ऐसी स्थिति में, जब कोई प्रकाशक किसी यूज़र मैनेजमेंट सिस्टम का रखरखाव नहीं करता है (जैसे, उपयोगकर्ता से जुड़े लेन-देन को मैनेज करने के लिए, प्रकाशक पूरी तरह से Subscribe with Google पर भरोसा करता है), तो खरीदारी के बाद खाता बनाना ज़रूरी (या संभव) होगा.

  9. OAuth खाता जोड़ने का पेज: नीचे दी गई प्रक्रिया को सुविधाजनक बनाने के लिए, प्रकाशक को एक OAuth लॉगिन पेज बनाना होगा:

    1. प्रकाशक के मौजूदा उपयोगकर्ताओं की पुष्टि करना
    2. उपयोगकर्ता के एनटाइटलमेंट की जांच,
    3. उपयोगकर्ता के लिए ऐक्सेस टोकन बनाना
    4. ऐक्सेस टोकन को वापस रेफ़रिंग पेज पर रीडायरेक्ट करना और पास करना

    ऐसी स्थिति में, जब कोई प्रकाशक किसी यूज़र मैनेजमेंट सिस्टम का रखरखाव नहीं करता है (जैसे, उपयोगकर्ता से जुड़े लेन-देन को मैनेज करने के लिए, प्रकाशक पूरी तरह से Subscribe with Google पर भरोसा करता है), तो किसी भी OAuth खाता जोड़ने का पेज ज़रूरी (या संभव) नहीं होगा.

  10. एनटाइटलमेंट एपीआई: प्रकाशक को एक एनटाइटलमेंट एपीआई बनाना होगा जो प्रकाशक के OAuth खाता जोड़ने के फ़्लो से बनाए गए ऐक्सेस टोकन को स्वीकार करता हो. साथ ही, उपयोगकर्ता के एनटाइटलमेंट के साथ जवाब देता हो. इन एनटाइटलमेंट को उन लेबल के एक सेट के तौर पर दिखाया जाता है जिनका ऐक्सेस उपयोगकर्ता के पास होता है. इसके अलावा, यह उपयोगकर्ता को खरीदे गए प्रॉडक्ट के टेक्स्ट की जानकारी भी देता है.

    ऐसी स्थिति में, जब कोई प्रकाशक किसी यूज़र मैनेजमेंट सिस्टम का रखरखाव नहीं करता है, (जैसे, उपयोगकर्ता से जुड़े लेन-देन को मैनेज करने के लिए, प्रकाशक पूरी तरह से Subscribe with Google पर भरोसा करता है), तो कोई भी एनटाइटलमेंट एपीआई ज़रूरी (या संभव) नहीं होगा.

  11. अपने-आप लॉगिन की सूचना: अगर Google एनटाइटलमेंट एपीआई किसी ऐसे उपयोगकर्ता की सदस्यता दिखाता है जिसके बारे में प्रकाशक को पता है, लेकिन फ़िलहाल उपयोगकर्ता ने प्रकाशक सिस्टम में लॉग इन नहीं किया है, तो हम प्रकाशक को यही सलाह देते हैं कि वह अपनी साइट पर मौजूद खाते में उपयोगकर्ता को अपने-आप लॉग इन कर दे. उपयोगकर्ता को इवेंट के बारे में चेतावनी देने या लॉग इन से पहले उसके लिए सहमति देने के बारे में बताने के लिए, प्रकाशक swg.js ऑटो-लॉगिन फ़ंक्शन का इस्तेमाल कर सकता है.
  12. iOS इंटिग्रेशन: अगर प्रकाशक के पास iOS ऐप्लिकेशन में Subscribe with Google SKU से जुड़ा कोई paywall किया गया कॉन्टेंट है, तो प्रकाशक को Google साइन इन का इस्तेमाल करके, एनटाइटलमेंट के लिए उनके बैकएंड की जांच करनी होगी. अगर कोई बैकएंड नहीं मिलता है, तो Subscribe with Google प्रकाशक एपीआई को एनटाइटलमेंट की जांच के लिए कॉल करें और बैकएंड मिलने पर ऐक्सेस की अनुमति दें.
  13. सदस्यताएं सेव करें: Subscribe with Google के ज़रिए होने वाले किसी भी परचेज़ फ़्लो के आखिर में, प्रकाशक को सदस्यता सेव करने का फ़ंक्शन इंटिग्रेट करना होगा, ताकि उपयोगकर्ताओं को अपने Google खाते से जोड़ने का विकल्प मिल सके.