इसके लिए, अनुमति लेना ज़रूरी है
एक GTM मैक्रो बनाता है. इसे अभी आज़माएं या उदाहरण देखें.
अनुरोध
एचटीटीपी अनुरोध
POST https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/macros
पैरामीटर
पैरामीटर का नाम | वैल्यू | ब्यौरा |
---|---|---|
पाथ पैरामीटर | ||
accountId |
string |
GTM खाता आईडी. |
containerId |
string |
GTM कंटेनर आईडी. |
अनुमति देना
इस अनुरोध के लिए नीचे दिए गए दायरे के साथ अनुमति की ज़रूरत है (पुष्टि करने और अनुमति देने के बारे में ज़्यादा पढ़ें).
स्कोप |
---|
https://www.googleapis.com/auth/tagmanager.edit.containers |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इन प्रॉपर्टी के साथ मैक्रो संसाधन उपलब्ध कराएं:
प्रॉपर्टी का नाम | वैल्यू | ब्यौरा | ज़रूरी जानकारी |
---|---|---|---|
ज़रूरी प्रॉपर्टी | |||
name |
string |
मैक्रो डिसप्ले नेम. | लिखने योग्य |
parameter[].type |
string |
पैरामीटर का टाइप. मान्य मान हैं:
स्वीकार की जाने वाली वैल्यू हैं:
|
लिखने योग्य |
type |
string |
GTM मैक्रो टाइप. | लिखने योग्य |
वैकल्पिक प्रॉपर्टी | |||
disablingRuleId[] |
list |
सिर्फ़ मोबाइल कंटेनर के लिए: शर्त के साथ मैक्रो को बंद करने के लिए नियम आईडी की सूची; मैक्रो को तब चालू किया जाता है, जब चालू करने का कोई नियम सही हो और सभी बंद करने के नियम गलत हों. इस सेट को बिना क्रम के माना जाता है. | लिखने योग्य |
enablingRuleId[] |
list |
सिर्फ़ मोबाइल कंटेनर के लिए: कंडिशनल मैक्रो को चालू करने के लिए नियम आईडी की सूची; मैक्रो को चालू करने से पहले, उसे चालू करने का कोई नियम सही होने पर और बंद करने के सभी नियम गलत होने पर, मैक्रो चालू हो जाता है. इस सेट को बिना क्रम के माना जाता है. | लिखने योग्य |
notes |
string |
कंटेनर में इस मैक्रो को लागू करने के तरीके के बारे में उपयोगकर्ता की जानकारी. | लिखने योग्य |
parameter[] |
list |
मैक्रो के पैरामीटर. | लिखने योग्य |
parameter[].key |
string |
नाम वाली कुंजी, जो किसी पैरामीटर की खास तौर पर पहचान करती है. टॉप-लेवल के पैरामीटर और मैप वैल्यू के लिए ज़रूरी है. सूची की वैल्यू के लिए अनदेखा किया जाता है. | लिखने योग्य |
parameter[].list[] |
list |
इस सूची में पैरामीटर के पैरामीटर (कुंजी को अनदेखा कर दिया जाएगा). | लिखने योग्य |
parameter[].map[] |
list |
इस मैप पैरामीटर के पैरामीटर (कुंजियां होनी चाहिए; कुंजियां यूनीक होनी चाहिए). | लिखने योग्य |
parameter[].value |
string |
पैरामीटर का मान (इसमें " जैसे मैक्रो संदर्भ शामिल हो सकते हैं") जो दिए गए टाइप के हिसाब से सही हैं. | लिखने योग्य |
scheduleEndMs |
long |
मैक्रो शेड्यूल करने के लिए, खत्म होने का टाइमस्टैंप मिलीसेकंड में. | लिखने योग्य |
scheduleStartMs |
long |
मैक्रो शेड्यूल करने के लिए शुरुआती टाइमस्टैंप, मिलीसेकंड में. | लिखने योग्य |
जवाब
कामयाब होने पर, यह तरीका रिस्पॉन्स के मुख्य हिस्से में मैक्रो संसाधन दिखाता है.
उदाहरण
ध्यान दें: इस तरीके के लिए दिए गए कोड के उदाहरणों में इसके साथ काम करने वाली सभी प्रोग्रामिंग भाषाएं नहीं दिखाई गई हैं (इसके साथ काम करने वाली भाषाओं की सूची के लिए क्लाइंट लाइब्रेरी वाला पेज देखें).
Java
Java क्लाइंट लाइब्रेरी का इस्तेमाल करता है.
/* * Note: This code assumes you have an authorized tagmanager service object. */ /* * This request creates a new macro for the authorized user. */ // Construct the macro object. Macro macro = new Macro(); macro.setName("Sample URL Macro"); macro.setType("u"); // Construct the parameters. Parameter arg0 = new Parameter(); arg0.setType("template"); arg0.setKey("component"); arg0.setValue("URL"); Parameter arg1 = new Parameter(); arg1.setType("template"); arg1.setKey("customUrlSource"); arg1.setValue("{{element}}"); // set the parameters on the macro. macro.setParameter(Arrays.asList(arg0, arg1)); try { Macro response = tagmanager.accounts(). containers().macros().create("123456", "54321", macro).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 the response object. * The following code shows how to access the created Id and Fingerprint. */ System.out.println("Macro Id = " + response.getMacroId()); System.out.println("Macro Fingerprint = " + response.getFingerprint());
Python
Python क्लाइंट लाइब्रेरी का इस्तेमाल करता हो.
# Note: This code assumes you have an authorized tagmanager service object. # This request creates a new macro for the authorized user. try: response = tagmanager.accounts().containers().macros().create( accountId='123456', containerId='54321', body={ 'name': 'Sample URL Macro', 'type': 'u', 'parameter': [ { 'type': 'template', 'key': 'component', 'value': 'URL' }, { 'type': 'template', 'key': 'customUrlSource', 'value': '{{element}}' } ] } ).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 'Macro Id = %s' % response.get('macroId') print 'Macro Fingerprint = %s' % response.get('fingerprint')
इसे आज़माएं!
इस तरीके को लाइव डेटा पर कॉल करने और रिस्पॉन्स देखने के लिए, नीचे दिए गए एपीआई एक्सप्लोरर का इस्तेमाल करें.