Требуется авторизация
Обновляет триггер Менеджера тегов. Попробовать
Запрос
HTTP-запрос
PUT https://www.googleapis.com/tagmanager/v2/path
Параметры
Название параметра | Значение | Описание |
---|---|---|
Параметры пути | ||
path |
string |
Относительный путь для API к триггеру Менеджера тегов. Пример: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/triggers/{trigger_id}. |
Необязательные параметры запроса | ||
fingerprint |
string |
Цифровой отпечаток, указанный в параметре, должен совпадать с цифровым отпечатком триггера из хранилища. |
Авторизация
Этот запрос требует авторизации в указанной ниже области доступа. Подробнее об аутентификации и авторизации…
Область доступа |
---|
https://www.googleapis.com/auth/tagmanager.edit.containers |
Тело запроса
В теле запроса необходимо задать ресурс Triggers со следующими свойствами:
Название свойства | Значение | Описание | Примечания |
---|---|---|---|
Обязательные свойства | |||
autoEventFilter[].parameter[] |
list |
Именованные параметры (ключ-значение). Список параметров различается в зависимости от типа условия. Примечания:
|
Редактируемый объект |
autoEventFilter[].parameter[].type |
string |
Тип параметра. Допустимые значения:
Возможные значения:
|
Редактируемый объект |
autoEventFilter[].type |
string |
Тип оператора для этого условия.
Допустимые значения:
|
Редактируемый объект |
checkValidation.type |
string |
Тип параметра. Допустимые значения:
Возможные значения:
|
Редактируемый объект |
continuousTimeMinMilliseconds.type |
string |
Тип параметра. Допустимые значения:
Возможные значения:
|
Редактируемый объект |
customEventFilter[].parameter[] |
list |
Именованные параметры (ключ-значение). Список параметров различается в зависимости от типа условия. Примечания:
|
Редактируемый объект |
customEventFilter[].parameter[].type |
string |
Тип параметра. Допустимые значения:
Возможные значения:
|
Редактируемый объект |
customEventFilter[].type |
string |
Тип оператора для этого условия.
Допустимые значения:
|
Редактируемый объект |
eventName.type |
string |
Тип параметра. Допустимые значения:
Возможные значения:
|
Редактируемый объект |
filter[].parameter[] |
list |
Именованные параметры (ключ-значение). Список параметров различается в зависимости от типа условия. Примечания:
|
Редактируемый объект |
filter[].parameter[].type |
string |
Тип параметра. Допустимые значения:
Возможные значения:
|
Редактируемый объект |
filter[].type |
string |
Тип оператора для этого условия.
Допустимые значения:
|
Редактируемый объект |
horizontalScrollPercentageList.type |
string |
Тип параметра. Допустимые значения:
Возможные значения:
|
Редактируемый объект |
interval.type |
string |
Тип параметра. Допустимые значения:
Возможные значения:
|
Редактируемый объект |
intervalSeconds.type |
string |
Тип параметра. Допустимые значения:
Возможные значения:
|
Редактируемый объект |
limit.type |
string |
Тип параметра. Допустимые значения:
Возможные значения:
|
Редактируемый объект |
maxTimerLengthSeconds.type |
string |
Тип параметра. Допустимые значения:
Возможные значения:
|
Редактируемый объект |
name |
string |
Отображаемое название триггера. | Редактируемый объект |
parameter[].type |
string |
Тип параметра. Допустимые значения:
Возможные значения:
|
Редактируемый объект |
selector.type |
string |
Тип параметра. Допустимые значения:
Возможные значения:
|
Редактируемый объект |
totalTimeMinMilliseconds.type |
string |
Тип параметра. Допустимые значения:
Возможные значения:
|
Редактируемый объект |
uniqueTriggerId.type |
string |
Тип параметра. Допустимые значения:
Возможные значения:
|
Редактируемый объект |
verticalScrollPercentageList.type |
string |
Тип параметра. Допустимые значения:
Возможные значения:
|
Редактируемый объект |
visibilitySelector.type |
string |
Тип параметра. Допустимые значения:
Возможные значения:
|
Редактируемый объект |
visiblePercentageMax.type |
string |
Тип параметра. Допустимые значения:
Возможные значения:
|
Редактируемый объект |
visiblePercentageMin.type |
string |
Тип параметра. Допустимые значения:
Возможные значения:
|
Редактируемый объект |
waitForTags.type |
string |
Тип параметра. Допустимые значения:
Возможные значения:
|
Редактируемый объект |
waitForTagsTimeout.type |
string |
Тип параметра. Допустимые значения:
Возможные значения:
|
Редактируемый объект |
Необязательные свойства | |||
autoEventFilter[] |
list |
Используется для автоматического отслеживания событий. | Редактируемый объект |
autoEventFilter[].parameter[].key |
string |
Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. | Редактируемый объект |
autoEventFilter[].parameter[].list[] |
list |
Параметры этого параметра-списка (ключи игнорируются). | Редактируемый объект |
autoEventFilter[].parameter[].map[] |
list |
Параметры этого параметра-массива (должны содержать уникальные ключи). | Редактируемый объект |
autoEventFilter[].parameter[].value |
string |
Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). | Редактируемый объект |
checkValidation |
nested object |
Должны ли теги активироваться только в том случае, если отправка формы или клик по ссылке не были отменены другим обработчиком событий (например, при подтверждении). Свойство действительно только для триггеров отправки формы и клика по ссылке. | Редактируемый объект |
checkValidation.key |
string |
Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. | Редактируемый объект |
checkValidation.list[] |
list |
Параметры этого параметра-списка (ключи игнорируются). | Редактируемый объект |
checkValidation.map[] |
list |
Параметры этого параметра-массива (должны содержать уникальные ключи). | Редактируемый объект |
checkValidation.value |
string |
Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). | Редактируемый объект |
continuousTimeMinMilliseconds |
nested object |
Минимальное непрерывное время видимости (в миллисекундах). Действительно только для триггеров видимости на AMP-страницах. | Можно редактировать |
continuousTimeMinMilliseconds.key |
string |
Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. | Редактируемый объект |
continuousTimeMinMilliseconds.list[] |
list |
Параметры этого параметра-списка (ключи игнорируются). | Можно редактировать |
continuousTimeMinMilliseconds.map[] |
list |
Параметры этого параметра-массива (должны содержать уникальные ключи). | Можно редактировать |
continuousTimeMinMilliseconds.value |
string |
Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). | Редактируемый объект |
customEventFilter[] |
list |
Свойство для пользовательского события, которое запускается, только когда все условия выполнены. | Редактируемый объект |
customEventFilter[].parameter[].key |
string |
Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. | Редактируемый объект |
customEventFilter[].parameter[].list[] |
list |
Параметры этого параметра-списка (ключи игнорируются). | Редактируемый объект |
customEventFilter[].parameter[].map[] |
list |
Параметры этого параметра-массива (должны содержать уникальные ключи). | Редактируемый объект |
customEventFilter[].parameter[].value |
string |
Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). | Редактируемый объект |
eventName |
nested object |
Название запущенного события Менеджера тегов. Свойство действительно только для триггеров таймера. | Редактируемый объект |
eventName.key |
string |
Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. | Редактируемый объект |
eventName.list[] |
list |
Параметры этого параметра-списка (ключи игнорируются). | Можно редактировать |
eventName.map[] |
list |
Параметры этого параметра-массива (должны содержать уникальные ключи). | Можно редактировать |
eventName.value |
string |
Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). | Можно редактировать |
filter[] |
list |
Триггер будет срабатывать, только если все условия выполнены. | Можно редактировать |
filter[].parameter[].key |
string |
Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. | Редактируемый объект |
filter[].parameter[].list[] |
list |
Параметры этого параметра-списка (ключи игнорируются). | Редактируемый объект |
filter[].parameter[].map[] |
list |
Параметры этого параметра-массива (должны содержать уникальные ключи). | Редактируемый объект |
filter[].parameter[].value |
string |
Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). | Редактируемый объект |
horizontalScrollPercentageList |
nested object |
Список целочисленных процентных значений для триггеров прокрутки. Триггер будет срабатывать при достижении каждого из значений при прокрутке страницы по горизонтали. Свойство действительно только для триггеров прокрутки AMP-страниц. | Редактируемый объект |
horizontalScrollPercentageList.key |
string |
Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. | Редактируемый объект |
horizontalScrollPercentageList.list[] |
list |
Параметры этого параметра-списка (ключи игнорируются). | Редактируемый объект |
horizontalScrollPercentageList.map[] |
list |
Параметры этого параметра-массива (должны содержать уникальные ключи). | Редактируемый объект |
horizontalScrollPercentageList.value |
string |
Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). | Редактируемый объект |
interval |
nested object |
Время между активацией повторяющихся событий таймера (в миллисекундах). Свойство действительно только для триггеров таймера. | Редактируемый объект |
interval.key |
string |
Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. | Редактируемый объект |
interval.list[] |
list |
Параметры этого параметра-списка (ключи игнорируются). | Редактируемый объект |
interval.map[] |
list |
Параметры этого параметра-массива (должны содержать уникальные ключи). | Редактируемый объект |
interval.value |
string |
Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). | Редактируемый объект |
intervalSeconds |
nested object |
Время между запуском событий таймера (в секундах). Только для триггеров таймера на AMP-страницах. | Редактируемый объект |
intervalSeconds.key |
string |
Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Ignored for list values. | writable |
intervalSeconds.list[] |
list |
Параметры этого параметра-списка (ключи игнорируются). | writable |
intervalSeconds.map[] |
list |
Параметры этого параметра-массива (должны содержать уникальные ключи). | writable |
intervalSeconds.value |
string |
Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). | writable |
limit |
nested object |
Максимальное количество событий Менеджера тегов, которые может активировать этот триггер таймера. Если ограничение не установлено, события будут запускаться, пока пользователь не покинет страницу. Свойство действительно только для триггеров таймера. | Редактируемый объект |
limit.key |
string |
Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. | Редактируемый объект |
limit.list[] |
list |
Параметры этого параметра-списка (ключи игнорируются). | Редактируемый объект |
limit.map[] |
list |
Параметры этого параметра-массива (должны содержать уникальные ключи). | Редактируемый объект |
limit.value |
string |
Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). | Редактируемый объект |
maxTimerLengthSeconds |
nested object |
Максимальное время для активации событий таймера (в секундах). Только для триггеров таймера на AMP-страницах. | Редактируемый объект |
maxTimerLengthSeconds.key |
string |
Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. | Редактируемый объект |
maxTimerLengthSeconds.list[] |
list |
Параметры этого параметра-списка (ключи игнорируются). | Редактируемый объект |
maxTimerLengthSeconds.map[] |
list |
Параметры этого параметра-массива (должны содержать уникальные ключи). | Редактируемый объект |
maxTimerLengthSeconds.value |
string |
Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). | Редактируемый объект |
notes |
string |
Пользовательские примечания о том, как триггер должен применяться в контейнере. | Редактируемый объект |
parameter[] |
list |
Дополнительные параметры. | Редактируемый объект |
parameter[].key |
string |
Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. | Редактируемый объект |
parameter[].list[] |
list |
Параметры этого параметра-списка (ключи игнорируются). | Редактируемый объект |
parameter[].map[] |
list |
Параметры этого параметра-массива (должны содержать уникальные ключи). | Редактируемый объект |
parameter[].value |
string |
Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). | Редактируемый объект |
selector |
nested object |
CSS-селектор триггера клика (например, "A" или "BUTTON"). Только для триггеров клика на AMP-страницах. | Редактируемый объект |
selector.key |
string |
Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. | Редактируемый объект |
selector.list[] |
list |
Параметры этого параметра-списка (ключи игнорируются). | Редактируемый объект |
selector.map[] |
list |
Параметры этого параметра-массива (должны содержать уникальные ключи). | Редактируемый объект |
selector.value |
string |
Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). | Редактируемый объект |
totalTimeMinMilliseconds |
nested object |
Минимальное общее время видимости (в миллисекундах). Действительно только для триггеров видимости на AMP-страницах. | Редактируемый объект |
totalTimeMinMilliseconds.key |
string |
Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. | Редактируемый объект |
totalTimeMinMilliseconds.list[] |
list |
Параметры этого параметра-списка (ключи игнорируются). | Редактируемый объект |
totalTimeMinMilliseconds.map[] |
list |
Параметры этого параметра-массива (должны содержать уникальные ключи). | Редактируемый объект |
totalTimeMinMilliseconds.value |
string |
Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). | Редактируемый объект |
type |
string |
Определяет событие уровня данных, которое приводит к срабатыванию триггера.
Допустимые значения:
|
Редактируемый объект |
uniqueTriggerId |
nested object |
Глобально уникальный идентификатор триггера, который генерирует автоматические события (отправку формы, клик по ссылке или прослушивание таймера). Обеспечивает совместимость таких событий с фильтрацией триггеров по идентификаторам. Значение свойства заполняется во время генерирования вывода, когда создаются связанные с триггерами теги. Действителен только для триггеров отправки формы, клика по ссылке и таймера. | Редактируемый объект |
uniqueTriggerId.key |
string |
Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. | Редактируемый объект |
uniqueTriggerId.list[] |
list |
Параметры этого параметра-списка (ключи игнорируются). | Редактируемый объект |
uniqueTriggerId.map[] |
list |
Параметры этого параметра-массива (должны содержать уникальные ключи). | Редактируемый объект |
uniqueTriggerId.value |
string |
Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). | Редактируемый объект |
verticalScrollPercentageList |
nested object |
Список целочисленных процентных значений для триггеров прокрутки. Триггер будет срабатывать при достижении каждого из значений при прокрутке страницы по вертикали. Свойство действительно только для триггеров прокрутки AMP-страниц. | Редактируемый объект |
verticalScrollPercentageList.key |
string |
Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. | Редактируемый объект |
verticalScrollPercentageList.list[] |
list |
Параметры этого параметра-списка (ключи игнорируются). | Редактируемый объект |
verticalScrollPercentageList.map[] |
list |
Параметры этого параметра-массива (должны содержать уникальные ключи). | Редактируемый объект |
verticalScrollPercentageList.value |
string |
Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). | Редактируемый объект |
visibilitySelector |
nested object |
CSS-селектор триггера видимости (например, "#id"). Действительно только для триггеров видимости на AMP-страницах. | Редактируемый объект |
visibilitySelector.key |
string |
Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. | Редактируемый объект |
visibilitySelector.list[] |
list |
Параметры этого параметра-списка (ключи игнорируются). | Редактируемый объект |
visibilitySelector.map[] |
list |
Параметры этого параметра-массива (должны содержать уникальные ключи). | Редактируемый объект |
visibilitySelector.value |
string |
Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). | Редактируемый объект |
visiblePercentageMax |
nested object |
Триггер для максимального процента видимости. Действительно только для триггеров видимости на AMP-страницах. | Редактируемый объект |
visiblePercentageMax.key |
string |
Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. | Редактируемый объект |
visiblePercentageMax.list[] |
list |
Параметры этого параметра-списка (ключи игнорируются). | Редактируемый объект |
visiblePercentageMax.map[] |
list |
Параметры этого параметра-массива (должны содержать уникальные ключи). | Редактируемый объект |
visiblePercentageMax.value |
string |
Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). | Редактируемый объект |
visiblePercentageMin |
nested object |
Триггер для минимального процента видимости. Действительно только для триггеров видимости на AMP-страницах. | Редактируемый объект |
visiblePercentageMin.key |
string |
Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. | Редактируемый объект |
visiblePercentageMin.list[] |
list |
Параметры этого параметра-списка (ключи игнорируются). | Редактируемый объект |
visiblePercentageMin.map[] |
list |
Параметры этого параметра-массива (должны содержать уникальные ключи). | Редактируемый объект |
visiblePercentageMin.value |
string |
Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). | Редактируемый объект |
waitForTags |
nested object |
Откладывать ли отправку формы или открытие ссылки до тех пор, пока не сработают все теги (для этого действие по умолчанию приостанавливается, а затем имитируется). Свойство действительно только для триггеров отправки формы и клика по ссылке. | Редактируемый объект |
waitForTags.key |
string |
Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. | Редактируемый объект |
waitForTags.list[] |
list |
Параметры этого параметра-списка (ключи игнорируются). | Редактируемый объект |
waitForTags.map[] |
list |
Параметры этого параметра-массива (должны содержать уникальные ключи). | Редактируемый объект |
waitForTags.value |
string |
Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). | Редактируемый объект |
waitForTagsTimeout |
nested object |
Время ожидания срабатывания тегов (в миллисекундах), когда свойство waits_for_tags (см. выше) принимает значение true . Свойство действительно только для триггеров отправки формы и клика по ссылке. |
Редактируемый объект |
waitForTagsTimeout.key |
string |
Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. | Редактируемый объект |
waitForTagsTimeout.list[] |
list |
Параметры этого параметра-списка (ключи игнорируются). | Редактируемый объект |
waitForTagsTimeout.map[] |
list |
Параметры этого параметра-массива (должны содержать уникальные ключи). | Редактируемый объект |
waitForTagsTimeout.value |
string |
Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). | Редактируемый объект |
Ответ
В случае успеха этот метод возвращает ресурс Triggers в теле ответа.
Практическое задание
Воспользуйтесь инструментом API Explorer, чтобы применить этот метод к реальным данным и узнать, как он работает.