Tags

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

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

تمثِّل علامة "إدارة العلامات من Google".

{
  "path": string,
  "accountId": string,
  "containerId": string,
  "workspaceId": string,
  "tagId": string,
  "name": string,
  "type": string,
  "firingRuleId": [
    string
  ],
  "blockingRuleId": [
    string
  ],
  "liveOnly": boolean,
  "priority": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ],
    "isWeakReference": boolean
  },
  "notes": string,
  "scheduleStartMs": long,
  "scheduleEndMs": long,
  "parameter": [
    {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ],
      "isWeakReference": boolean
    }
  ],
  "fingerprint": string,
  "firingTriggerId": [
    string
  ],
  "blockingTriggerId": [
    string
  ],
  "setupTag": [
    {
      "tagName": string,
      "stopOnSetupFailure": boolean
    }
  ],
  "teardownTag": [
    {
      "tagName": string,
      "stopTeardownOnFailure": boolean
    }
  ],
  "parentFolderId": string,
  "tagFiringOption": string,
  "tagManagerUrl": string,
  "paused": boolean,
  "monitoringMetadata": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ],
    "isWeakReference": boolean
  },
  "monitoringMetadataTagNameKey": string,
  "consentSettings": {
    "consentStatus": string,
    "consentType": {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ],
      "isWeakReference": boolean
    }
  }
}
اسم الموقع القيمة الوصف Notes
accountId string رقم تعريف حساب Google Tag Manager
blockingRuleId[] list أرقام تعريف قواعد الحظر إذا تم تقييم أي من القواعد المدرجة باعتبارها صحيحة، فلن يتم تنشيط العلامة. قابل للكتابة
blockingTriggerId[] list حظر معرِّفات المشغِّل إذا تم تقييم أي من العوامل المشغِّلة المدرجة على أنها صحيحة، لن يتم تنشيط العلامة. قابل للكتابة
consentSettings nested object إعدادات الموافقة لإحدى العلامات قابل للكتابة
consentSettings.consentStatus string حالة موافقة العلامة. في حال ضبط هذه السياسة على "مطلوب"، سيتحقق وقت التشغيل من أنّه تم منح أنواع الموافقة التي تحدّدها الحقل "consent_type".

القيم المقبولة هي:
  • "needed"
  • "notNeeded"
  • "notSet"
consentSettings.consentType nested object نوع الموافقات التي يجب التحقّق منها أثناء تنشيط العلامة إذا كانت في حالة "مطلوب الموافقة". يجب أن تكون هذه المعلمة من النوع LIST حيث يكون كل عنصر قائمة من النوع STRING.
consentSettings.consentType.isWeakReference boolean يشير ذلك إلى ما إذا كانت مَعلمة نوع المرجع تتم الإشارة إليها بشكل قوي أو ضعيف. لا يتم استخدامها إلا من خلال عمليات التحويل. قابل للكتابة
consentSettings.consentType.key string المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. قابل للكتابة
consentSettings.consentType.list[] list معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). قابل للكتابة
consentSettings.consentType.map[] list معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). قابل للكتابة
consentSettings.consentType.type string نوع المَعلمة. القيم الصالحة هي:
  • boolean: تمثّل القيمة قيمة منطقية، يتم تمثيلها على أنّها "صحيح" أو "خطأ"
  • integer: تمثل القيمة قيمة عدد صحيح موقّعة 64 بت، في الأساس 10
  • list: يجب تحديد قائمة بالمعلَمات
  • map: يجب تحديد خريطة للمعلَمات.
  • template: تمثّل القيمة أي نص، ويمكن أن تشمل مراجع المتغيّرة (حتى مراجع المتغيّرات التي قد تعرض أنواعًا غير سلاسل نصية).
  • trigger_reference: تمثّل القيمة مشغِّلاً، ويتم تمثيله على أنّه رقم تعريف المشغِّل.
  • tag_reference: تمثّل القيمة علامة، ويتم تمثيلها باسم العلامة.


القيم المقبولة هي:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
قابل للكتابة
consentSettings.consentType.value string قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. قابل للكتابة
containerId string رقم تعريف حاوية GTM.
fingerprint string الملف المرجعي لعلامة "إدارة العلامات من Google" كما هو محسوب في وقت التخزين. وتتم إعادة احتساب هذه القيمة كلما تم تعديل العلامة.
firingRuleId[] list أرقام تعريف قواعد التنشيط. يتم تنشيط العلامة عندما تكون أي من القواعد المدرَجة صحيحة وجميع blockingRuleIds (إن وجدت) الخاصة بها غير صحيحة. قابل للكتابة
firingTriggerId[] list معرّفات مشغِّل التنشيط سيتم تنشيط العلامة عندما يكون أي من العوامل المشغِّلة المدرجة صحيحًا وجميع قيم blockingTriggerIds (إن وُجدت) غير صحيحة. قابل للكتابة
liveOnly boolean وفي حال ضبطها على "صحيح"، لن يتم تنشيط هذه العلامة إلا في البيئة المباشرة (على سبيل المثال، لن تكون في وضع المعاينة أو تصحيح الأخطاء). قابل للكتابة
monitoringMetadata nested object خريطة لأزواج المفتاح/القيمة للبيانات الوصفية للعلامات التي سيتم تضمينها في بيانات الحدث لمراقبة العلامة. ملاحظات:
  • يجب أن تكون هذه المَعلمة من النوع MAP.
  • كل مَعلمة في الخريطة من النوع TEMPLATE، ومع ذلك لا يمكن أن تحتوي على مراجع المتغيّرات.
قابل للكتابة
monitoringMetadata.isWeakReference boolean يشير ذلك إلى ما إذا كانت مَعلمة نوع المرجع تتم الإشارة إليها بشكل قوي أو ضعيف. لا يتم استخدامها إلا من خلال عمليات التحويل. قابل للكتابة
monitoringMetadata.key string المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. قابل للكتابة
monitoringMetadata.list[] list معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). قابل للكتابة
monitoringMetadata.map[] list معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). قابل للكتابة
monitoringMetadata.type string نوع المَعلمة. القيم الصالحة هي:
  • boolean: تمثّل القيمة قيمة منطقية، يتم تمثيلها على أنّها "صحيح" أو "خطأ"
  • integer: تمثل القيمة قيمة عدد صحيح موقّعة 64 بت، في الأساس 10
  • list: يجب تحديد قائمة بالمعلَمات
  • map: يجب تحديد خريطة للمعلَمات.
  • template: تمثّل القيمة أي نص، ويمكن أن تشمل مراجع المتغيّرة (حتى مراجع المتغيّرات التي قد تعرض أنواعًا غير سلاسل نصية).
  • trigger_reference: تمثّل القيمة مشغِّلاً، ويتم تمثيله على أنّه رقم تعريف المشغِّل.
  • tag_reference: تمثّل القيمة علامة، ويتم تمثيلها باسم العلامة.


القيم المقبولة هي:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
قابل للكتابة
monitoringMetadata.value string قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. قابل للكتابة
monitoringMetadataTagNameKey string في حال عدم ترك الحقل فارغًا، سيتم تضمين الاسم المعروض للعلامة في خريطة البيانات الوصفية للتتبّع باستخدام المفتاح المحدّد. قابل للكتابة
name string الإشارة إلى الاسم المعروض قابل للكتابة
notes string ويوضّح المستخدم كيفية تطبيق هذه العلامة في الحاوية. قابل للكتابة
parameter[] list معلَمات العلامة. قابل للكتابة
parameter[].isWeakReference boolean يشير ذلك إلى ما إذا كانت مَعلمة نوع المرجع تتم الإشارة إليها بشكل قوي أو ضعيف. لا يتم استخدامها إلا من خلال عمليات التحويل. قابل للكتابة
parameter[].key string المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. قابل للكتابة
parameter[].list[] list معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). قابل للكتابة
parameter[].map[] list معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). قابل للكتابة
parameter[].type string نوع المَعلمة. القيم الصالحة هي:
  • boolean: تمثّل القيمة قيمة منطقية، يتم تمثيلها على أنّها "صحيح" أو "خطأ"
  • integer: تمثل القيمة قيمة عدد صحيح موقّعة 64 بت، في الأساس 10
  • list: يجب تحديد قائمة بالمعلَمات
  • map: يجب تحديد خريطة للمعلَمات.
  • template: تمثّل القيمة أي نص، ويمكن أن تشمل مراجع المتغيّرة (حتى مراجع المتغيّرات التي قد تعرض أنواعًا غير سلاسل نصية).
  • trigger_reference: تمثّل القيمة مشغِّلاً، ويتم تمثيله على أنّه رقم تعريف المشغِّل.
  • tag_reference: تمثّل القيمة علامة، ويتم تمثيلها باسم العلامة.


القيم المقبولة هي:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
قابل للكتابة
parameter[].value string قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. قابل للكتابة
parentFolderId string معرّف المجلد الرئيسي
path string هو المسار النسبي لواجهة برمجة التطبيقات لعلامة GTM.
paused boolean وتشير إلى ما إذا كانت العلامة متوقفة مؤقتًا، مما يمنع تنشيط العلامة. قابل للكتابة
priority nested object الأولوية الرقمية من تحديد المستخدم للعلامة. يتم تنشيط العلامات بشكلٍ غير متزامن بترتيب الأولوية. يتم تنشيط العلامات ذات القيمة الرقمية الأعلى أولاً. ويمكن أن تكون أولوية العلامة قيمة موجبة أو سلبية. القيمة التلقائية هي 0. قابل للكتابة
priority.isWeakReference boolean يشير ذلك إلى ما إذا كانت مَعلمة نوع المرجع تتم الإشارة إليها بشكل قوي أو ضعيف. لا يتم استخدامها إلا من خلال عمليات التحويل. قابل للكتابة
priority.key string المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. قابل للكتابة
priority.list[] list معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). قابل للكتابة
priority.map[] list معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). قابل للكتابة
priority.type string نوع المَعلمة. القيم الصالحة هي:
  • boolean: تمثّل القيمة قيمة منطقية، يتم تمثيلها على أنّها "صحيح" أو "خطأ"
  • integer: تمثل القيمة قيمة عدد صحيح موقّعة 64 بت، في الأساس 10
  • list: يجب تحديد قائمة بالمعلَمات
  • map: يجب تحديد خريطة للمعلَمات.
  • template: تمثّل القيمة أي نص، ويمكن أن تشمل مراجع المتغيّرة (حتى مراجع المتغيّرات التي قد تعرض أنواعًا غير سلاسل نصية).
  • trigger_reference: تمثّل القيمة مشغِّلاً، ويتم تمثيله على أنّه رقم تعريف المشغِّل.
  • tag_reference: تمثّل القيمة علامة، ويتم تمثيلها باسم العلامة.


القيم المقبولة هي:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
قابل للكتابة
priority.value string قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. قابل للكتابة
scheduleEndMs long الطابع الزمني للانتهاء بالمللي ثانية لجدولة علامة. قابل للكتابة
scheduleStartMs long الطابع الزمني للبدء بالمللي ثانية لجدولة علامة. قابل للكتابة
setupTag[] list قائمة علامات الإعداد. في الوقت الحالي، نسمح بعرض طلب واحد فقط.
setupTag[].stopOnSetupFailure boolean في حال اختيار القيمة "true"، يجب تنشيط العلامة الرئيسية إذا تم تنشيط علامة الإعداد بنجاح فقط. في حال اختيار القيمة "خطأ"، يمكنك تنشيط العلامة الرئيسية بغض النظر عن حالة تنشيط علامة الإعداد.
setupTag[].tagName string اسم علامة الإعداد
tagFiringOption string خيار لتنشيط هذه العلامة.

القيم المقبولة هي:
  • "oncePerEvent"
  • "oncePerLoad"
  • "tagFiringOptionUnspecified"
  • "unlimited"
tagId string يحدِّد رقم تعريف العلامة بشكلٍ فريد علامة "إدارة العلامات من Google".
tagManagerUrl string رابط مُنشأ تلقائيًا إلى واجهة مستخدم "إدارة العلامات"
teardownTag[] list قائمة علامات الإزالة. في الوقت الحالي، نسمح بعرض طلب واحد فقط.
teardownTag[].stopTeardownOnFailure boolean في حال اختيار القيمة "true"، ينبغي تنشيط علامة الإزالة النهائية إذا تم تنشيط العلامة الرئيسية بنجاح فقط. في حال اختيار القيمة "false"، قم بتنشيط علامة الإزالة بغض النظر عن حالة تنشيط العلامة الرئيسية.
teardownTag[].tagName string اسم علامة الإزالة.
type string نوع علامة إدارة العلامات من Google قابل للكتابة
workspaceId string رقم تعريف GTM Workspace

الطُرق

إنشاء
لإنشاء علامة GTM.
حذف
يؤدي هذا الإجراء إلى حذف علامة GTM.
الحصول على
يتم الحصول على علامة GTM.
list
تعرض جميع علامات GTM للحاوية.
revert
يؤدي هذا الإجراء إلى العودة إلى التغييرات التي تم إجراؤها على علامة "إدارة العلامات من Google" في مساحة عمل GTM.
تعديل
تعديل علامة "إدارة العلامات من Google"