Требуется авторизация
Создает тег Google Менеджера тегов. Испытайте метод в действии или изучите пример.
Запрос
HTTP-запрос
POST https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/tags
Параметры
Название параметра | Значение | Описание |
---|---|---|
Параметры пути | ||
accountId |
string |
Идентификатор аккаунта Менеджера тегов. |
containerId |
string |
Идентификатор контейнера Менеджера тегов. |
Авторизация
Этот запрос требует авторизации в указанной ниже области доступа. Подробнее об аутентификации и авторизации…
Область доступа |
---|
https://www.googleapis.com/auth/tagmanager.edit.containers |
Тело запроса
В теле запроса необходимо предоставить ресурс Tags с перечисленными ниже свойствами.
Название свойства | Значение | Описание | Примечания |
---|---|---|---|
Обязательные свойства | |||
name |
string |
Отображаемое название тега. | Можно перезаписывать |
parameter[].type |
string |
Тип параметра. Допустимые значения:
Допустимые значения:
|
Можно перезаписывать |
priority.type |
string |
Тип параметра. Допустимые значения:
Допустимые значения:
|
Можно перезаписывать |
type |
string |
Тип тега Менеджера тегов. | Можно перезаписывать |
Необязательные свойства | |||
blockingRuleId[] |
list |
Идентификаторы правил блокировки. Если какое-либо из перечисленных правил окажется истинным, тег не сработает. | Можно перезаписывать |
blockingTriggerId[] |
list |
Идентификаторы блокирующих триггеров. Если какой-либо из перечисленных триггеров окажется истинным, тег не сработает. | Можно перезаписывать |
firingRuleId[] |
list |
Идентификаторы правил активации. Тег будет срабатывать, если любое из перечисленных правил истинно, а все значения blockingRuleIds (если указаны) – ложны. |
Можно перезаписывать |
firingTriggerId[] |
list |
Идентификаторы триггеров активации. Тег будет срабатывать, если любому из перечисленных триггеров присвоено значение true, а всем его blockingTriggerIds (если указаны) – false. |
Можно перезаписывать |
liveOnly |
boolean |
Если свойству присвоено значение true, тег будет срабатывать только в реальной среде (а не в режиме предварительного просмотра или отладки). | Можно перезаписывать |
notes |
string |
Пользовательские примечания о том, как применять тег в контейнере. | Можно перезаписывать |
parameter[] |
list |
Параметры тега. | Можно перезаписывать |
parameter[].key |
string |
Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. | Можно перезаписывать |
parameter[].list[] |
list |
Параметры этого параметра-списка (ключи игнорируются). | Можно перезаписывать |
parameter[].map[] |
list |
Параметры этого параметра-массива (должны содержать уникальные ключи). | Можно перезаписывать |
parameter[].value |
string |
Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). | Можно перезаписывать |
paused |
boolean |
Приостановлен ли тег (логическое значение). | Можно перезаписывать |
priority |
nested object |
Определенный пользователем приоритет тега (в числовом выражении). Теги активируются асинхронно в соответствии с их приоритетом: те, у которых приоритет выше, активируются раньше. Приоритет тега может быть выражен положительным или отрицательным числом. Значение по умолчанию – 0. | Можно перезаписывать |
priority.key |
string |
Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. | Можно перезаписывать |
priority.list[] |
list |
Параметры этого параметра-списка (ключи игнорируются). | Можно перезаписывать |
priority.map[] |
list |
Параметры этого параметра-массива (должны содержать уникальные ключи). | Можно перезаписывать |
priority.value |
string |
Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). | Можно перезаписывать |
scheduleEndMs |
long |
Временная метка, соответствующая окончанию выполнения тега (в миллисекундах). | Можно перезаписывать |
scheduleStartMs |
long |
Временная метка, соответствующая началу выполнения тега (в миллисекундах). | Можно перезаписывать |
Ответ
Если метод выполнен без ошибок, он возвращает в теле ответа ресурс Tags.
Примеры
Примечание. Примеры кода для этого метода не охватывают все поддерживаемые языки программирования (их список опубликован на странице, посвященной клиентским библиотекам).
Java
Используется клиентская библиотека Java.
/* * Note: This code assumes you have an authorized tagmanager service object. */ /* * This request creates a new tag. */ // Construct the parameters. Parameter arg0 = new Parameter(); arg0.setType("template"); arg0.setKey("trackingId"); arg0.setValue("UA-123456-1"); Parameter arg1 = new Parameter(); arg1.setType("template"); arg1.setKey("type"); arg1.setValue("TRACK_TRANSACTION"); // Construct the tag object. Tag tag = new Tag(); tag.setName("Sample Universal Analytics Tag"); tag.setType("ua"); tag.setLiveOnly(false); tag.setParameter(Arrays.asList(arg0, arg1)); try { Tag response = tagmanager.accounts().containers(). tags().create("123456", "54321", tag).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 response object. * The following code shows how to access the created id and fingerprint. */ System.out.println("Tag id = " + response.getTagId()); System.out.println("Tag Fingerprint = " + response.getFingerprint());
Python
Используется клиентская библиотека Python.
# Note: This code assumes you have an authorized tagmanager service object. # This request creates a new container tag. try: response = tagmanager.accounts().containers().tags().create( accountId='123456', containerId='54321', body={ 'name': 'Universal Analytics Tag', 'type': 'ua', 'liveOnly': False, 'parameter': [ { 'type': 'template', 'key': 'trackingId', 'value': 'UA-123456-1' }, { 'type': 'template', 'key': 'type', 'value': 'TRACK_TRANSACTION' } ] } ).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('tagId') print response.get('fingerprint')
Практическое задание
Воспользуйтесь инструментом API Explorer, чтобы применить этот метод к реальным данным и узнать, как он работает.