REST Resource: offerobject

संसाधन: OfferObject

JSON के काेड में दिखाना
{
  "kind": string,
  "classReference": {
    object (OfferClass)
  },
  "id": string,
  "classId": string,
  "version": string,
  "state": enum (State),
  "barcode": {
    object (Barcode)
  },
  "messages": [
    {
      object (Message)
    }
  ],
  "validTimeInterval": {
    object (TimeInterval)
  },
  "locations": [
    {
      object (LatLongPoint)
    }
  ],
  "hasUsers": boolean,
  "smartTapRedemptionValue": string,
  "hasLinkedDevice": boolean,
  "disableExpirationNotification": boolean,
  "infoModuleData": {
    object (InfoModuleData)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "appLinkData": {
    object (AppLinkData)
  },
  "rotatingBarcode": {
    object (RotatingBarcode)
  },
  "heroImage": {
    object (Image)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "passConstraints": {
    object (PassConstraints)
  },
  "saveRestrictions": {
    object (SaveRestrictions)
  },
  "linkedObjectIds": [
    string
  ],
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}
फ़ील्ड
kind
(deprecated)

string

यह बताता है कि यह किस तरह का संसाधन है. वैल्यू: तय की गई स्ट्रिंग "walletobjects#offerObject".

classReference

object (OfferClass)

पैरंट क्लास के इनहेरिट किए गए फ़ील्ड की कॉपी. ये फ़ील्ड, GET के दौरान वापस लाए जाते हैं.

id

string

ज़रूरी है. किसी ऑब्जेक्ट का यूनीक आइडेंटिफ़ायर. यह आईडी, जारी करने वाले के सभी ऑब्जेक्ट के लिए अलग होना चाहिए. यह वैल्यू issuer ID फ़ॉर्मैट में होनी चाहिए.identifier, जहां पहला कोड Google जारी करता है और दूसरा कोड आप चुनते हैं. यूनीक आइडेंटिफ़ायर में सिर्फ़ अक्षर, अंक, '.', '_' या '-' होने चाहिए.

classId

string

ज़रूरी है. इस ऑब्जेक्ट से जुड़ी क्लास. क्लास, इस ऑब्जेक्ट के टाइप की ही होनी चाहिए. साथ ही, यह पहले से मौजूद होनी चाहिए और उसे मंज़ूरी मिल चुकी हो.

क्लास आईडी, issuer ID फ़ॉर्मैट में होने चाहिए.identifier, जहां पहला कोड Google जारी करता है और दूसरा कोड आप चुनते हैं.

version
(deprecated)

string (int64 format)

बहिष्कृत

state

enum (State)

ज़रूरी है. ऑब्जेक्ट की स्थिति. इस फ़ील्ड का इस्तेमाल यह तय करने के लिए किया जाता है कि ऐप्लिकेशन में कोई ऑब्जेक्ट कैसे दिखेगा. उदाहरण के लिए, inactive ऑब्जेक्ट को "समयसीमा खत्म हो चुके पास" सेक्शन में ले जाया जाता है.

barcode

object (Barcode)

बारकोड का टाइप और वैल्यू.

messages[]

object (Message)

ऐप्लिकेशन में दिखने वाले मैसेज का कलेक्शन. इस ऑब्जेक्ट के सभी उपयोगकर्ताओं को इससे जुड़े मैसेज मिलेंगे. इन फ़ील्ड की संख्या ज़्यादा से ज़्यादा 10 हो सकती है.

validTimeInterval

object (TimeInterval)

इस ऑब्जेक्ट की समयावधि active होगी और ऑब्जेक्ट का इस्तेमाल किया जा सकता है. यह समयसीमा खत्म होने के बाद, ऑब्जेक्ट का स्टेटस expired में बदल जाएगा.

locations[]

object (LatLongPoint)

ध्यान दें: फ़िलहाल, इस फ़ील्ड का इस्तेमाल करके जगह की जानकारी से जुड़ी सूचनाएं ट्रिगर नहीं की जा सकतीं.

hasUsers

boolean

इससे पता चलता है कि ऑब्जेक्ट के उपयोगकर्ता हैं या नहीं. इस फ़ील्ड को प्लैटफ़ॉर्म सेट करता है.

smartTapRedemptionValue

string

इस ऑब्जेक्ट के लिए, एनएफ़सी के ज़रिए स्मार्ट टैप सर्टिफ़ाइड टर्मिनल पर भेजी जाने वाली वैल्यू. पास में स्मार्ट टैप की सुविधा काम करे, इसके लिए क्लास लेवल के फ़ील्ड enableSmartTap और redemptionIssuers को भी सही तरीके से सेट अप करना ज़रूरी है. सिर्फ़ ASCII वर्ण इस्तेमाल किए जा सकते हैं.

hasLinkedDevice

boolean

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

disableExpirationNotification

boolean

इससे पता चलता है कि सूचनाओं को साफ़ तौर पर दबाया जाना चाहिए या नहीं. अगर इस फ़ील्ड को 'सही है' पर सेट किया जाता है, तो messages फ़ील्ड पर ध्यान दिए बिना, उपयोगकर्ता को समयसीमा खत्म होने की सूचनाएं नहीं दी जाएंगी. डिफ़ॉल्ट रूप से, यह फ़ील्ड 'गलत' पर सेट होता है.

फ़िलहाल, इसे सिर्फ़ ऑफ़र के लिए सेट किया जा सकता है.

infoModuleData

object (InfoModuleData)

समर्थन नहीं होना या रुकना. इसके बजाय, textModulesData का इस्तेमाल करें.

imageModulesData[]

object (ImageModuleData)

इमेज मॉड्यूल डेटा. ऑब्जेक्ट लेवल पर, इन फ़ील्ड की ज़्यादा से ज़्यादा संख्या एक और क्लास ऑब्जेक्ट लेवल पर एक होती है.

textModulesData[]

object (TextModuleData)

टेक्स्ट मॉड्यूल का डेटा. अगर क्लास में टेक्स्ट मॉड्यूल का डेटा भी तय किया गया है, तो दोनों दिखेंगे. ऑब्जेक्ट से ज़्यादा से ज़्यादा 10 और क्लास से 10 फ़ील्ड दिखाए जा सकते हैं.

rotatingBarcode

object (RotatingBarcode)

घूमने वाले बारकोड का टाइप और वैल्यू.

heroImage

object (Image)

कार्ड के सामने वाले हिस्से पर दिखने वाली बैनर इमेज. हालांकि, यह ज़रूरी नहीं है. अगर कोई भी इमेज मौजूद नहीं है, तो क्लास की हीरो इमेज (अगर मौजूद हो) दिखाई जाएगी. अगर क्लास की हीरो इमेज भी मौजूद नहीं है, तो कुछ नहीं दिखाया जाएगा.

groupingInfo

object (GroupingInfo)

वह जानकारी जो यह कंट्रोल करती है कि पास का ग्रुप कैसे बनाया जाता है.

passConstraints

object (PassConstraints)

ऑब्जेक्ट के लिए पाबंदियां पास करें. इसमें एनएफ़सी और स्क्रीनशॉट की सुविधा को सीमित करना शामिल है.

saveRestrictions

object (SaveRestrictions)

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

linkedObjectIds[]

string

linkedObjectIds, अन्य ऑब्जेक्ट की सूची होती है. जैसे, इवेंट का टिकट, लॉयल्टी, ऑफ़र, सामान्य, उपहार कार्ड, ट्रांज़िट, और बोर्डिंग पास. ये ऑब्जेक्ट, इस ऑफ़र ऑब्जेक्ट से अपने-आप जुड़ जाने चाहिए. अगर किसी उपयोगकर्ता ने यह ऑफ़र सेव किया है, तो ये लिंक किए गए आइडेंटिफ़ायर, उपयोगकर्ता के वॉलेट में अपने-आप भेज दिए जाएंगे. ऐसा तब तक होगा, जब तक उपयोगकर्ता ने लिंक किए गए ऐसे पास पाने की सेटिंग बंद न कर दी हो.

पक्का करें कि linkedObjectIds में मौजूद ऑब्जेक्ट पहले से ही डाले गए हों. ऐसा न होने पर, कॉल पूरा नहीं हो पाएगा. लिंक करने के बाद, लिंक किए गए ऑब्जेक्ट को अनलिंक नहीं किया जा सकता. इनाम जारी करने वाले किसी दूसरे बैंक के ऑब्जेक्ट को लिंक नहीं किया जा सकता. किसी एक ऑब्जेक्ट से एक तय संख्या तक ही ऑब्जेक्ट लिंक किए जा सकते हैं. सीमा पूरी होने के बाद, कॉल में लिंक किए गए नए ऑब्जेक्ट को अनदेखा कर दिया जाएगा.

ऑब्जेक्ट आईडी, issuer ID फ़ॉर्मैट में होने चाहिए.identifier, जहां पहला कोड Google जारी करता है और दूसरा कोड आप चुनते हैं.

notifyPreference

enum (NotificationSettingsForUpdates)

इस ऑब्जेक्ट के फ़ील्ड में होने वाले अपडेट से सूचनाएं ट्रिगर होनी चाहिए या नहीं. अगर इसे NOTIFY पर सेट किया जाता है, तो हम उपयोगकर्ताओं को फ़ील्ड अपडेट होने की सूचना ट्रिगर करने की कोशिश करेंगे. ये सूचनाएं सिर्फ़ तब उपयोगकर्ताओं को भेजी जाएंगी, जब फ़ील्ड किसी अनुमति वाली सूची का हिस्सा हो. अगर इसकी वैल्यू DO_NOT_NOTIFY या NOTIFICATION_SETTINGS_UNSPECIFIED पर सेट है, तो कोई सूचना ट्रिगर नहीं होगी. यह सेटिंग कुछ समय के लिए ही सेट रहती है. इसे हर PATCH या UPDATE अनुरोध के साथ सेट करना ज़रूरी है. ऐसा न करने पर, सूचना ट्रिगर नहीं होगी.

valueAddedModuleData[]

object (ValueAddedModuleData)

वैकल्पिक वैल्यू ऐडेड मॉड्यूल डेटा. ऑब्जेक्ट पर ज़्यादा से ज़्यादा 10.

तरीके

addmessage

दिए गए ऑब्जेक्ट आईडी से रेफ़र किए गए ऑफ़र ऑब्जेक्ट में मैसेज जोड़ता है.

get

दिए गए ऑब्जेक्ट आईडी के साथ ऑफ़र ऑब्जेक्ट दिखाता है.

insert

दिए गए आईडी और प्रॉपर्टी के साथ ऑफ़र ऑब्जेक्ट डालता है.

list

जारी करने वाले के किसी दिए गए आईडी के लिए, ऑफ़र से जुड़े सभी ऑब्जेक्ट की सूची दिखाता है.

patch

दिए गए ऑब्जेक्ट आईडी से रेफ़र किए गए ऑफ़र ऑब्जेक्ट को अपडेट करता है.

update

दिए गए ऑब्जेक्ट आईडी से रेफ़र किए गए ऑफ़र ऑब्जेक्ट को अपडेट करता है.