نیاز به مجوز دارد
یک متغیر GTM ایجاد می کند. اکنون آن را امتحان کنید یا نمونه ای را ببینید .
درخواست
درخواست HTTP
POST https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/variables
مولفه های
نام پارامتر | ارزش | شرح |
---|---|---|
پارامترهای مسیر | ||
accountId | string | شناسه حساب GTM. |
containerId | string | شناسه کانتینر GTM. |
مجوز
این درخواست به مجوز با محدوده زیر نیاز دارد ( در مورد احراز هویت و مجوز بیشتر بخوانید ).
محدوده |
---|
https://www.googleapis.com/auth/tagmanager.edit.containers |
درخواست بدن
در بدنه درخواست، یک منبع متغیرها با ویژگی های زیر ارائه کنید:
نام ملک | ارزش | شرح | یادداشت |
---|---|---|---|
خواص مورد نیاز | |||
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 | مهر زمان شروع در میلی ثانیه برای برنامه ریزی یک متغیر. | قابل نوشتن |
واکنش
در صورت موفقیت آمیز بودن، این روش یک منبع متغیرها را در بدنه پاسخ برمی گرداند.
مثال ها
توجه: نمونههای کد موجود برای این روش همه زبانهای برنامهنویسی پشتیبانیشده را نشان نمیدهند (برای فهرست زبانهای پشتیبانیشده به صفحه کتابخانههای سرویس گیرنده مراجعه کنید).
جاوا
از کتابخانه سرویس گیرنده جاوا استفاده می کند.
/* * Note: This code assumes you have an authorized tagmanager service object. */ /* * This request creates a new 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().create("123456", "54321", variable).execute(); } catch (GoogleJsonResponseException e) { System.err.println("There was a service error: " + e.getDetails().getCode() + " : " + e.getDetails().getMessage()); } /* * The results of the create method are stored in the response object. * The following code shows how to access the created Id and Fingerprint. */ System.out.println("Variable Id = " + response.getVariableId()); System.out.println("Variable Fingerprint = " + response.getFingerprint());
پایتون
از کتابخانه کلاینت پایتون استفاده می کند.
# Note: This code assumes you have an authorized tagmanager service object. # This request creates a new variable. try: response = tagmanager.accounts().containers().variables().create( accountId='23732470', containerId='801231', body={ 'name': '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 create method are stored in response object. # The following code shows how to access the created id and fingerprint. print 'Variable Id = %s' % response.get('variableId') print 'Variable Fingerprint = %s' % response.get('fingerprint')
آن را امتحان کنید!
از APIs Explorer زیر برای فراخوانی این روش در دادههای زنده و دیدن پاسخ استفاده کنید.