تنشئ متغيّر GTM. تجربة ذلك الآن
الطلب
طلب HTTP
POST https://www.googleapis.com/tagmanager/v2/+parent/variables
المَعلمات
اسم المعلَمة | القيمة | الوصف |
---|---|---|
مَعلمات المسار | ||
parent |
string |
هو المسار النسبي لواجهة برمجة التطبيقات في GTM Workspace. مثال: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id} |
التفويض
يتطلب هذا الطلب تفويضًا بالنطاق التالي:
النطاق |
---|
https://www.googleapis.com/auth/tagmanager.edit.containers |
للحصول على مزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.
نص الطلب
في نص الطلب، أدخِل مورد المتغيّرات بالسمات التالية:
اسم الموقع | القيمة | الوصف | Notes |
---|---|---|---|
الخصائص المطلوبة | |||
formatValue.convertFalseToValue.type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
formatValue.convertNullToValue.type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
formatValue.convertTrueToValue.type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
formatValue.convertUndefinedToValue.type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
name |
string |
الاسم المعروض للمتغير. | قابل للكتابة |
parameter[].type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
type |
string |
نوع متغيّر GTM. | قابل للكتابة |
الخصائص الاختيارية | |||
disablingTriggerId[] |
list |
بالنسبة إلى حاويات الأجهزة الجوّالة فقط: قائمة بأرقام تعريف المشغِّلات لإيقاف المتغيرات الشرطية، يتم تفعيل المتغيّر إذا كان أحد مشغّلات التفعيل صحيحًا وكان جميع مشغّلات الإيقاف خطأ. وهي تُعامل على أنها مجموعة غير مرتَّبة. | قابل للكتابة |
enablingTriggerId[] |
list |
بالنسبة إلى حاويات الأجهزة الجوّالة فقط: قائمة بأرقام تعريف المشغِّلات لتفعيل المتغيّرات الشرطية، ويتم تفعيل المتغيّر إذا كان أحد مشغّلات التفعيل صحيحًا وكان جميع مشغّلات الإيقاف خاطئة. وهي تُعامل على أنها مجموعة غير مرتَّبة. | قابل للكتابة |
formatValue.convertFalseToValue.key |
string |
المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. | قابل للكتابة |
formatValue.convertFalseToValue.list[] |
list |
معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). | قابل للكتابة |
formatValue.convertFalseToValue.map[] |
list |
معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). | قابل للكتابة |
formatValue.convertFalseToValue.value |
string |
قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. | قابل للكتابة |
formatValue.convertNullToValue.key |
string |
المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. | قابل للكتابة |
formatValue.convertNullToValue.list[] |
list |
معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). | قابل للكتابة |
formatValue.convertNullToValue.map[] |
list |
معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). | قابل للكتابة |
formatValue.convertNullToValue.value |
string |
قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. | قابل للكتابة |
formatValue.convertTrueToValue.key |
string |
المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. | قابل للكتابة |
formatValue.convertTrueToValue.list[] |
list |
معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). | قابل للكتابة |
formatValue.convertTrueToValue.map[] |
list |
معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). | قابل للكتابة |
formatValue.convertTrueToValue.value |
string |
قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. | قابل للكتابة |
formatValue.convertUndefinedToValue.key |
string |
المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. | قابل للكتابة |
formatValue.convertUndefinedToValue.list[] |
list |
معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). | قابل للكتابة |
formatValue.convertUndefinedToValue.map[] |
list |
معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). | قابل للكتابة |
formatValue.convertUndefinedToValue.value |
string |
قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. | قابل للكتابة |
notes |
string |
ملاحظات المستخدِم حول كيفية تطبيق هذا المتغيّر في الحاوية | قابل للكتابة |
parameter[] |
list |
معلَمات المتغير. | قابل للكتابة |
parameter[].key |
string |
المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. | قابل للكتابة |
parameter[].list[] |
list |
معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). | قابل للكتابة |
parameter[].map[] |
list |
معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). | قابل للكتابة |
parameter[].value |
string |
قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. | قابل للكتابة |
scheduleEndMs |
long |
الطابع الزمني للانتهاء بالمللي ثانية لجدولة متغيّر. | قابل للكتابة |
scheduleStartMs |
long |
الطابع الزمني للبدء بالمللي ثانية لجدولة متغيّر | قابل للكتابة |
الإجابة
في حال نجاحها، تعرِض هذه الطريقة مورد المتغيّرات في نص الاستجابة.
تجربة
يمكنك استخدام مستكشف واجهات برمجة التطبيقات أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الاستجابة.