Macros: create

অনুমোদন প্রয়োজন

একটি GTM ম্যাক্রো তৈরি করে। এখন এটি চেষ্টা করুন বা একটি উদাহরণ দেখুন

অনুরোধ

HTTP অনুরোধ

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 পরামিতি প্রকার। বৈধ মান হল:
  • boolean : মানটি একটি বুলিয়ানকে উপস্থাপন করে, যা 'সত্য' বা 'মিথ্যা' হিসাবে উপস্থাপিত হয়
  • integer : মানটি ভিত্তি 10-এ একটি 64-বিট স্বাক্ষরিত পূর্ণসংখ্যার মান উপস্থাপন করে
  • list : পরামিতিগুলির একটি তালিকা নির্দিষ্ট করা উচিত
  • map : পরামিতিগুলির একটি মানচিত্র নির্দিষ্ট করা উচিত
  • template : মান যে কোনো টেক্সট প্রতিনিধিত্ব করে; এর মধ্যে ম্যাক্রো রেফারেন্স অন্তর্ভুক্ত থাকতে পারে (এমনকি ম্যাক্রো রেফারেন্স যা নন-স্ট্রিং প্রকার ফেরত দিতে পারে)


গ্রহণযোগ্য মান হল:
  • " boolean "
  • " integer "
  • " list "
  • " map "
  • " template "
লিখনযোগ্য
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 একটি ম্যাক্রো শিডিউল করতে মিলিসেকেন্ডে শুরু টাইমস্ট্যাম্প৷ লিখনযোগ্য

প্রতিক্রিয়া

সফল হলে, এই পদ্ধতিটি প্রতিক্রিয়া বডিতে একটি ম্যাক্রো সংস্থান প্রদান করে।

উদাহরণ

দ্রষ্টব্য: এই পদ্ধতির জন্য উপলব্ধ কোড উদাহরণগুলি সমস্ত সমর্থিত প্রোগ্রামিং ভাষার প্রতিনিধিত্ব করে না (সমর্থিত ভাষার তালিকার জন্য ক্লায়েন্ট লাইব্রেরি পৃষ্ঠা দেখুন)।

জাভা

জাভা ক্লায়েন্ট লাইব্রেরি ব্যবহার করে।

/*
 * 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());

পাইথন

পাইথন ক্লায়েন্ট লাইব্রেরি ব্যবহার করে।

# 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')

এটা চেষ্টা করুন!

লাইভ ডেটাতে এই পদ্ধতিতে কল করতে এবং প্রতিক্রিয়া দেখতে নীচের APIs এক্সপ্লোরার ব্যবহার করুন।