Tags: create

इसके लिए, अनुमति लेना ज़रूरी है

GTM टैग बनाता है. इसे अभी आज़माएं या उदाहरण देखें.

अनुरोध

एचटीटीपी अनुरोध

POST https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/tags

पैरामीटर

पैरामीटर का नाम वैल्यू ब्यौरा
पाथ पैरामीटर
accountId string GTM खाता आईडी.
containerId string GTM कंटेनर आईडी.

अनुमति देना

इस अनुरोध के लिए नीचे दिए गए दायरे के साथ अनुमति की ज़रूरत है (पुष्टि करने और अनुमति देने के बारे में ज़्यादा पढ़ें).

स्कोप
https://www.googleapis.com/auth/tagmanager.edit.containers

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, नीचे दी गई प्रॉपर्टी के साथ टैग संसाधन दें:

प्रॉपर्टी का नाम वैल्यू ब्यौरा ज़रूरी जानकारी
ज़रूरी प्रॉपर्टी
name string टैग का डिसप्ले नेम. लिखने योग्य
parameter[].type string पैरामीटर का टाइप. मान्य मान हैं:
  • boolean: वैल्यू एक बूलियन को दिखाती है, जिसे 'true' या 'false' के रूप में दिखाया जाता है
  • integer: यह वैल्यू, बेस 10 में साइन किए गए 64-बिट पूर्णांक की वैल्यू दिखाती है
  • list: पैरामीटर की सूची दी जानी चाहिए
  • map: पैरामीटर का मैप तय किया जाना चाहिए
  • template: वैल्यू से किसी भी तरह का टेक्स्ट दिखता है. इसमें वैरिएबल के रेफ़रंस भी शामिल हो सकते हैं. इनमें ऐसे वैरिएबल रेफ़रंस भी शामिल हो सकते हैं जो बिना स्ट्रिंग वाले टाइप दिखा सकते हैं
  • trigger_reference: वैल्यू एक ट्रिगर को दिखाती है, जिसे ट्रिगर आईडी के रूप में दिखाया जाता है


स्वीकार की जाने वाली वैल्यू हैं:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
 लिखने योग्य
priority.type string पैरामीटर का टाइप. मान्य मान हैं:
  • boolean: वैल्यू एक बूलियन को दिखाती है, जिसे 'true' या 'false' के रूप में दिखाया जाता है
  • integer: यह वैल्यू, बेस 10 में साइन किए गए 64-बिट पूर्णांक की वैल्यू दिखाती है
  • list: पैरामीटर की सूची दी जानी चाहिए
  • map: पैरामीटर का मैप तय किया जाना चाहिए
  • template: वैल्यू से किसी भी तरह का टेक्स्ट दिखता है. इसमें वैरिएबल के रेफ़रंस भी शामिल हो सकते हैं. इनमें ऐसे वैरिएबल रेफ़रंस भी शामिल हो सकते हैं जो बिना स्ट्रिंग वाले टाइप दिखा सकते हैं
  • trigger_reference: वैल्यू एक ट्रिगर को दिखाती है, जिसे ट्रिगर आईडी के रूप में दिखाया जाता है


स्वीकार की जाने वाली वैल्यू हैं:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
 लिखने योग्य
type string GTM टैग टाइप. लिखने योग्य
वैकल्पिक प्रॉपर्टी
blockingRuleId[] list नियमों के आईडी ब्लॉक किए जा रहे हैं. अगर सूची में शामिल कोई भी नियम सही के तौर पर आकलन करता है, तो टैग ट्रिगर नहीं होगा. लिखने योग्य
blockingTriggerId[] list ट्रिगर आईडी ब्लॉक करना. अगर सूची में मौजूद कोई भी ट्रिगर सही के तौर पर आकलन करता है, तो टैग ट्रिगर नहीं होगा. लिखने योग्य
firingRuleId[] list ट्रिगर करने के नियम के आईडी. टैग तब ट्रिगर होगा, जब सूची में शामिल कोई भी नियम सही हो और उसके सभी blockingRuleIds (अगर कोई नियम दिया गया हो) गलत हों. लिखने योग्य
firingTriggerId[] list ट्रिगर आईडी फ़ायर करना. टैग तब सक्रिय होगा, जब सूची में शामिल कोई भी ट्रिगर सही होगा और उसके सभी blockingTriggerIds (अगर कोई ट्रिगर बताया गया है) गलत होगा. लिखने योग्य
liveOnly boolean अगर इसे 'सही है' पर सेट किया जाता है, तो यह टैग सिर्फ़ लाइव एनवायरमेंट में ही सक्रिय होगा. उदाहरण के लिए, झलक या डीबग मोड में नहीं. लिखने योग्य
notes string कंटेनर में इस टैग को लागू करने के तरीके के बारे में उपयोगकर्ता की जानकारी. लिखने योग्य
parameter[] list टैग के पैरामीटर. लिखने योग्य
parameter[].key string नाम वाली कुंजी, जो किसी पैरामीटर की खास तौर पर पहचान करती है. टॉप-लेवल के पैरामीटर और मैप वैल्यू के लिए ज़रूरी है. सूची की वैल्यू के लिए अनदेखा किया जाता है. लिखने योग्य
parameter[].list[] list इस सूची में पैरामीटर के पैरामीटर (कुंजी को अनदेखा कर दिया जाएगा). लिखने योग्य
parameter[].map[] list इस मैप पैरामीटर के पैरामीटर (कुंजियां होनी चाहिए; कुंजियां यूनीक होनी चाहिए). लिखने योग्य
parameter[].value string पैरामीटर की वैल्यू (इसमें " जैसे वैरिएबल" जैसे वैरिएबल मौजूद हो सकते हैं. ये रेफ़रंस, दिए गए टाइप के हिसाब से सही हो सकते हैं. लिखने योग्य
paused boolean अगर टैग को रोका गया है, तो वैल्यू 'सही' होगी. लिखने योग्य
priority nested object टैग की संख्या के हिसाब से तय की गई प्राथमिकता. टैग, प्राथमिकता के हिसाब से एसिंक्रोनस तरीके से ट्रिगर किए जाते हैं. ज़्यादा संख्या वाली वैल्यू वाले टैग पहले सक्रिय होते हैं. टैग की प्राथमिकता, पॉज़िटिव या नेगेटिव, दोनों हो सकती है. डिफ़ॉल्ट वैल्यू 0 है. लिखने योग्य
priority.key string नाम वाली कुंजी, जो किसी पैरामीटर की खास तौर पर पहचान करती है. टॉप-लेवल के पैरामीटर और मैप वैल्यू के लिए ज़रूरी है. सूची की वैल्यू के लिए अनदेखा किया जाता है. लिखने योग्य
priority.list[] list इस सूची में पैरामीटर के पैरामीटर (कुंजी को अनदेखा कर दिया जाएगा). लिखने योग्य
priority.map[] list इस मैप पैरामीटर के पैरामीटर (कुंजियां होनी चाहिए; कुंजियां यूनीक होनी चाहिए). लिखने योग्य
priority.value string पैरामीटर की वैल्यू (इसमें " जैसे वैरिएबल" जैसे वैरिएबल मौजूद हो सकते हैं. ये रेफ़रंस, दिए गए टाइप के हिसाब से सही हो सकते हैं. लिखने योग्य
scheduleEndMs long किसी टैग को शेड्यूल करने के लिए, खत्म होने का टाइमस्टैंप - मिलीसेकंड में. लिखने योग्य
scheduleStartMs long किसी टैग को शेड्यूल करने के लिए, मिलीसेकंड में शुरुआती टाइमस्टैंप. लिखने योग्य

जवाब

अगर अनुरोध स्वीकार किया जाता है, तो यह तरीका रिस्पॉन्स के मुख्य हिस्से में टैग रिसॉर्स दिखाता है.

उदाहरण

ध्यान दें: इस तरीके के लिए दिए गए कोड के उदाहरणों में इसके साथ काम करने वाली सभी प्रोग्रामिंग भाषाएं नहीं दिखाई गई हैं (इसके साथ काम करने वाली भाषाओं की सूची के लिए क्लाइंट लाइब्रेरी वाला पेज देखें).

Java

Java क्लाइंट लाइब्रेरी का इस्तेमाल करता है.

/*
 * Note: This code assumes you have an authorized tagmanager service object.
 */

/*
 * This request creates a new tag.
 */

// Construct the parameters.
Parameter arg0 = new Parameter();
arg0.setType("template");
arg0.setKey("trackingId");
arg0.setValue("UA-123456-1");

Parameter arg1 = new Parameter();
arg1.setType("template");
arg1.setKey("type");
arg1.setValue("TRACK_TRANSACTION");

// Construct the tag object.
Tag tag = new Tag();
tag.setName("Sample Universal Analytics Tag");
tag.setType("ua");
tag.setLiveOnly(false);
tag.setParameter(Arrays.asList(arg0, arg1));

try {
  Tag response = tagmanager.accounts().containers().
      tags().create("123456", "54321", tag).execute();

} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}


/*
 * The results of the create method are stored in response object.
 * The following code shows how to access the created id and fingerprint.
 */
System.out.println("Tag id = " + response.getTagId());
System.out.println("Tag Fingerprint = " + response.getFingerprint());

Python

Python क्लाइंट लाइब्रेरी का इस्तेमाल करता हो.

# Note: This code assumes you have an authorized tagmanager service object.

# This request creates a new container tag.
try:
  response = tagmanager.accounts().containers().tags().create(
      accountId='123456',
      containerId='54321',
      body={
          'name': 'Universal Analytics Tag',
          'type': 'ua',
          'liveOnly': False,
          'parameter': [
              {
                  'type': 'template',
                  'key': 'trackingId',
                  'value': 'UA-123456-1'
              },
              {
                  'type': 'template',
                  'key': 'type',
                  'value': 'TRACK_TRANSACTION'
              }
          ]
      }
  ).execute()

except TypeError, error:
  # Handle errors in constructing a query.
  print 'There was an error in constructing your query : %s' % error

except HttpError, error:
  # Handle API errors.
  print ('There was an API error : %s : %s' %
         (error.resp.status, error.resp.reason))

# The results of the create method are stored in the response object.
# The following code shows how to access the created id and fingerprint.
print response.get('tagId')
print response.get('fingerprint')

इसे आज़माएं!

इस तरीके को लाइव डेटा पर कॉल करने और रिस्पॉन्स देखने के लिए, नीचे दिए गए एपीआई एक्सप्लोरर का इस्तेमाल करें.