Container Versions

نسخه های کانتینر یک ظرف. یک نسخه کانتینر را می توان به عنوان یک کپی (عکس فوری) تغییرناپذیر از پیکربندی یک کانتینر در یک زمان خاص در نظر گرفت. ایجاد یک نسخه جدید با استفاده از روش create ، یک نسخه بر اساس پیکربندی فعلی (یعنی ماکروها، قوانین و برچسب‌های کانتینر) ایجاد می‌کند. روش restore پیکربندی کانتینر را با استفاده از نسخه مشخص شده بازیابی می کند. روش update امکان به‌روزرسانی name و فیلدهای notes نسخه را فراهم می‌کند. برای واکشی نسخه منتشر شده فعلی، از متد get استفاده کنید و published برای containerVersionId مشخص کنید.

برای لیست روش های این منبع، انتهای این صفحه را ببینید.

بازنمایی منابع

یک نسخه ظرف Google Tag Manager را نشان می دهد.

{
  "accountId": string,
  "containerId": string,
  "containerVersionId": string,
  "name": string,
  "deleted": boolean,
  "notes": string,
  "container": accounts.containers Resource,
  "macro": [
    {
      "accountId": string,
      "containerId": string,
      "macroId": string,
      "name": string,
      "type": string,
      "notes": string,
      "scheduleStartMs": long,
      "scheduleEndMs": long,
      "parameter": [
        {
          "type": string,
          "key": string,
          "value": string,
          "list": [
            (Parameter)
          ],
          "map": [
            (Parameter)
          ]
        }
      ],
      "enablingRuleId": [
        string
      ],
      "disablingRuleId": [
        string
      ],
      "fingerprint": string,
      "parentFolderId": string
    }
  ],
  "rule": [
    {
      "accountId": string,
      "containerId": string,
      "ruleId": string,
      "name": string,
      "notes": string,
      "condition": [
        {
          "type": string,
          "parameter": [
            {
              "type": string,
              "key": string,
              "value": string,
              "list": [
                (Parameter)
              ],
              "map": [
                (Parameter)
              ]
            }
          ]
        }
      ],
      "fingerprint": string
    }
  ],
  "tag": [
    accounts.containers.tags Resource
  ],
  "trigger": [
    accounts.containers.triggers Resource
  ],
  "variable": [
    accounts.containers.variables Resource
  ],
  "folder": [
    accounts.containers.folders Resource
  ],
  "fingerprint": string
}

نام ملک	ارزش	شرح	یادداشت
accountId	string	شناسه حساب GTM.
container	nested object	ظرفی که این نسخه از آن گرفته شده است.
containerId	string	شناسه کانتینر GTM.
containerVersionId	string	containerVersionId به طور منحصر به فرد نسخه کانتینر GTM را شناسایی می کند.
deleted	boolean	مقدار true نشان می دهد که این نسخه کانتینر حذف شده است.
fingerprint	string	اثر انگشت نسخه ظرف GTM همانطور که در زمان ذخیره سازی محاسبه می شود. هر زمان که نسخه کانتینر اصلاح شود، این مقدار مجدداً محاسبه می شود.
folder[]	list	پوشه‌های موجود در ظرفی که این نسخه از آن‌ها گرفته شده است.
macro[]	list	ماکروهای موجود در ظرفی که این نسخه از آن گرفته شده است.
macro[]. accountId	string	شناسه حساب GTM.
macro[]. containerId	string	شناسه کانتینر GTM.
macro[]. disablingRuleId[]	list	فقط برای کانتینرهای موبایل: فهرستی از شناسه‌های قانون برای غیرفعال کردن ماکروهای شرطی. اگر یکی از قوانین فعال کننده درست باشد، ماکرو فعال می شود در حالی که همه قوانین غیرفعال نادرست هستند. به عنوان یک مجموعه نامرتب رفتار می شود.
macro[]. enablingRuleId[]	list	فقط برای کانتینرهای موبایل: فهرستی از شناسه‌های قانون برای فعال کردن ماکروهای شرطی. اگر یکی از قوانین فعال کننده درست باشد، ماکرو فعال می شود در حالی که همه قوانین غیرفعال نادرست هستند. به عنوان یک مجموعه نامرتب رفتار می شود.
macro[]. fingerprint	string	اثر انگشت GTM Macro همانطور که در زمان ذخیره سازی محاسبه می شود. هر زمان که ماکرو اصلاح شود، این مقدار مجدداً محاسبه می شود.
macro[]. macroId	string	شناسه ماکرو به طور منحصر به فرد GTM Macro را شناسایی می کند.
macro[]. name	string	نام نمایشی ماکرو
macro[]. notes	string	یادداشت های کاربر در مورد نحوه اعمال این ماکرو در ظرف.
macro[]. parameter[]	list	پارامترهای ماکرو
macro[].parameter[]. key	string	کلید نامگذاری شده که به طور منحصر به فرد یک پارامتر را شناسایی می کند. برای پارامترهای سطح بالا و همچنین مقادیر نقشه مورد نیاز است. برای مقادیر لیست نادیده گرفته شد.	قابل نوشتن
macro[].parameter[]. list[]	list	پارامترهای این پارامتر فهرست (کلیدها نادیده گرفته خواهند شد).	قابل نوشتن
macro[].parameter[]. map[]	list	پارامترهای این پارامتر نقشه (باید کلید داشته باشد؛ کلیدها باید منحصر به فرد باشند).	قابل نوشتن
macro[].parameter[]. type	string	نوع پارامتر مقادیر معتبر عبارتند از: boolean : مقدار یک بولی را نشان می دهد که به صورت "درست" یا "نادرست" نمایش داده می شود. integer : این مقدار یک مقدار عدد صحیح امضا شده 64 بیتی را در پایه 10 نشان می دهد list : لیستی از پارامترها باید مشخص شود map : یک نقشه از پارامترها باید مشخص شود template : مقدار هر متنی را نشان می دهد. این می تواند شامل مراجع متغیر باشد (حتی مراجع متغیری که ممکن است انواع غیر رشته ای را برگرداند) trigger_reference : مقدار نشان دهنده یک ماشه است که به عنوان شناسه ماشه نشان داده می شود مقادیر قابل قبول عبارتند از: " boolean " " integer " " list " " map " " template " " triggerReference "	قابل نوشتن
macro[].parameter[]. value	string	مقدار یک پارامتر (ممکن است حاوی ارجاعات متغیری مانند "") متناسب با نوع مشخص شده باشد.	قابل نوشتن
macro[]. parentFolderId	string	شناسه پوشه والد
macro[]. scheduleEndMs	long	مهر زمان پایان در میلی ثانیه برای برنامه ریزی یک ماکرو.
macro[]. scheduleStartMs	long	مهر زمان شروع در میلی ثانیه برای برنامه ریزی یک ماکرو.
macro[]. type	string	نوع ماکرو GTM.
name	string	نام نمایشی نسخه کانتینر.	قابل نوشتن
notes	string	یادداشت های کاربر در مورد نحوه اعمال این نسخه ظرف در کانتینر.	قابل نوشتن
rule[]	list	قوانین موجود در ظرفی که این نسخه از آن گرفته شده است.
rule[]. accountId	string	شناسه حساب GTM.
rule[]. condition[]	list	فهرست شرایطی که این قانون را تشکیل می‌دهند (و ضمنی بین آنها).
rule[].condition[]. parameter[]	list	لیستی از پارامترهای نامگذاری شده (کلید/مقدار)، بسته به نوع شرایط. یادداشت: برای عملگرهای باینری، پارامترهایی به نام‌های arg0 و arg1 را برای تعیین عملوند چپ و راست به ترتیب درج کنید. در این زمان، عملوند سمت چپ ( arg0 ) باید مرجع یک متغیر باشد. برای تطبیق Regex غیر حساس به حروف بزرگ، یک پارامتر بولی به نام ignore_case که روی true تنظیم شده است، اضافه کنید. اگر مقدار دیگری مشخص یا تنظیم نشده باشد، تطبیق به حروف بزرگ و کوچک حساس خواهد بود. برای نفی یک عملگر، یک پارامتر بولی به نام پارامتر بولی negate که روی true تنظیم شده است.	قابل نوشتن
rule[].condition[].parameter[]. key	string	کلید نامگذاری شده که به طور منحصر به فرد یک پارامتر را شناسایی می کند. برای پارامترهای سطح بالا و همچنین مقادیر نقشه مورد نیاز است. برای مقادیر لیست نادیده گرفته شد.	قابل نوشتن
rule[].condition[].parameter[]. list[]	list	پارامترهای این پارامتر فهرست (کلیدها نادیده گرفته خواهند شد).	قابل نوشتن
rule[].condition[].parameter[]. map[]	list	پارامترهای این پارامتر نقشه (باید کلید داشته باشد؛ کلیدها باید منحصر به فرد باشند).	قابل نوشتن
rule[].condition[].parameter[]. type	string	نوع پارامتر مقادیر معتبر عبارتند از: boolean : مقدار یک بولی را نشان می دهد که به صورت "درست" یا "نادرست" نمایش داده می شود. integer : این مقدار یک مقدار عدد صحیح امضا شده 64 بیتی را در پایه 10 نشان می دهد list : لیستی از پارامترها باید مشخص شود map : یک نقشه از پارامترها باید مشخص شود template : مقدار هر متنی را نشان می دهد. این می تواند شامل مراجع متغیر باشد (حتی مراجع متغیری که ممکن است انواع غیر رشته ای را برگرداند) trigger_reference : مقدار نشان دهنده یک ماشه است که به عنوان شناسه ماشه نشان داده می شود مقادیر قابل قبول عبارتند از: " boolean " " integer " " list " " map " " template " " triggerReference "	قابل نوشتن
rule[].condition[].parameter[]. value	string	مقدار یک پارامتر (ممکن است حاوی ارجاعات متغیری مانند "") متناسب با نوع مشخص شده باشد.	قابل نوشتن
rule[].condition[]. type	string	نوع اپراتور برای این شرایط. مقادیر قابل قبول عبارتند از: " contains " " cssSelector " " endsWith " " equals " " greater " " greaterOrEquals " " less " " lessOrEquals " " matchRegex " " startsWith " " urlMatches "	قابل نوشتن
rule[]. containerId	string	شناسه کانتینر GTM.
rule[]. fingerprint	string	اثر انگشت قانون GTM همانطور که در زمان ذخیره سازی محاسبه می شود. هر زمان که قانون اصلاح شود، این مقدار مجدداً محاسبه می شود.
rule[]. name	string	نام نمایش قانون
rule[]. notes	string	یادداشت های کاربر در مورد نحوه اعمال این قانون در ظرف.
rule[]. ruleId	string	شناسه قانون به طور منحصر به فرد قانون GTM را شناسایی می کند.
tag[]	list	برچسب های موجود در ظرفی که این نسخه از آن گرفته شده است.
trigger[]	list	ماشه های موجود در ظرفی که این نسخه از آن گرفته شده است.
variable[]	list	متغیرهای موجود در ظرفی که این نسخه از آن گرفته شده است.

مواد و روش ها

ايجاد كردن

یک نسخه کانتینر ایجاد می کند.

حذف

یک نسخه کانتینر را حذف می کند.

گرفتن

نسخه کانتینری را دریافت می کند.

فهرست

تمام نسخه‌های کانتینر یک ظرف GTM را فهرست می‌کند.

انتشار

نسخه کانتینری را منتشر می کند.

بازگرداندن

یک نسخه کانتینر را بازیابی می کند. با این کار پیکربندی فعلی کانتینر (شامل متغیرها، محرک‌ها و برچسب‌های آن) بازنویسی می‌شود. این عملیات هیچ تاثیری بر نسخه ای که در حال ارائه است (یعنی نسخه منتشر شده) نخواهد داشت.

حذف کردن

یک نسخه ظرف را حذف می کند.

به روز رسانی

نسخه کانتینر را به روز می کند.