لتعديل علامة "إدارة العلامات من 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 |
للحصول على مزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.
نص الطلب
في نص الطلب، يمكنك توفير مورد العلامات بالسمات التالية:
اسم الموقع | القيمة | الوصف | Notes |
---|---|---|---|
الخصائص المطلوبة | |||
consentSettings.consentType.type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
monitoringMetadata.type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
name |
string |
الإشارة إلى الاسم المعروض | قابل للكتابة |
parameter[].type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
priority.type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
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 |
خريطة لأزواج المفتاح/القيمة للبيانات الوصفية للعلامات التي سيتم تضمينها في بيانات الحدث لمراقبة العلامة. ملاحظات:
|
قابل للكتابة |
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 |
الطابع الزمني للبدء بالمللي ثانية لجدولة علامة. | قابل للكتابة |
الإجابة
وفي حال نجاحها، تعرِض هذه الطريقة مورد العلامات في نص الاستجابة.
تجربة
يمكنك استخدام مستكشف واجهات برمجة التطبيقات أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الاستجابة.