تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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
}

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

الطُرق

إنشاء: لإنشاء إصدار حاوية.
حذف: حذف إصدار حاوية.
الحصول على: الحصول على إصدار حاوية.
list: تعرض جميع إصدارات الحاوية لحاوية GTM.
publish: نشر إصدار حاوية.
استعادة: استعادة إصدار حاوية. وسيؤدي هذا إلى استبدال الإعدادات الحالية للحاوية (بما في ذلك المتغيّرات والعوامل المُشغِّلة والعلامات). ولن يكون للعملية أي تأثير على الإصدار الذي يتم عرضه (أي الإصدار المنشور).
undelete: لإلغاء حذف إصدار حاوية.
تعديل: تحديث إصدار حاوية.