یک تگ GTM ایجاد می کند. اکنون آن را امتحان کنید .
درخواست کنید
درخواست HTTP
POST https://www.googleapis.com/tagmanager/v2/+parent/tags
پارامترها
نام پارامتر | ارزش | توضیحات |
---|---|---|
پارامترهای مسیر | ||
parent | string | مسیر نسبی API GTM Workspace. مثال: accounts/{account_id}/containers/{container_id}/workspace/{workspace_id} |
مجوز
این درخواست به مجوز با محدوده زیر نیاز دارد:
دامنه |
---|
https://www.googleapis.com/auth/tagmanager.edit.containers |
برای اطلاعات بیشتر، به صفحه احراز هویت و مجوز مراجعه کنید.
درخواست بدن
در بدنه درخواست، یک منبع برچسب با ویژگی های زیر ارائه کنید:
نام ملک | ارزش | توضیحات | یادداشت ها |
---|---|---|---|
خواص مورد نیاز | |||
consentSettings.consentType. type | string | نوع پارامتر مقادیر معتبر عبارتند از:
مقادیر قابل قبول عبارتند از:
| قابل نوشتن |
monitoringMetadata. type | string | نوع پارامتر مقادیر معتبر عبارتند از:
مقادیر قابل قبول عبارتند از:
| قابل نوشتن |
name | string | نام نمایشی برچسب | قابل نوشتن |
parameter[]. type | string | نوع پارامتر مقادیر معتبر عبارتند از:
مقادیر قابل قبول عبارتند از:
| قابل نوشتن |
priority. type | string | نوع پارامتر مقادیر معتبر عبارتند از:
مقادیر قابل قبول عبارتند از:
| قابل نوشتن |
type | string | نوع برچسب GTM | قابل نوشتن |
ویژگی های اختیاری | |||
blockingRuleId[] | list | مسدود کردن شناسه قوانین اگر هر یک از قوانین ذکر شده درست ارزیابی شود، تگ فعال نمی شود. | قابل نوشتن |
blockingTriggerId[] | list | مسدود کردن شناسه های ماشه اگر هر یک از محرک های فهرست شده درست ارزیابی شود، تگ فعال نمی شود. | قابل نوشتن |
consentSettings | nested object | تنظیمات رضایت یک برچسب | قابل نوشتن |
consentSettings.consentType. key | string | کلید نامگذاری شده که به طور منحصر به فرد یک پارامتر را شناسایی می کند. برای پارامترهای سطح بالا و همچنین مقادیر نقشه مورد نیاز است. برای مقادیر لیست نادیده گرفته شد. | قابل نوشتن |
consentSettings.consentType. list[] | list | پارامترهای این پارامتر فهرست (کلیدها نادیده گرفته خواهند شد). | قابل نوشتن |
consentSettings.consentType. map[] | list | پارامترهای این پارامتر نقشه (باید کلید داشته باشد؛ کلیدها باید منحصر به فرد باشند). | قابل نوشتن |
consentSettings.consentType. value | string | مقدار یک پارامتر (ممکن است حاوی ارجاعات متغیری مانند "") متناسب با نوع مشخص شده باشد. | قابل نوشتن |
firingRuleId[] | list | شناسه قوانین شلیک یک تگ زمانی فعال می شود که هر یک از قوانین فهرست شده درست باشد و همه blockingRuleIds آن (در صورت مشخص بودن) نادرست باشند. | قابل نوشتن |
firingTriggerId[] | list | فعال کردن شناسه های ماشه. یک برچسب زمانی فعال می شود که هر یک از محرک های فهرست شده درست باشد و تمام blockingTriggerIds آن (در صورت مشخص شدن) نادرست باشند. | قابل نوشتن |
liveOnly | boolean | اگر روی true تنظیم شود، این تگ فقط در محیط زنده فعال می شود (مثلاً در حالت پیش نمایش یا اشکال زدایی). | قابل نوشتن |
monitoringMetadata | nested object | نقشهای از جفتهای کلید-مقدار متادیتای برچسب که در دادههای رویداد برای نظارت بر برچسب گنجانده میشود. یادداشت ها:
| قابل نوشتن |
monitoringMetadata. key | string | کلید نامگذاری شده که به طور منحصر به فرد یک پارامتر را شناسایی می کند. برای پارامترهای سطح بالا و همچنین مقادیر نقشه مورد نیاز است. برای مقادیر لیست نادیده گرفته شد. | قابل نوشتن |
monitoringMetadata. list[] | list | پارامترهای این پارامتر فهرست (کلیدها نادیده گرفته خواهند شد). | قابل نوشتن |
monitoringMetadata. map[] | list | پارامترهای این پارامتر نقشه (باید کلید داشته باشد؛ کلیدها باید منحصر به فرد باشند). | قابل نوشتن |
monitoringMetadata. value | string | مقدار یک پارامتر (ممکن است حاوی ارجاعات متغیری مانند "") متناسب با نوع مشخص شده باشد. | قابل نوشتن |
monitoringMetadataTagNameKey | string | اگر خالی نباشد، نام نمایش برچسب با استفاده از کلید مشخص شده در نقشه ابرداده نظارتی گنجانده می شود. | قابل نوشتن |
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 | مهر زمان شروع در میلی ثانیه برای برنامه ریزی یک برچسب. | قابل نوشتن |
پاسخ
در صورت موفقیت آمیز بودن، این روش یک منبع Tags را در بدنه پاسخ باز می گرداند.
آن را امتحان کنید!
از APIs Explorer زیر برای فراخوانی این روش در دادههای زنده و دیدن پاسخ استفاده کنید.