Tag

अंतिम अपडेट: 22 जून 2026

Tag एक छोटा लेबल है जो Content या Media को वर्गीकृत करता है। कपड़ों की दुकान वाले ऑनलाइन स्टोर को उदाहरण के तौर पर लें, तो "बेस्टसेलर", "नया उत्पाद" जैसे लेबल ही Tag हैं। एक ही Tag को कई Content और Media पर लगा देने पर, बाद में उस लेबल से उन्हें एक साथ समूहित करके देख सकते हैं या छाँट सकते हैं।

Tag स्वयं सिर्फ़ एक नाम (name) रखने वाला लेबल है, और यह बिना प्रकाशन (publish) अवधारणा वाला एक सेटिंग रिसोर्स है। किसी चीज़ पर वास्तव में लगाने का काम Tag को सीधे बदलकर नहीं होता, बल्कि Content और Media के metadata.tags में इस Tag का Refer डालकर होता है (नीचे Content और Media पर टैग लगाना देखें)। CMA में Tag एक Space के अधीन रिसोर्स है, और इसका पथ /spaces/{spaceId}/tags पर आधारित है।

रिसोर्स संरचना

नीचे Tag "बेस्टसेलर" की एकल पुनर्प्राप्ति (single retrieval) प्रतिक्रिया है। इसमें sys (सिस्टम गुण) और मुख्य गुण name होते हैं।

{
  "sys": {
    "id": "3trmXRM3RqbgSnifyg7OShPt8M8Nwh",
    "type": "Tag",
    "space": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "createdBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdAt": "2026-06-16T01:46:07.426Z",
    "updatedBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "updatedAt": "2026-06-16T01:46:07.426Z",
    "version": 1
  },
  "name": "बेस्टसेलर"
}

मुख्य कुंजियाँ:

  • sys.id: Tag का विशिष्ट पहचानकर्ता है। यह एकल पुनर्प्राप्ति, संशोधन और विलोपन पथ के {tagId} में जाता है, और metadata.tags से टैग लगाते समय Refer के लक्ष्य id के रूप में भी इस्तेमाल होता है।
  • name: Tag का नाम है (1~16 अक्षर)। यह कंटेंट वर्गीकरण में दिखने वाला लेबल ही है।

सिस्टम गुण (sys)

हर Tag सामान्य सिस्टम गुणों को sys ऑब्जेक्ट में रखता है। space, createdBy, updatedBy Refer रूप ({ "sys": { "id", "type": "Refer", "targetType" } }) में जाते हैं।

गुणप्रकारविवरण
idstringरिसोर्स का विशिष्ट पहचानकर्ता।
typestringरिसोर्स का प्रकार। Tag हमेशा "Tag" होता है।
spaceRefer<Space>वह Space जिससे यह Tag संबंधित है।
createdByRefer<User>बनाने वाला उपयोगकर्ता।
createdAtstring (date-time)बनाने का समय।
updatedByRefer<User>अंतिम बार संशोधित करने वाला उपयोगकर्ता।
updatedAtstring (date-time)अंतिम संशोधन का समय।
versioninteger (≥1)रिसोर्स संस्करण। हर संशोधन पर 1 से बढ़ता है।

मुख्य गुण:

गुणप्रकारविवरण
namestring (1~16)Tag का नाम। बनाते और संशोधित करते समय निर्दिष्ट किया जाता है।

Tag बिना प्रकाशन अवधारणा वाला एक सेटिंग रिसोर्स है। इसलिए Content और Media के विपरीत sys में publish, archive, status नहीं होते, सिर्फ़ version होता है। version Tag के हर संशोधन पर बढ़ता है।

Content और Media पर टैग लगाना

Tag लगाने के लिए दो चरण होते हैं।

  1. Tag बनाएँ (नीचे Tag निर्माण एंडपॉइंट)। प्रतिक्रिया का sys.id रख लें।
  2. Content या Media बनाते या संशोधित करते समय, उसके मुख्य भाग के metadata.tags ऐरे में इस Tag का Refer डालें।

metadata.tags में डाले जाने वाले Refer का रूप इस प्रकार है। id में चरण 1 में प्राप्त Tag का sys.id डालें।

"metadata": {
  "tags": [
    { "sys": { "id": "3trmXRM3RqbgSnifyg7OShPt8M8Nwh", "type": "Refer", "targetType": "Tag" } }
  ]
}

कई Tag लगाने के लिए इस Refer ऑब्जेक्ट को ऐरे में कई बार डालें। टैग हटाने के लिए उस आइटम को ऐरे से निकालें और Content या Media को फिर से संशोधित करें। Content और Media के मुख्य डेटा को लिखने का विस्तृत तरीका Content और Media दस्तावेज़ में देखें।

API

नीचे दिए गए सभी एंडपॉइंट का आधार URL https://cma.weegloo.com/v1 है, और Authorization हेडर में CMA को प्रमाणित करने वाला Bearer टोकन आवश्यक है। संशोधन और आंशिक संशोधन के लिए आशावादी समवर्तीता नियंत्रण (optimistic concurrency control) हेतु X-Weegloo-Version हेडर (रिसोर्स का वर्तमान sys.version) भी भेजना ज़रूरी है। निर्माण और विलोपन में यह हेडर नहीं होता।

  • Content: metadata.tags से Tag लगाने वाला मुख्य डेटा।
  • Media: metadata.tags से Tag लगाने वाला फ़ाइल रिसोर्स।