يجب تقديم تفويض
لتعديل مشغِّل GTM جرِّبه الآن أو شاهد مثالاً.
الطلب
طلب HTTP
PUT https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/triggers/triggerId
المَعلمات
اسم المعلَمة | القيمة | الوصف |
---|---|---|
مَعلمات المسار | ||
accountId |
string |
رقم تعريف حساب "إدارة العلامات من Google". |
containerId |
string |
رقم تعريف حاوية Google Tag Manager |
triggerId |
string |
رقم تعريف مشغِّل GTM. |
مَعلمات طلب البحث الاختيارية | ||
fingerprint |
string |
ويجب أن تتطابق بصمة الإصبع هذه عند توفيرها مع بصمة الإصبع المشغِّل في مساحة التخزين. |
التفويض
يتطلب هذا الطلب تفويضًا من خلال النطاق التالي (مزيد من المعلومات حول المصادقة والترخيص).
النطاق |
---|
https://www.googleapis.com/auth/tagmanager.edit.containers |
نص الطلب
في نص الطلب، أدخِل مورد "العوامل المشغِّلة" بالسمات التالية:
اسم الموقع | القيمة | الوصف | Notes |
---|---|---|---|
الخصائص المطلوبة | |||
autoEventFilter[].parameter[] |
list |
قائمة بالمعلَمات المُسمّاة (المفتاح/القيمة)، استنادًا إلى نوع الشرط. ملاحظات:
|
قابل للكتابة |
autoEventFilter[].parameter[].type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
autoEventFilter[].type |
string |
نوع عامل التشغيل لهذا الشرط.
القيم المقبولة هي:
|
قابل للكتابة |
checkValidation.type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
continuousTimeMinMilliseconds.type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
customEventFilter[].parameter[] |
list |
قائمة بالمعلَمات المُسمّاة (المفتاح/القيمة)، استنادًا إلى نوع الشرط. ملاحظات:
|
قابل للكتابة |
customEventFilter[].parameter[].type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
customEventFilter[].type |
string |
نوع عامل التشغيل لهذا الشرط.
القيم المقبولة هي:
|
قابل للكتابة |
eventName.type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
filter[].parameter[] |
list |
قائمة بالمعلَمات المُسمّاة (المفتاح/القيمة)، استنادًا إلى نوع الشرط. ملاحظات:
|
قابل للكتابة |
filter[].parameter[].type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
filter[].type |
string |
نوع عامل التشغيل لهذا الشرط.
القيم المقبولة هي:
|
قابل للكتابة |
horizontalScrollPercentageList.type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
interval.type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
intervalSeconds.type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
limit.type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
maxTimerLengthSeconds.type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
name |
string |
شغِّل الاسم المعروض. | قابل للكتابة |
parameter[].type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
selector.type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
totalTimeMinMilliseconds.type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
uniqueTriggerId.type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
verticalScrollPercentageList.type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
visibilitySelector.type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
visiblePercentageMax.type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
visiblePercentageMin.type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
waitForTags.type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
waitForTagsTimeout.type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
الخصائص الاختيارية | |||
autoEventFilter[] |
list |
يُستخدم في حالة تتبع الأحداث التلقائي. | قابل للكتابة |
autoEventFilter[].parameter[].key |
string |
المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. | قابل للكتابة |
autoEventFilter[].parameter[].list[] |
list |
معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). | قابل للكتابة |
autoEventFilter[].parameter[].map[] |
list |
معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). | قابل للكتابة |
autoEventFilter[].parameter[].value |
string |
قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. | قابل للكتابة |
checkValidation |
nested object |
يشير ذلك إلى ما إذا كان علينا تنشيط العلامات فقط في حال عدم إلغاء حدث إرسال النموذج أو النقر على رابط بواسطة معالج أحداث آخر (على سبيل المثال، بسبب التحقّق من الصحة). صالحة فقط لإرسال النموذج والعوامل التي تؤدي إلى النقر على الرابط. | قابل للكتابة |
checkValidation.key |
string |
المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. | قابل للكتابة |
checkValidation.list[] |
list |
معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). | قابل للكتابة |
checkValidation.map[] |
list |
معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). | قابل للكتابة |
checkValidation.value |
string |
قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. | قابل للكتابة |
continuousTimeMinMilliseconds |
nested object |
الحد الأدنى من الوقت المرئي المتواصل الذي سيؤدي إلى تشغيل مستوى الرؤية (بالمللي ثانية). صالح فقط لمشغِّل مستوى رؤية AMP. | قابل للكتابة |
continuousTimeMinMilliseconds.key |
string |
المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. | قابل للكتابة |
continuousTimeMinMilliseconds.list[] |
list |
معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). | قابل للكتابة |
continuousTimeMinMilliseconds.map[] |
list |
معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). | قابل للكتابة |
continuousTimeMinMilliseconds.value |
string |
قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. | قابل للكتابة |
customEventFilter[] |
list |
تُستخدَم في حالة الحدث المخصّص، الذي يتم تنشيطه في حال استيفاء جميع الشروط. | قابل للكتابة |
customEventFilter[].parameter[].key |
string |
المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. | قابل للكتابة |
customEventFilter[].parameter[].list[] |
list |
معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). | قابل للكتابة |
customEventFilter[].parameter[].map[] |
list |
معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). | قابل للكتابة |
customEventFilter[].parameter[].value |
string |
قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. | قابل للكتابة |
eventName |
nested object |
اسم حدث "إدارة العلامات من Google" الذي بدأ. صالح فقط لعوامل تشغيل الموقّت. | قابل للكتابة |
eventName.key |
string |
المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. | قابل للكتابة |
eventName.list[] |
list |
معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). | قابل للكتابة |
eventName.map[] |
list |
معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). | قابل للكتابة |
eventName.value |
string |
قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. | قابل للكتابة |
filter[] |
list |
سيتم تنشيط المشغِل فقط في حال كانت جميع الشروط صحيحة. | قابل للكتابة |
filter[].parameter[].key |
string |
المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. | قابل للكتابة |
filter[].parameter[].list[] |
list |
معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). | قابل للكتابة |
filter[].parameter[].map[] |
list |
معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). | قابل للكتابة |
filter[].parameter[].value |
string |
قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. | قابل للكتابة |
horizontalScrollPercentageList |
nested object |
قائمة بقيم النسبة المئوية لأعداد صحيحة لمشغِّلات التمرير وسيتم تنشيط المشغِل عند بلوغ كل نسبة مئوية عند تمرير طريقة العرض أفقيًا. صالح فقط لمشغِّلات التمرير في صفحات AMP. | قابل للكتابة |
horizontalScrollPercentageList.key |
string |
المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. | قابل للكتابة |
horizontalScrollPercentageList.list[] |
list |
معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). | قابل للكتابة |
horizontalScrollPercentageList.map[] |
list |
معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). | قابل للكتابة |
horizontalScrollPercentageList.value |
string |
قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. | قابل للكتابة |
interval |
nested object |
الوقت بين تشغيل أحداث الموقّت المتكرّرة (بالمللي ثانية) صالح فقط لعوامل تشغيل الموقّت. | قابل للكتابة |
interval.key |
string |
المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. | قابل للكتابة |
interval.list[] |
list |
معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). | قابل للكتابة |
interval.map[] |
list |
معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). | قابل للكتابة |
interval.value |
string |
قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. | قابل للكتابة |
intervalSeconds |
nested object |
الوقت بين أحداث الموقّت لإطلاق النار (بالثواني) صالح فقط لمشغِّل موقّت AMP. | قابل للكتابة |
intervalSeconds.key |
string |
المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. | قابل للكتابة |
intervalSeconds.list[] |
list |
معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). | قابل للكتابة |
intervalSeconds.map[] |
list |
معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). | قابل للكتابة |
intervalSeconds.value |
string |
قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. | قابل للكتابة |
limit |
nested object |
الحد الأقصى لعدد أحداث "إدارة العلامات من Google" التي سيتم تنشيط "عامل تشغيل الموقّت" هذا فيها. وفي حال عدم ضبط حدّ أقصى، سنواصل تنشيط أحداث "إدارة العلامات من Google" إلى أن يغادر المستخدم الصفحة. صالح فقط لعوامل تشغيل الموقّت. | قابل للكتابة |
limit.key |
string |
المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. | قابل للكتابة |
limit.list[] |
list |
معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). | قابل للكتابة |
limit.map[] |
list |
معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). | قابل للكتابة |
limit.value |
string |
قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. | قابل للكتابة |
maxTimerLengthSeconds |
nested object |
الحد الأقصى لمدة تنشيط أحداث الموقّت (بالثواني) صالح فقط لمشغِّل موقّت AMP. | قابل للكتابة |
maxTimerLengthSeconds.key |
string |
المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. | قابل للكتابة |
maxTimerLengthSeconds.list[] |
list |
معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). | قابل للكتابة |
maxTimerLengthSeconds.map[] |
list |
معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). | قابل للكتابة |
maxTimerLengthSeconds.value |
string |
قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. | قابل للكتابة |
parameter[].key |
string |
المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. | قابل للكتابة |
parameter[].list[] |
list |
معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). | قابل للكتابة |
parameter[].map[] |
list |
معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). | قابل للكتابة |
parameter[].value |
string |
قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. | قابل للكتابة |
selector |
nested object |
أداة اختيار لغة CSS لمشغّل النقر (مثل "a" أو "button" أو غير ذلك). صالح فقط لمشغِّل نقرات AMP. | قابل للكتابة |
selector.key |
string |
المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. | قابل للكتابة |
selector.list[] |
list |
معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). | قابل للكتابة |
selector.map[] |
list |
معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). | قابل للكتابة |
selector.value |
string |
قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. | قابل للكتابة |
totalTimeMinMilliseconds |
nested object |
الحدّ الأدنى لإجمالي الوقت المرئي (بالمللي ثانية) الخاص بمشغّل مستوى الرؤية صالح فقط لمشغِّل مستوى رؤية AMP. | قابل للكتابة |
totalTimeMinMilliseconds.key |
string |
المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. | قابل للكتابة |
totalTimeMinMilliseconds.list[] |
list |
معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). | قابل للكتابة |
totalTimeMinMilliseconds.map[] |
list |
معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). | قابل للكتابة |
totalTimeMinMilliseconds.value |
string |
قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. | قابل للكتابة |
type |
string |
تُحدِّد حدث طبقة البيانات الذي يؤدي إلى هذا المشغِّل.
القيم المقبولة هي:
|
قابل للكتابة |
uniqueTriggerId |
nested object |
تمثّل هذه السمة معرّفًا فريدًا عالميًا للعامل الذي ينشئ هذا المشغِّل تلقائيًا (إرسال نموذج أو النقر على الرابط أو أداة معالجة الموقت) في حال توفُّرها. تُستخدَم لجعل الأحداث التلقائية غير المتوافقة تعمل مع فلترة المشغِّل استنادًا إلى أرقام تعريف المشغِّلات. تتم تعبئة هذه القيمة أثناء إنشاء الإخراج بسبب عدم توفُّر العلامات التي تتضمنها المشغلات حتى ذلك الحين. صالح فقط لعمليات إرسال النموذج وعمليات النقر على الرابط والموقّتات. | قابل للكتابة |
uniqueTriggerId.key |
string |
المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. | قابل للكتابة |
uniqueTriggerId.list[] |
list |
معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). | قابل للكتابة |
uniqueTriggerId.map[] |
list |
معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). | قابل للكتابة |
uniqueTriggerId.value |
string |
قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. | قابل للكتابة |
verticalScrollPercentageList |
nested object |
قائمة بقيم النسبة المئوية لأعداد صحيحة لمشغِّلات التمرير وسيتم تنشيط المشغِل عند الوصول إلى كل نسبة مئوية عند تمرير طريقة العرض رأسيًا. صالح فقط لمشغِّلات التمرير في صفحات AMP. | قابل للكتابة |
verticalScrollPercentageList.key |
string |
المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. | قابل للكتابة |
verticalScrollPercentageList.list[] |
list |
معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). | قابل للكتابة |
verticalScrollPercentageList.map[] |
list |
معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). | قابل للكتابة |
verticalScrollPercentageList.value |
string |
قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. | قابل للكتابة |
visibilitySelector |
nested object |
أداة اختيار لغة CSS لمشغِّل مستوى الرؤية (أي "#id"). صالح فقط لمشغِّل مستوى رؤية AMP. | قابل للكتابة |
visibilitySelector.key |
string |
المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. | قابل للكتابة |
visibilitySelector.list[] |
list |
معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). | قابل للكتابة |
visibilitySelector.map[] |
list |
معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). | قابل للكتابة |
visibilitySelector.value |
string |
قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. | قابل للكتابة |
visiblePercentageMax |
nested object |
الحد الأقصى لنسبة ظهور الإعلان لتشغيل مستوى الرؤية. صالح فقط لمشغِّل مستوى رؤية AMP. | قابل للكتابة |
visiblePercentageMax.key |
string |
المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. | قابل للكتابة |
visiblePercentageMax.list[] |
list |
معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). | قابل للكتابة |
visiblePercentageMax.map[] |
list |
معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). | قابل للكتابة |
visiblePercentageMax.value |
string |
قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. | قابل للكتابة |
visiblePercentageMin |
nested object |
الحد الأدنى للنسبة المئوية لمستوى الرؤية لعوامل التشغيل. صالح فقط لمشغِّل مستوى رؤية AMP. | قابل للكتابة |
visiblePercentageMin.key |
string |
المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. | قابل للكتابة |
visiblePercentageMin.list[] |
list |
معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). | قابل للكتابة |
visiblePercentageMin.map[] |
list |
معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). | قابل للكتابة |
visiblePercentageMin.value |
string |
قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. | قابل للكتابة |
waitForTags |
nested object |
يشير ذلك إلى ما إذا كان علينا تأجيل عمليات إرسال النماذج أو فتح الرابط إلى أن يتم تنشيط جميع العلامات (من خلال منع الإجراء التلقائي ومحاكاة الإجراء التلقائي لاحقًا). صالحة فقط لإرسال النموذج والعوامل التي تؤدي إلى النقر على الرابط. | قابل للكتابة |
waitForTags.key |
string |
المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. | قابل للكتابة |
waitForTags.list[] |
list |
معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). | قابل للكتابة |
waitForTags.map[] |
list |
معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). | قابل للكتابة |
waitForTags.value |
string |
قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. | قابل للكتابة |
waitForTagsTimeout |
nested object |
مدة الانتظار (بالمللي ثانية) لتنشيط العلامات عندما يتم تقييم "Ways_for_tags" أعلاه بقيمة true . صالحة فقط لإرسال النموذج والعوامل التي تؤدي إلى النقر على الرابط. |
قابل للكتابة |
waitForTagsTimeout.key |
string |
المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. | قابل للكتابة |
waitForTagsTimeout.list[] |
list |
معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). | قابل للكتابة |
waitForTagsTimeout.map[] |
list |
معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). | قابل للكتابة |
waitForTagsTimeout.value |
string |
قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. | قابل للكتابة |
الإجابة
في حال نجاح هذا الإجراء، تعرِض هذه الطريقة مورد "المشغلات" في نص الاستجابة.
أمثلة
ملاحظة: إنّ الأمثلة المرتبطة بالرموز والمتوفرة لهذه الطريقة لا تمثّل كل لغات البرمجة المتوافقة (يُرجى مراجعة صفحة مكتبات البرامج للاطّلاع على قائمة باللغات المتوافقة).
Java
تستخدم مكتبة عميل Java.
/* * Note: This code assumes you have an authorized tagmanager service object. */ /* * This request updates an existing trigger for the authorized user. */ // Create the condition parameters objects. Parameter arg0 = new Parameter(); arg0.setType("template"); arg0.setKey("arg0"); arg0.setValue("{{Page URL}}"); Parameter arg1 = new Parameter(); arg1.setType("template"); arg1.setKey("arg1"); arg1.setValue("timed.html"); // Create the auto event condition object. Condition condition = new Condition(); condition.setType("contains"); condition.setParameter(Arrays.asList(arg0, arg1)); // Create the event parameter. Parameter eventName = new Parameter(); eventName.setType("template"); eventName.setValue("gtm.timer"); // Create the interval parameter. Parameter interval = new Parameter(); interval.setType("template"); interval.setValue("10000"); // Create the limit parameter. Parameter limit = new Parameter(); limit.setType("template"); limit.setValue("10"); // Create the trigger object. Trigger trigger = new Trigger(); trigger.setName("Updated Timer Trigger"); trigger.setType("timer"); trigger.setAutoEventFilter(Arrays.asList(condition)); trigger.setEventName(eventName); trigger.setInterval(interval); trigger.setLimit(limit); try { Trigger response = tagmanager.accounts().containers(). triggers().update("123456", "54321", "1", trigger).execute(); } catch (GoogleJsonResponseException e) { System.err.println("There was a service error: " + e.getDetails().getCode() + " : " + e.getDetails().getMessage()); } /* * The results of the update method are stored in the response object. * The following code shows how to access the updated name and fingerprint. */ System.out.println("Updated Name = " + response.getName()); System.out.println("Updated Fingerprint = " + response.getFingerprint());
Python
تستخدم مكتبة برامج Python.
# Note: This code assumes you have an authorized tagmanager service object. # This request updates an existing trigger. try: response = tagmanager.accounts().containers().triggers().update( accountId='123456', containerId='54321', triggerId='3', body={ 'name': 'Updated Timed trigger', 'type': 'timer', 'autoEventFilter': [ { 'type': 'contains', 'parameter': [ { 'type': 'template', 'key': 'arg0', 'value': '{{Page URL}}' }, { 'type': 'template', 'key': 'arg1', 'value': 'timed.html' } ] } ], 'eventName': { 'type': 'template', 'value': 'gtm.timer' }, 'interval': { 'type': 'template', 'value': '10000' }, 'limit': { 'type': 'template', 'value': '10' } } ).execute() except TypeError, error: # Handle errors in constructing a query. print 'There was an error in constructing your query : %s' % error except HttpError, error: # Handle API errors. print ('There was an API error : %s : %s' % (error.resp.status, error.resp.reason)) # The results of the update method are stored in the response object. # The following code shows how to access the updated name and fingerprint. print 'Updated Name = %s' % response.get('name') print 'Updated Fingerprint = %s' % response.get('fingerprint')
تجربة
يمكنك استخدام مستكشف واجهات برمجة التطبيقات أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الاستجابة.