Variables: create

یک متغیر GTM ایجاد می کند. الآن امتحانش کن .

درخواست

درخواست HTTP

POST https://www.googleapis.com/tagmanager/v2/+parent/variables

مولفه های

نام پارامتر ارزش شرح
پارامترهای مسیر
parent string مسیر نسبی API GTM Workspace. مثال: accounts/{account_id}/containers/{container_id}/workspace/{workspace_id}

مجوز

این درخواست به مجوز با محدوده زیر نیاز دارد:

محدوده
https://www.googleapis.com/auth/tagmanager.edit.containers

برای اطلاعات بیشتر، به صفحه احراز هویت و مجوز مراجعه کنید.

درخواست بدن

در بدنه درخواست، یک منبع متغیرها با ویژگی های زیر ارائه کنید:

نام ملک ارزش شرح یادداشت
خواص مورد نیاز
formatValue.convertFalseToValue. type string نوع پارامتر مقادیر معتبر عبارتند از:
  • boolean : مقدار یک بولی را نشان می دهد که به صورت "درست" یا "نادرست" نمایش داده می شود.
  • integer : این مقدار یک مقدار عدد صحیح امضا شده 64 بیتی را در پایه 10 نشان می دهد
  • list : لیستی از پارامترها باید مشخص شود
  • map : یک نقشه از پارامترها باید مشخص شود
  • template : مقدار هر متنی را نشان می دهد. این می تواند شامل مراجع متغیر باشد (حتی مراجع متغیری که ممکن است انواع غیر رشته ای را برگرداند)
  • trigger_reference : مقدار نشان دهنده یک ماشه است که به عنوان شناسه ماشه نشان داده می شود
  • tag_reference : مقدار نشان دهنده یک برچسب است که به عنوان نام برچسب نشان داده می شود


مقادیر قابل قبول عبارتند از:
  • " boolean "
  • " integer "
  • " list "
  • " map "
  • " tagReference "
  • " template "
  • " triggerReference "
  • " typeUnspecified "
 قابل نوشتن
formatValue.convertNullToValue. type string نوع پارامتر مقادیر معتبر عبارتند از:
  • boolean : مقدار یک بولی را نشان می دهد که به صورت "درست" یا "نادرست" نمایش داده می شود.
  • integer : این مقدار یک مقدار عدد صحیح امضا شده 64 بیتی را در پایه 10 نشان می دهد
  • list : لیستی از پارامترها باید مشخص شود
  • map : یک نقشه از پارامترها باید مشخص شود
  • template : مقدار هر متنی را نشان می دهد. این می تواند شامل مراجع متغیر باشد (حتی مراجع متغیری که ممکن است انواع غیر رشته ای را برگرداند)
  • trigger_reference : مقدار نشان دهنده یک ماشه است که به عنوان شناسه ماشه نشان داده می شود
  • tag_reference : مقدار نشان دهنده یک برچسب است که به عنوان نام برچسب نشان داده می شود


مقادیر قابل قبول عبارتند از:
  • " boolean "
  • " integer "
  • " list "
  • " map "
  • " tagReference "
  • " template "
  • " triggerReference "
  • " typeUnspecified "
 قابل نوشتن
formatValue.convertTrueToValue. type string نوع پارامتر مقادیر معتبر عبارتند از:
  • boolean : مقدار یک بولی را نشان می دهد که به صورت "درست" یا "نادرست" نمایش داده می شود.
  • integer : این مقدار یک مقدار عدد صحیح امضا شده 64 بیتی را در پایه 10 نشان می دهد
  • list : لیستی از پارامترها باید مشخص شود
  • map : یک نقشه از پارامترها باید مشخص شود
  • template : مقدار هر متنی را نشان می دهد. این می تواند شامل مراجع متغیر باشد (حتی مراجع متغیری که ممکن است انواع غیر رشته ای را برگرداند)
  • trigger_reference : مقدار نشان دهنده یک ماشه است که به عنوان شناسه ماشه نشان داده می شود
  • tag_reference : مقدار نشان دهنده یک برچسب است که به عنوان نام برچسب نشان داده می شود


مقادیر قابل قبول عبارتند از:
  • " boolean "
  • " integer "
  • " list "
  • " map "
  • " tagReference "
  • " template "
  • " triggerReference "
  • " typeUnspecified "
 قابل نوشتن
formatValue.convertUndefinedToValue. type string نوع پارامتر مقادیر معتبر عبارتند از:
  • boolean : مقدار یک بولی را نشان می دهد که به صورت "درست" یا "نادرست" نمایش داده می شود.
  • integer : این مقدار یک مقدار عدد صحیح امضا شده 64 بیتی را در پایه 10 نشان می دهد
  • list : لیستی از پارامترها باید مشخص شود
  • map : یک نقشه از پارامترها باید مشخص شود
  • template : مقدار هر متنی را نشان می دهد. این می تواند شامل مراجع متغیر باشد (حتی مراجع متغیری که ممکن است انواع غیر رشته ای را برگرداند)
  • trigger_reference : مقدار نشان دهنده یک ماشه است که به عنوان شناسه ماشه نشان داده می شود
  • tag_reference : مقدار نشان دهنده یک برچسب است که به عنوان نام برچسب نشان داده می شود


مقادیر قابل قبول عبارتند از:
  • " boolean "
  • " integer "
  • " list "
  • " map "
  • " tagReference "
  • " template "
  • " triggerReference "
  • " typeUnspecified "
 قابل نوشتن
name string نام نمایشی متغیر قابل نوشتن
parameter[]. type string نوع پارامتر مقادیر معتبر عبارتند از:
  • boolean : مقدار یک بولی را نشان می دهد که به صورت "درست" یا "نادرست" نمایش داده می شود.
  • integer : این مقدار یک مقدار عدد صحیح امضا شده 64 بیتی را در پایه 10 نشان می دهد
  • list : لیستی از پارامترها باید مشخص شود
  • map : یک نقشه از پارامترها باید مشخص شود
  • template : مقدار هر متنی را نشان می دهد. این می تواند شامل مراجع متغیر باشد (حتی مراجع متغیری که ممکن است انواع غیر رشته ای را برگرداند)
  • trigger_reference : مقدار نشان دهنده یک ماشه است که به عنوان شناسه ماشه نشان داده می شود
  • tag_reference : مقدار نشان دهنده یک برچسب است که به عنوان نام برچسب نشان داده می شود


مقادیر قابل قبول عبارتند از:
  • " boolean "
  • " integer "
  • " list "
  • " map "
  • " tagReference "
  • " template "
  • " triggerReference "
  • " typeUnspecified "
 قابل نوشتن
type string نوع متغیر GTM. قابل نوشتن
ویژگی های اختیاری
disablingTriggerId[] list فقط برای کانتینرهای موبایل: فهرستی از شناسه‌های ماشه برای غیرفعال کردن متغیرهای شرطی. متغیر در صورتی فعال می شود که یکی از تریگرهای فعال کننده درست باشد در حالی که همه محرک های غیرفعال کننده نادرست باشند. به عنوان یک مجموعه نامرتب رفتار می شود. قابل نوشتن
enablingTriggerId[] list فقط برای کانتینرهای موبایل: فهرستی از شناسه‌های راه‌انداز برای فعال کردن متغیرهای شرطی. متغیر در صورتی فعال می شود که یکی از محرک های فعال کننده درست باشد در حالی که همه محرک های غیرفعال نادرست باشند. به عنوان یک مجموعه نامرتب رفتار می شود. قابل نوشتن
formatValue.convertFalseToValue. key string کلید نامگذاری شده که به طور منحصر به فرد یک پارامتر را شناسایی می کند. برای پارامترهای سطح بالا و همچنین مقادیر نقشه مورد نیاز است. برای مقادیر لیست نادیده گرفته شد. قابل نوشتن
formatValue.convertFalseToValue. list[] list پارامترهای این پارامتر فهرست (کلیدها نادیده گرفته خواهند شد). قابل نوشتن
formatValue.convertFalseToValue. map[] list پارامترهای این پارامتر نقشه (باید کلید داشته باشد؛ کلیدها باید منحصر به فرد باشند). قابل نوشتن
formatValue.convertFalseToValue. value string مقدار یک پارامتر (ممکن است حاوی ارجاعات متغیری مانند "") متناسب با نوع مشخص شده باشد. قابل نوشتن
formatValue.convertNullToValue. key string کلید نامگذاری شده که به طور منحصر به فرد یک پارامتر را شناسایی می کند. برای پارامترهای سطح بالا و همچنین مقادیر نقشه مورد نیاز است. برای مقادیر لیست نادیده گرفته شد. قابل نوشتن
formatValue.convertNullToValue. list[] list پارامترهای این پارامتر فهرست (کلیدها نادیده گرفته خواهند شد). قابل نوشتن
formatValue.convertNullToValue. map[] list پارامترهای این پارامتر نقشه (باید کلید داشته باشد؛ کلیدها باید منحصر به فرد باشند). قابل نوشتن
formatValue.convertNullToValue. value string مقدار یک پارامتر (ممکن است حاوی ارجاعات متغیری مانند "") متناسب با نوع مشخص شده باشد. قابل نوشتن
formatValue.convertTrueToValue. key string کلید نامگذاری شده که به طور منحصر به فرد یک پارامتر را شناسایی می کند. برای پارامترهای سطح بالا و همچنین مقادیر نقشه مورد نیاز است. برای مقادیر لیست نادیده گرفته شد. قابل نوشتن
formatValue.convertTrueToValue. list[] list پارامترهای این پارامتر فهرست (کلیدها نادیده گرفته خواهند شد). قابل نوشتن
formatValue.convertTrueToValue. map[] list پارامترهای این پارامتر نقشه (باید کلید داشته باشد؛ کلیدها باید منحصر به فرد باشند). قابل نوشتن
formatValue.convertTrueToValue. value string مقدار یک پارامتر (ممکن است حاوی ارجاعات متغیری مانند "") متناسب با نوع مشخص شده باشد. قابل نوشتن
formatValue.convertUndefinedToValue. key string کلید نامگذاری شده که به طور منحصر به فرد یک پارامتر را شناسایی می کند. برای پارامترهای سطح بالا و همچنین مقادیر نقشه مورد نیاز است. برای مقادیر لیست نادیده گرفته شد. قابل نوشتن
formatValue.convertUndefinedToValue. list[] list پارامترهای این پارامتر فهرست (کلیدها نادیده گرفته خواهند شد). قابل نوشتن
formatValue.convertUndefinedToValue. map[] list پارامترهای این پارامتر نقشه (باید کلید داشته باشد؛ کلیدها باید منحصر به فرد باشند). قابل نوشتن
formatValue.convertUndefinedToValue. value string مقدار یک پارامتر (ممکن است حاوی ارجاعات متغیری مانند "") متناسب با نوع مشخص شده باشد. قابل نوشتن
notes string یادداشت های کاربر در مورد نحوه اعمال این متغیر در ظرف. قابل نوشتن
parameter[] list پارامترهای متغیر قابل نوشتن
parameter[]. key string کلید نامگذاری شده که به طور منحصر به فرد یک پارامتر را شناسایی می کند. برای پارامترهای سطح بالا و همچنین مقادیر نقشه مورد نیاز است. برای مقادیر لیست نادیده گرفته شد. قابل نوشتن
parameter[]. list[] list پارامترهای این پارامتر فهرست (کلیدها نادیده گرفته خواهند شد). قابل نوشتن
parameter[]. map[] list پارامترهای این پارامتر نقشه (باید کلید داشته باشد؛ کلیدها باید منحصر به فرد باشند). قابل نوشتن
parameter[]. value string مقدار یک پارامتر (ممکن است حاوی ارجاعات متغیری مانند "") متناسب با نوع مشخص شده باشد. قابل نوشتن
scheduleEndMs long مهر زمانی پایان در میلی ثانیه برای برنامه ریزی یک متغیر. قابل نوشتن
scheduleStartMs long مهر زمان شروع در میلی ثانیه برای برنامه ریزی یک متغیر. قابل نوشتن

واکنش

در صورت موفقیت آمیز بودن، این روش یک منبع متغیرها را در بدنه پاسخ برمی گرداند.

آن را امتحان کنید!

از APIs Explorer زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید.