टैग्स API

नोट

HWIDs और UserIDs के लिए टैग मान सेट करने के लिए, डिवाइस API से /setTags विधि का उपयोग करें। addTag वैकल्पिक है, क्योंकि setTags किसी भी टैग नाम को बनाता है जिसे वह अभी तक नहीं पहचानता है और मान से प्रकार का अनुमान लगाता है: एक पूर्ण संख्या इंटीजर बन जाती है, दशमलव बिंदु वाली संख्या प्राइस बन जाती है, एक स्ट्रिंग स्ट्रिंग बन जाती है (या डेट, एक मान्यता प्राप्त डेट-टाइम प्रारूप के लिए जैसे 2024-10-02 22:11), एक ऐरे लिस्ट बन जाता है, और एक बूलियन बूलियन बन जाता है। ऑटो-क्रिएट किया गया टैग हमेशा User-specific (user_specific: true) होता है। वर्शन टैग के लिए addTag का उपयोग करें, क्योंकि ऑटो-क्रिएशन इसका अनुमान नहीं लगा सकता है, या General टैग (user_specific: false) के लिए। टैग ऑटो-क्रिएशन अधिकांश खातों के लिए डिफ़ॉल्ट रूप से सक्षम है। यदि setTags अपेक्षा के अनुसार एक नया टैग नहीं बनाता है, तो यह जांचने के लिए Pushwoosh सहायता से संपर्क करें कि क्या यह आपके खाते के लिए बंद कर दिया गया है।

ऑर्डर या ऑर्डर की सूची जैसा संरचित डेटा एक ही टैग में संग्रहीत करने के लिए ऑब्जेक्ट टैग (बीटा) का उपयोग करें। addTag उन्हें नहीं बना सकता, क्योंकि यह फ़ील्ड नहीं लेता।

addTag

POST https://api.pushwoosh.com/json/1.3/addTag

आपके खाते में एक टैग बनाता है।

अनुरोध बॉडी

नाम	प्रकार	विवरण
auth*	string	Pushwoosh कंट्रोल पैनल से API एक्सेस टोकन।
tag*	object	टैग पैरामीटर।
tag.name*	string	टैग का नाम।
tag.type*	integer	टैग का प्रकार। नीचे संभावित मान देखें।
tag.user_specific	boolean	जब true होता है, तो टैग मान उपयोगकर्ता स्तर पर संग्रहीत होता है और UserID द्वारा सेट किए जाने पर उपयोगकर्ता के सभी डिवाइसों में साझा किया जाता है। जब false (डिफ़ॉल्ट) होता है, तो टैग डिवाइस-स्तरीय होता है और प्रति HWID सेट किया जाता है।
tag.application_specific	boolean	अप्रचलित। यह स्वीकार किया जाता है, लेकिन अनदेखा किया जाता है, क्योंकि टैग अब एप्लिकेशन-विशिष्ट और पूरे खाते के टैग में नहीं बँटे हैं। इसे भेजने की ज़रूरत नहीं है।

200

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "result": true
  }
}

उदाहरण

{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // required. API access token from Pushwoosh Control Panel
    "tag": {
      "name": "TAG_NAME",           // required.
      "type": 1,                    // required. See possible values below
      "user_specific": false        // optional. true = user-level tag (shared across all devices); false = device-level tag (default)
    }
  }
}

संभावित टैग मान प्रकार:

• 1 - इंटीजर
• 2 - स्ट्रिंग
• 3 - लिस्ट
• 4 - डेट
• 5 - बूलियन
• 6 - डेसीमल। उदाहरण: 19.95
• 7 - वर्शन। उदाहरण: “1.0.0.0”

deleteTag

POST https://api.pushwoosh.com/json/1.3/deleteTag

डेटाबेस से सभी संबंधित जानकारी के साथ एक टैग को पूरी तरह से हटा देता है।

अनुरोध बॉडी

नाम	प्रकार	विवरण
auth*	string	Pushwoosh कंट्रोल पैनल से API एक्सेस टोकन।
tag*	object	टैग पैरामीटर।
tag.name*	string	हटाने के लिए एक टैग का नाम।

200

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "result": true
  }
}

उदाहरण

{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // required. API access token from Pushwoosh Control Panel
    "tag": {
      "name": "TAG_NAME"            // required. Name of a tag to delete
    }
  }
}

listTags

POST https://api.pushwoosh.com/json/1.3/listTags

खाते पर टैग की एक सूची प्राप्त करता है।

अनुरोध बॉडी

नाम	प्रकार	विवरण
auth*	string	Pushwoosh कंट्रोल पैनल से API एक्सेस टोकन।

200

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "tags": [{
      "name":"Language",
      "type":2,
      "isUserSpecific":true,
      "isApplicationSpecific":true
    }, {
      "name":"List tag",
      "type":3,
      "isUserSpecific":false,
      "isApplicationSpecific":true
    }]
  }
}

isUserSpecific बताता है कि टैग User-specific है या नहीं। isApplicationSpecific हमेशा true होता है और केवल बैकवर्ड कम्पैटिबिलिटी के लिए रखा गया है, क्योंकि टैग अब एप्लिकेशन-विशिष्ट और पूरे खाते के टैग में नहीं बँटे हैं। इस फ़ील्ड पर निर्भर न रहें।

उदाहरण

{
  "request":{
    "auth": "yxoPUlwqm…………pIyEX4H" // API access token from Pushwoosh Control Panel
  }
}

टैग प्रकार:

• 1 - इंटीजर
• 2 - स्ट्रिंग
• 3 - लिस्ट
• 4 - डेट
• 5 - बूलियन
• 6 - डेसीमल। उदाहरण: 19.95
• 7 - वर्शन। उदाहरण: “1.0.0.0”