डेवलपर से जुड़ी रीयल-टाइम सूचनाओं के बारे में जानकारी देने वाली गाइड

इस विषय में, डेवलपर से जुड़ी रीयल-टाइम सूचनाएं जो आपको Google Play से मिल सकता है.

एन्कोडिंग

Cloud Pub/Sub विषय पर किए जाने वाले हर प्रकाशन में एक base64 कोड में बदला गया डेटा फ़ील्ड.

{
  "message": {
    "attributes": {
      "key": "value"
    },
    "data": "eyAidmVyc2lvbiI6IHN0cmluZywgInBhY2thZ2VOYW1lIjogc3RyaW5nLCAiZXZlbnRUaW1lTWlsbGlzIjogbG9uZywgIm9uZVRpbWVQcm9kdWN0Tm90aWZpY2F0aW9uIjogT25lVGltZVByb2R1Y3ROb3RpZmljYXRpb24sICJzdWJzY3JpcHRpb25Ob3RpZmljYXRpb24iOiBTdWJzY3JpcHRpb25Ob3RpZmljYXRpb24sICJ0ZXN0Tm90aWZpY2F0aW9uIjogVGVzdE5vdGlmaWNhdGlvbiB9",
    "messageId": "136969346945"
  },
  "subscription": "projects/myproject/subscriptions/mysubscription"
}

base64 कोड में बदले गए डेटा फ़ील्ड को डिकोड करने के बाद, DeveloperNotification इसमें ये फ़ील्ड शामिल होते हैं:

{
  "version": string,
  "packageName": string,
  "eventTimeMillis": long,
  "oneTimeProductNotification": OneTimeProductNotification,
  "subscriptionNotification": SubscriptionNotification,
  "voidedPurchaseNotification": VoidedPurchaseNotification,
  "testNotification": TestNotification
}

इन फ़ील्ड के बारे में नीचे दी गई टेबल में बताया गया है.

प्रॉपर्टी का नाम वैल्यू ब्यौरा
वर्शन स्ट्रिंग इस सूचना का वर्शन. शुरुआत में, यह "1.0" है. यह वर्शन अन्य वर्शन फ़ील्ड से अलग हो.
पैकेज का नाम स्ट्रिंग यह सूचना जिस ऐप्लिकेशन से जुड़ी है उसका पैकेज नाम (उदाहरण के लिए, `com.some.thing`).
इवेंट टाइममिलिस लंबा इवेंट होने के समय का टाइमस्टैंप (मिलीसेकंड में), जब इवेंट हुआ था युग.
सदस्यता की सूचना Subscription सूचना अगर यह फ़ील्ड मौजूद है, तो यह सूचना . इस फ़ील्ड में, सदस्यताओं से जुड़ी अतिरिक्त जानकारी कितने लोगों ने सदस्यता ली. ध्यान दें कि यह फ़ील्ड इसके साथ म्यूचुअली एक्सक्लूसिव है oneTimeProductNotification, voidedPurchaseNotification, और टेस्ट सूचना.
एक बार प्रॉडक्ट नोटिफ़िकेशन वनटाइमप्रॉडक्ट नोटिफ़िकेशन अगर यह फ़ील्ड मौजूद है, तो यह सूचना और इस फ़ील्ड में अतिरिक्त जानकारी होती है. खरीदारी से संबंधित है. ध्यान दें कि यह फ़ील्ड म्यूचुअली एक्सक्लूसिव है Subscriptionसूचना, voidedPurchaseNotification, और testNotification.
रद्द की गई खरीदारी की सूचना VoidedPurchaseNotification अगर यह फ़ील्ड मौजूद है, तो यह सूचना रद्द की गई खरीदारी और इस फ़ील्ड में रद्द की गई खरीदारी के लिए. ध्यान दें कि यह फ़ील्ड म्यूचुअली एक्सक्लूसिव है OneTimeProductNotification, subscriptionसूचना, और टेस्ट सूचना.
टेस्ट सूचना टेस्टसूचना अगर यह फ़ील्ड मौजूद है, तो यह सूचना परीक्षण प्रकाशन. ये सिर्फ़ Google Play डेवलपर की मदद से भेजे जाते हैं कंसोल. ध्यान दें कि यह फ़ील्ड इसके साथ म्यूचुअली एक्सक्लूसिव है oneTimeProductNotification, subscriptionNotification, और voidedPurchaseNotification.

Subscription सूचना

SubscriptionNotification में ये फ़ील्ड शामिल होते हैं:

{
  "version": string,
  "notificationType": int,
  "purchaseToken": string,
  "subscriptionId": string
}
प्रॉपर्टी का नाम वैल्यू ब्यौरा
वर्शन स्ट्रिंग इस सूचना का वर्शन. शुरुआत में, यह "1.0" है. यह वर्शन अन्य वर्शन फ़ील्ड से अलग हो.
सूचना किस तरह की है आईएनटी सदस्यता के लिए सूचना टाइप में ये वैल्यू हो सकती हैं:
  • (1) SUBSCRIPTION_RECOVERED - इस वेबसाइट से सदस्यता वापस लाई गई खाते पर रोक लगा दी जाएगी.
  • (2) SUBSCRIPTION_renewED - एक चालू सदस्यता रिन्यू की गई.
  • (3) SUBSCRIPTION_CANCELED - सदस्यता या तो अपनी मर्ज़ी से ली गई थी रद्द कर दिया जाता है. अपनी इच्छा से रद्द करने के लिए, इस समय भेजा जाता है जब उपयोगकर्ता अपनी सदस्यता रद्द करता है.
  • (4) SUBSCRIPTION_PURCHASED - नई सदस्यता खरीदी गई.
  • (5) SUBSCRIPTION_ON_HOLD - कोई सदस्यता खाते में दर्ज हो गई है होल्ड करें (चालू होने पर).
  • (6) SUBSCRIPTION_IN_GRACE_PERIOD - सदस्यता दर्ज की गई मोहलत की अवधि (अगर चालू हो).
  • (7) SUBSCRIPTION_RESTARTED - उपयोगकर्ता ने अपने Play > की सदस्यता खाता > सदस्यताएं. कॉन्टेंट बनाने सदस्यता को रद्द कर दिया गया था, लेकिन उपयोगकर्ता के खत्म होने तक उसकी समयसीमा खत्म नहीं हुई थी वापस लाया जाता है. ज़्यादा जानकारी के लिए, यह देखें बहाली.
  • (8) SUBSCRIPTION_PRICE_CHANGE_CONFIRMED - एक सदस्यता मूल्य उपयोगकर्ता ने बदलाव की पुष्टि कर दी है.
  • (9) SUBSCRIPTION_DEFERRED - सदस्यता के बार-बार होने का समय है को बढ़ाया गया है.
  • (10) SUBSCRIPTION_PA साथ - एक सदस्यता रोक दी गई है.
  • (11) SUBSCRIPTION_PAUSE_SCHEDULE_CHANGED - सदस्यता रोकना शेड्यूल में बदलाव कर दिया गया है.
  • (12) SUBSCRIPTION_REVOKED - एक सदस्यता को से रद्द किया गया है उपयोगकर्ता को उसकी समयसीमा खत्म होने से पहले रखना होगा.
  • (13) SUBSCRIPTION_EXPIRED - सदस्यता की समयसीमा खत्म हो गई है.
  • (20) SUBSCRIPTION_PENDING_PURCHASE_CANCELED - एक लंबित लेन-देन की सदस्यता रद्द कर दी गई है.
खरीदारी टोकन स्ट्रिंग वह टोकन जो उपयोगकर्ता के डिवाइस पर तब दिया गया था, जब सदस्यता खरीदा.
सदस्यता आईडी स्ट्रिंग खरीदी गई सदस्यता का प्रॉडक्ट आईडी (उदाहरण के लिए, "मासिक001".

उदाहरण

नई सदस्यता खरीदने की सूचना का एक उदाहरण यहां दिया गया है:

{
  "version":"1.0",
  "packageName":"com.some.thing",
  "eventTimeMillis":"1503349566168",
  "subscriptionNotification":
  {
    "version":"1.0",
    "notificationType":4,
    "purchaseToken":"PURCHASE_TOKEN",
    "subscriptionId":"monthly001"
  }
}

वनटाइमप्रॉडक्ट नोटिफ़िकेशन

OneTimeProductNotification में ये फ़ील्ड शामिल होते हैं:

{
  "version": string,
  "notificationType": int,
  "purchaseToken": string,
  "sku": string
}
प्रॉपर्टी का नाम वैल्यू ब्यौरा
वर्शन स्ट्रिंग इस सूचना का वर्शन. शुरुआत में, यह "1.0" होगा. यह वर्शन अन्य वर्शन फ़ील्ड से अलग हो.
सूचना किस तरह की है आईएनटी सूचना किस तरह की है. इसमें ये वैल्यू हो सकती हैं:
  • (1) ONE_TIME_PRODUCT_PURCHASED - एक बार इस्तेमाल किया जाने वाला प्रॉडक्ट था उपयोगकर्ता ने खरीदा है.
  • (2) ONE_TIME_PRODUCT_CANCELED - एक बार लिया जाने वाला ऐसा प्रॉडक्ट जिसे मंज़ूरी मिलना बाकी है उपयोगकर्ता ने खरीदारी रद्द कर दी हो.
खरीदारी टोकन स्ट्रिंग खरीदारी के समय, उपयोगकर्ता के डिवाइस पर दिया गया टोकन.
SKU स्ट्रिंग खरीदा गया एक बार इस्तेमाल किया जाने वाला प्रॉडक्ट आईडी (उदाहरण के लिए, "sword_001")

उदाहरण

एक बार की जाने वाली नई खरीदारी की सूचना का एक उदाहरण यहां दिया गया है:

{
  "version":"1.0",
  "packageName":"com.some.thing",
  "eventTimeMillis":"1503349566168",
  "oneTimeProductNotification":
  {
    "version":"1.0",
    "notificationType":1,
    "purchaseToken":"PURCHASE_TOKEN",
    "sku":"my.sku"
  }
}

VoidedPurchaseNotification

VoidedPurchaseNotification में ये फ़ील्ड शामिल होते हैं:

प्रॉपर्टी का नाम

वैल्यू

ब्यौरा

purchaseToken

string

खरीदारी से जुड़ा टोकन, जो रद्द कर दिया गया है. यह नई खरीदारी पर, डेवलपर को यह जानकारी दी जाती है होता है.

orderId

string

उस लेन-देन से जुड़ा यूनीक ऑर्डर आईडी जिसमें रद्द कर दिया गया है. एक बार की खरीदारी के लिए, यह सिर्फ़ ऑर्डर आईडी दिखाता है जनरेट किया गया है. अपने-आप रिन्यू होने वाली सदस्यताओं के लिए, नई हर रिन्यूअल लेन-देन के लिए ऑर्डर आईडी जनरेट किया जाता है.

productType

int

रद्द की गई खरीदारी के लिए productType ये वैल्यू हो सकती हैं:

  • (1) PRODUCT_TYPE_SUBSCRIPTION - सदस्यता खरीदारी रद्द कर दी गई हो.
  • (2) PRODUCT_TYPE_ONE_TIME - एक बार की जाने वाली खरीदारी रद्द कर दिया गया है.

refundType

int

रद्द की गई खरीदारी के लिए refundType ये वैल्यू हो सकती हैं:

  • (1) REFUND_TYPE_FULL_REFUND - खरीदारी पूरी तरह से रद्द कर दी गई है.
  • (2) REFUND_TYPE_QUANTITY_BASED_PARTIAL_REFUND - मात्रा पर आधारित कुछ हिस्से के रिफ़ंड की वजह से, खरीदारी को कुछ हद तक रद्द कर दिया गया है, यह सिर्फ़ उन आइटम की खरीदारी पर लागू होगा जिनकी संख्या कई आइटम के तौर पर खरीदी गई है. आपकी खरीदारी कई बार कुछ हद तक रद्द किया गया.

ध्यान दें कि किसी प्रॉडक्ट की एक से ज़्यादा यूनिट की खरीदारी के लिए, बची हुई कुल संख्या कितनी है का रिफ़ंड कर दिया जाएगा, तो refundType REFUND_TYPE_FULL_REFUND.

उदाहरण

रद्द की गई नई खरीदारी की सूचना का एक उदाहरण यहां दिया गया है:

{
  "version":"1.0",
  "packageName":"com.some.app",
  "eventTimeMillis":"1503349566168",
  "voidedPurchaseNotification":
  {
    "purchaseToken":"PURCHASE_TOKEN",
    "orderId":"GS.0000-0000-0000",
    "productType":1
    "refundType":1
  }
}

VoidedPurchaseNotification का इस्तेमाल करना

जब आपके आरटीडीएन क्लाइंट को VoidedPurchaseNotification मिलता है, तो नीचे दी गई जानकारी:

  • packageName: इससे ऐप्लिकेशन की पहचान होती है.
  • eventTimeMillis: इससे डेवलपर को जानकारी में बदलाव के समय की जानकारी मिलती है स्थिति हुई.
  • purchaseToken: वह टोकन जो उपयोगकर्ता के डिवाइस को तब दिया गया था, जब प्रॉडक्ट को खरीदा गया था.
  • orderId: इससे रद्द किए गए ऑर्डर की पहचान होती है लेन-देन.
  • productType: इससे आपको पता चलता है कि रद्द की गई खरीदारी, इन-ऐप्लिकेशन थी या नहीं खरीदारी या सदस्यता.
  • refundType: इससे आपको उस रिफ़ंड का टाइप पता चलता है जिससे खरीदारी रद्द हो गई है.

अगर एनटाइटलमेंट में बदलाव करने के लिए आपको बस सही खरीदारी का पता लगाना है और ऑर्डर करना है, तो इस बिंदु पर आपके पास ज़रूरत की सारी जानकारी मौजूद होती है. सीखने में रद्द की गई खरीदारी के बारे में अतिरिक्त जानकारी कैसे पाएं, यहां देखें: Google Play अमान्य खरीदारी एपीआई, यह एक पुल मॉडल है, जो रद्द की गई खरीदारी के लिए अतिरिक्त डेटा देता है .

एक से ज़्यादा यूनिट की खरीदारी के कुछ हिस्से को रद्द करने के लिए, refundableQuantity फ़ील्ड purchases.products की ओर से दिए गए में बाकी बची हुई चीज़ें शामिल हैं खरीदे गए प्रॉडक्ट की संख्या, जो रद्द नहीं किए गए हैं.

टेस्टसूचना

TestNotification में ये फ़ील्ड शामिल होते हैं:

{
  "version": string
}
प्रॉपर्टी का नाम वैल्यू ब्यौरा
वर्शन स्ट्रिंग इस सूचना का वर्शन. शुरुआत में, यह "1.0" है. यह वर्शन, अन्य वर्शन फ़ील्ड से अलग है.

उदाहरण

जांच के लिए सूचना का एक उदाहरण यहां दिया गया है:

{
  "version":"1.0",
  "packageName":"com.some.thing",
  "eventTimeMillis":"1503350156918",
  "testNotification":
  {
    "version":"1.0"
  }
}