نیاز به مجوز دارد
یک ظرف ایجاد می کند. اکنون آن را امتحان کنید یا نمونه ای را ببینید .
درخواست
درخواست HTTP
POST https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers
مولفه های
نام پارامتر | ارزش | شرح |
---|---|---|
پارامترهای مسیر | ||
accountId | string | شناسه حساب GTM. |
مجوز
این درخواست به مجوز با محدوده زیر نیاز دارد ( در مورد احراز هویت و مجوز بیشتر بخوانید ).
محدوده |
---|
https://www.googleapis.com/auth/tagmanager.edit.containers |
درخواست بدن
در بدنه درخواست، یک منبع Containers با ویژگی های زیر ارائه کنید:
نام ملک | ارزش | شرح | یادداشت |
---|---|---|---|
خواص مورد نیاز | |||
name | string | نام نمایشی کانتینر | قابل نوشتن |
timeZoneCountryId | string | شناسه کشور کانتینر. | قابل نوشتن |
timeZoneId | string | شناسه منطقه زمانی کانتینر. | قابل نوشتن |
usageContext[] | list | فهرست زمینه های استفاده برای کانتینر. مقادیر معتبر عبارتند از: web, android, ios . | قابل نوشتن |
ویژگی های اختیاری | |||
domainName[] | list | لیست اختیاری نام های دامنه مرتبط با کانتینر. | قابل نوشتن |
enabledBuiltInVariable[] | list | لیست متغیرهای داخلی فعال شده Valid values in pageUrl, pageHostname, pagePath, referrer, event, clickElement, clickClasses, clickId, clickTarget, clickUrl, clickText, formElement, formClasses, formId, formTarget, formUrl, formText, errorMessage, errorUrl, errorLine, newHistoryFragment, oldHistoryFragment, newHistoryState, oldHistoryState, historySource, containerVersion, debugMode, randomNumber, containerId . | قابل نوشتن |
notes | string | یادداشت های ظرف. | قابل نوشتن |
واکنش
در صورت موفقیت آمیز بودن، این روش یک منبع Containers را در بدنه پاسخ برمی گرداند.
مثال ها
توجه: نمونههای کد موجود برای این روش همه زبانهای برنامهنویسی پشتیبانیشده را نشان نمیدهند (برای فهرست زبانهای پشتیبانیشده به صفحه کتابخانههای سرویس گیرنده مراجعه کنید).
جاوا
از کتابخانه سرویس گیرنده جاوا استفاده می کند.
/* * Note: This code assumes you have an authorized tagmanager service object. */ /* * This request creates a new container for the authorized user. */ // Construct the container object. Container container = new Container(); container.setName("Example Container"); container.setTimeZoneCountryId("US"); container.setTimeZoneId("America/Los_Angeles"); container.setUsageContext(Arrays.asList("web", "android", "ios")); try { Container response = tagmanager.accounts(). containers().create("12345", container).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("Container Id = " + response.getContainerId()); System.out.println("Container Fingerprint" + response.getFingerprint());
پایتون
از کتابخانه کلاینت پایتون استفاده می کند.
# Note: This code assumes you have an authorized tagmanager service object. # This request creates a new container. try: response = tagmanager.accounts().containers().create( accountId='123456', body={ 'name': 'Example Container', 'timeZoneCountryId': 'US', 'timeZoneId': 'America/Los_Angeles', 'usageContext': ['web', 'android'] } ).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 the response object. # The following code shows how to access the created id and fingerprint. print response.get('containerId') print response.get('fingerprint')
آن را امتحان کنید!
از APIs Explorer زیر برای فراخوانی این روش در دادههای زنده و دیدن پاسخ استفاده کنید.