Tags: create

تنشئ علامة "إدارة العلامات من Google". تجربة ذلك الآن

الطلب

طلب HTTP

POST https://www.googleapis.com/tagmanager/v2/+parent/tags

المَعلمات

اسم المعلَمة القيمة الوصف
مَعلمات المسار
parent string هو المسار النسبي لواجهة برمجة التطبيقات في GTM Workspace. مثال: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}

التفويض

يتطلب هذا الطلب تفويضًا بالنطاق التالي:

النطاق
https://www.googleapis.com/auth/tagmanager.edit.containers

للحصول على مزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.

نص الطلب

في نص الطلب، يمكنك توفير مورد العلامات بالسمات التالية:

اسم الموقع القيمة الوصف Notes
الخصائص المطلوبة
consentSettings.consentType.type string نوع المَعلمة. القيم الصالحة هي:
  • boolean: تمثّل القيمة قيمة منطقية، يتم تمثيلها على أنّها "صحيح" أو "خطأ"
  • integer: تمثل القيمة قيمة عدد صحيح موقّعة 64 بت، في الأساس 10
  • list: يجب تحديد قائمة بالمعلَمات
  • map: يجب تحديد خريطة للمعلَمات.
  • template: تمثّل القيمة أي نص، ويمكن أن تشمل مراجع المتغيّرة (حتى مراجع المتغيّرات التي قد تعرض أنواعًا غير سلاسل نصية).
  • trigger_reference: تمثّل القيمة مشغِّلاً، ويتم تمثيله على أنّه رقم تعريف المشغِّل.
  • tag_reference: تمثّل القيمة علامة، ويتم تمثيلها باسم العلامة.


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


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


القيم المقبولة هي:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
قابل للكتابة
priority.type string نوع المَعلمة. القيم الصالحة هي:
  • boolean: تمثّل القيمة قيمة منطقية، يتم تمثيلها على أنّها "صحيح" أو "خطأ"
  • integer: تمثل القيمة قيمة عدد صحيح موقّعة 64 بت، في الأساس 10
  • list: يجب تحديد قائمة بالمعلَمات
  • map: يجب تحديد خريطة للمعلَمات.
  • template: تمثّل القيمة أي نص، ويمكن أن تشمل مراجع المتغيّرة (حتى مراجع المتغيّرات التي قد تعرض أنواعًا غير سلاسل نصية).
  • trigger_reference: تمثّل القيمة مشغِّلاً، ويتم تمثيله على أنّه رقم تعريف المشغِّل.
  • tag_reference: تمثّل القيمة علامة، ويتم تمثيلها باسم العلامة.


القيم المقبولة هي:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
قابل للكتابة
type string نوع علامة إدارة العلامات من Google قابل للكتابة
الخصائص الاختيارية
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 وفي حال ضبطها على "صحيح"، لن يتم تنشيط هذه العلامة إلا في البيئة المباشرة (على سبيل المثال، لن تكون في وضع المعاينة أو تصحيح الأخطاء). قابل للكتابة
monitoringMetadata nested object خريطة لأزواج المفتاح/القيمة للبيانات الوصفية للعلامات التي سيتم تضمينها في بيانات الحدث لمراقبة العلامة. ملاحظات:
  • يجب أن تكون هذه المَعلمة من النوع MAP.
  • كل مَعلمة في الخريطة من النوع TEMPLATE، ومع ذلك لا يمكن أن تحتوي على مراجع المتغيّرات.
قابل للكتابة
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 الطابع الزمني للبدء بالمللي ثانية لجدولة علامة. قابل للكتابة

الإجابة

وفي حال نجاحها، تعرِض هذه الطريقة مورد العلامات في نص الاستجابة.

تجربة

يمكنك استخدام مستكشف واجهات برمجة التطبيقات أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الاستجابة.