Tags: update

يعدِّل علامة "إدارة العلامات من Google". تجربة ذلك الآن

الطلب

طلب HTTP

PUT https://www.googleapis.com/tagmanager/v2/path

المعلمات

اسم المعلَمة القيمة الوصف
مَعلمات المسار
path string المسار النسبي لواجهة برمجة التطبيقات لعلامة GTM. مثال: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/tags/{tag_id}
مَعلمات طلب البحث الاختيارية
fingerprint string يجب أن تتطابق بصمة الإصبع هذه، عند توفيرها، مع بصمة الإصبع للعلامة في مساحة التخزين.

التفويض

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

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

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

نص الطلب

في نص الطلب، قدِّم موردًا للعلامات يتضمّن السمات التالية:

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


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


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


القيم المقبولة هي:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 قابل للكتابة
priority.type string نوع المَعلمة القيم الصالحة هي:
  • boolean: القيمة تمثل قيمة منطقية، ويتم تمثيلها على أنّها "صحيح" أو "false"
  • 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 الطابع الزمني للبدء بالملي ثانية لجدولة علامة. قابل للكتابة

الرد

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

جرّب الآن

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