Container Versions

إصدارات الحاوية من الحاوية يمكن اعتبار إصدار الحاوية نسخة (لقطة) غير قابلة للتغيير من تهيئة الحاوية في وقت محدد. سيؤدي إنشاء إصدار جديد باستخدام الطريقة create إلى إنشاء إصدار استنادًا إلى الإعدادات الحالية (أي وحدات الماكرو والقواعد والعلامات في الحاوية). ستعيد الطريقة restore إعدادات الحاوية باستخدام الإصدار المحدّد. تسمح الطريقة update بتعديل حقلَي name وnotes في الإصدار. لاسترجاع الإصدار المنشور حاليًا، استخدِم الطريقة get وحدِّد published للسمة containerVersionId.

للحصول على قائمة من الطرق لهذا المورد، راجِع نهاية هذه الصفحة.

تمثيلات الموارد

يُمثِّل إصدار حاوية أداة "إدارة العلامات من Google".

{
  "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	رقم تعريف حساب "إدارة العلامات من Google"
container	nested object	الحاوية التي تم أخذ هذا الإصدار منها.
containerId	string	رقم تعريف حاوية Google Tag Manager
containerVersionId	string	يعرّف containerVersionId بشكلٍ فريد إصدار حاوية "إدارة العلامات من Google".
deleted	boolean	تشير القيمة "صحيح" إلى حذف إصدار الحاوية هذا.
fingerprint	string	الملف المرجعي لإصدار حاوية "إدارة العلامات من Google" وفقًا لما تم محسوبه في وقت التخزين تتم إعادة حساب هذه القيمة عند تعديل إصدار الحاوية.
folder[]	list	المجلدات المتوفرة في الحاوية التي تم الحصول على هذا الإصدار منها.
macro[]	list	وحدات الماكرو في الحاوية التي تم الحصول على هذا الإصدار منها.
macro[].accountId	string	رقم تعريف حساب "إدارة العلامات من Google"
macro[].containerId	string	رقم تعريف حاوية Google Tag Manager
macro[].disablingRuleId[]	list	بالنسبة إلى حاويات الأجهزة الجوّالة فقط: قائمة بأرقام تعريف القواعد لإيقاف وحدات الماكرو المشروطة. يتم تفعيل الماكرو في حال كانت إحدى قواعد التفعيل صحيحة بينما تكون جميع قواعد الإيقاف غير صحيحة. ويتم التعامل معها على أنّها مجموعة غير مرتَّبة.
macro[].enablingRuleId[]	list	لحاويات الأجهزة الجوّالة فقط: قائمة بأرقام تعريف القواعد لتفعيل وحدات الماكرو المشروطة، أو يتم تفعيل الماكرو في حال كانت إحدى قواعد التفعيل صحيحة بينما تكون جميع قواعد الإيقاف غير صحيحة. ويتم التعامل معها على أنّها مجموعة غير مرتَّبة.
macro[].fingerprint	string	بصمة ماكرو GTM كما تم حسابها في وقت التخزين. تتم إعادة حساب هذه القيمة عند تعديل وحدة الماكرو.
macro[].macroId	string	يعرّف معرف الماكرو ماكرو GTM بشكل فريد.
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: القيمة تمثل قيمة منطقية، ويتم تمثيلها على أنّها "صحيح" أو "false" 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	رقم تعريف حساب "إدارة العلامات من Google"
rule[].condition[]	list	قائمة الشروط التي تشكل هذه القاعدة (ضمنية AND بينها).
rule[].condition[].parameter[]	list	قائمة بالمَعلمات المُسمّاة (المفتاح/القيمة)، استنادًا إلى نوع الشرط. ملاحظات: بالنسبة إلى عوامل التشغيل الثنائية، يجب تضمين مَعلمتَين باسم arg0 وarg1 لتحديد المعاملَين الأيسر والأيمن على التوالي. في الوقت الحالي، يجب أن يكون المعامل الأيسر (arg0) مرجعًا لمتغيّر. بالنسبة إلى مطابقة التعبير العادي غير الحساسة لحالة الأحرف، أدرِج مَعلمة منطقية باسم 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: القيمة تمثل قيمة منطقية، ويتم تمثيلها على أنّها "صحيح" أو "false" 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	رقم تعريف حاوية Google Tag Manager
rule[].fingerprint	string	الملف المرجعي لقاعدة "إدارة العلامات من Google" وفقًا لما تم حسابه في وقت التخزين وتتم إعادة احتساب هذه القيمة عند تعديل القاعدة.
rule[].name	string	الاسم المعروض للقاعدة
rule[].notes	string	ملاحظات المستخدم حول كيفية تطبيق هذه القاعدة في الحاوية
rule[].ruleId	string	يعرّف "رقم تعريف القاعدة" قاعدة "إدارة العلامات من Google" بشكل فريد.
tag[]	list	العلامات الموجودة في الحاوية التي تم أخذ هذا الإصدار منها.
trigger[]	list	المشغِّلات في الحاوية التي تم أخذ هذا الإصدار منها.
variable[]	list	المتغيّرات في الحاوية التي تم أخذ هذا الإصدار منها.

الطُرق

إنشاء

تُنشئ إصدارًا للحاوية.

حذف

حذف إصدار الحاوية.

الحصول على

الحصول على إصدار حاوية.

list

تسرد جميع إصدارات حاويات حاوية GTM.

نشر

نشر إصدار حاوية.

استعادة

استعادة إصدار الحاوية. سيؤدي هذا إلى استبدال القيمة الحالية للحاوية التكوين (بما في ذلك المتغيرات والمشغلات والعلامات). العملية على الإصدار المعروض (أي النسخة المنشورة).

إلغاء الحذف

إلغاء حذف إصدار حاوية.

تعديل

يحدّث إصدار الحاوية.