يجب تقديم تفويض
تُعدِّل متغيّر GTM. جرِّبه الآن أو شاهد مثالاً.
الطلب
طلب HTTP
PUT https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/variables/variableId
المَعلمات
اسم المعلَمة | القيمة | الوصف |
---|---|---|
مَعلمات المسار | ||
accountId |
string |
رقم تعريف حساب "إدارة العلامات من Google". |
containerId |
string |
رقم تعريف حاوية Google Tag Manager |
variableId |
string |
رقم تعريف متغيّر GTM. |
مَعلمات طلب البحث الاختيارية | ||
fingerprint |
string |
ويجب أن تتطابق بصمة الإصبع هذه عند توفيرها مع بصمة المتغير في مساحة التخزين. |
التفويض
يتطلب هذا الطلب تفويضًا من خلال النطاق التالي (مزيد من المعلومات حول المصادقة والترخيص).
النطاق |
---|
https://www.googleapis.com/auth/tagmanager.edit.containers |
نص الطلب
في نص الطلب، أدخِل مورد المتغيّرات بالسمات التالية:
اسم الموقع | القيمة | الوصف | Notes |
---|---|---|---|
الخصائص المطلوبة | |||
name |
string |
الاسم المعروض للمتغير. | قابل للكتابة |
parameter[].type |
string |
نوع المَعلمة. القيم الصالحة هي:
القيم المقبولة هي:
|
قابل للكتابة |
type |
string |
نوع متغيّر GTM. | قابل للكتابة |
الخصائص الاختيارية | |||
disablingTriggerId[] |
list |
بالنسبة إلى حاويات الأجهزة الجوّالة فقط: قائمة بأرقام تعريف المشغِّلات لإيقاف المتغيرات الشرطية، يتم تفعيل المتغيّر إذا كان أحد مشغّلات التفعيل صحيحًا وكان جميع مشغّلات الإيقاف خطأ. وهي تُعامل على أنها مجموعة غير مرتَّبة. | قابل للكتابة |
enablingTriggerId[] |
list |
بالنسبة إلى حاويات الأجهزة الجوّالة فقط: قائمة بأرقام تعريف المشغِّلات لتفعيل المتغيّرات الشرطية، ويتم تفعيل المتغيّر إذا كان أحد مشغّلات التفعيل صحيحًا وكان جميع مشغّلات الإيقاف خاطئة. وهي تُعامل على أنها مجموعة غير مرتَّبة. | قابل للكتابة |
notes |
string |
ملاحظات المستخدِم حول كيفية تطبيق هذا المتغيّر في الحاوية | قابل للكتابة |
parameter[] |
list |
معلَمات المتغير. | قابل للكتابة |
parameter[].key |
string |
المفتاح المُسمّى الذي يعرّف المَعلمة بشكل فريد. مطلوبة لمَعلمات المستوى الأعلى، وكذلك لقيم الخريطة. تم تجاهل هذه القيم بسبب قيم القوائم. | قابل للكتابة |
parameter[].list[] |
list |
معلمات معلمات القائمة هذه (سيتم تجاهل المفاتيح). | قابل للكتابة |
parameter[].map[] |
list |
معلَمات مَعلمة الخريطة هذه (يجب أن تحتوي على مفاتيح، ويجب أن تكون المفاتيح فريدة). | قابل للكتابة |
parameter[].value |
string |
قيمة المَعلمة (قد تحتوي على مراجع متغيّرات مثل "") بشكل مناسب للنوع المحدّد. | قابل للكتابة |
scheduleEndMs |
long |
الطابع الزمني للانتهاء بالمللي ثانية لجدولة متغيّر. | قابل للكتابة |
scheduleStartMs |
long |
الطابع الزمني للبدء بالمللي ثانية لجدولة متغيّر | قابل للكتابة |
الإجابة
في حال نجاحها، تعرِض هذه الطريقة مورد المتغيّرات في نص الاستجابة.
أمثلة
ملاحظة: إنّ الأمثلة المرتبطة بالرموز والمتوفرة لهذه الطريقة لا تمثّل كل لغات البرمجة المتوافقة (يُرجى مراجعة صفحة مكتبات البرامج للاطّلاع على قائمة باللغات المتوافقة).
Java
تستخدم مكتبة عميل Java.
/* * Note: This code assumes you have an authorized tagmanager service object. */ /* * This request updates an existing variable for the authorized user. */ // Create the variable object. Variable variable = new Variable(); variable.setName("RandomNumber"); variable.setType("r"); // The random number type. try { Variable response = tagmanager.accounts().containers(). variables().update("12345", "54321", "2", variable).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 variable. try: response = tagmanager.accounts().containers().variables().update( accountId='123456', containerId='54321', variableId='4', body={ 'name': 'updated_random_number', 'type': 'r' } ).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')
تجربة
يمكنك استخدام مستكشف واجهات برمجة التطبيقات أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الاستجابة.