Переменные: обновление

Требуется авторизация

Обновляет переменную Google Менеджера тегов. Попробовать

Запрос

HTTP-запрос

PUT https://www.googleapis.com/tagmanager/v2/path

Параметры

Название параметра Значение Описание
Параметры пути
path string Относительный путь для API к переменной Менеджера тегов. Пример: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/variables/{variable_id}.
Необязательные параметры запроса
fingerprint string Цифровой отпечаток, указанный в параметре, должен совпадать с цифровым отпечатком переменной из хранилища.

Авторизация

Этот запрос требует авторизации в указанной ниже области доступа. Подробнее об аутентификации и авторизации

Область доступа
https://www.googleapis.com/auth/tagmanager.edit.containers

Тело запроса

В теле запроса необходимо предоставить ресурс Variables с перечисленными ниже свойствами.

Название свойства Значение Описание Примечания
Обязательные свойства
formatValue.convertFalseToValue.type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на переменную (в том числе возвращающие нестроковые типы).
  • trigger_reference: значение представляет собой идентификатор триггера, указывающий на него.


Возможные значения:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
Редактируемый объект
formatValue.convertNullToValue.type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на переменную (в том числе возвращающие нестроковые типы).
  • trigger_reference: значение представляет собой идентификатор триггера, указывающий на него.


Возможные значения:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
Редактируемый объект
formatValue.convertTrueToValue.type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на переменную (в том числе возвращающие нестроковые типы).
  • trigger_reference: значение представляет собой идентификатор триггера, указывающий на него.


Возможные значения:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
Редактируемый объект
formatValue.convertUndefinedToValue.type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на переменную (в том числе возвращающие нестроковые типы).
  • trigger_reference: значение представляет собой идентификатор триггера, указывающий на него.


Возможные значения:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
Можно редактировать
name string Отображаемое название переменной. Редактируемый объект
parameter[].type string Тип параметра. Допустимые значения:
  • boolean: логическое значение (true или false).
  • integer: 64-разрядное целое число со знаком (в десятичном виде).
  • list: список параметров.
  • map: массив параметров.
  • template: любой текст, включая ссылки на переменную (в том числе возвращающие нестроковые типы).
  • trigger_reference: значение представляет собой идентификатор триггера, указывающий на него.


Возможные значения:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
Редактируемый объект
type string Тип переменной Менеджера тегов. Редактируемый объект
Необязательные свойства
disablingTriggerId[] list (Используется только в контейнерах для мобильных устройств.) Список идентификаторов триггеров для отключения условных переменных. Переменная активируется, если одному из триггеров активации присвоено значение true, а всем триггерам дезактивации – false. Обрабатывается как неупорядоченное множество. Редактируемый объект
enablingTriggerId[] list (Используется только в контейнерах для мобильных устройств.) Список ID триггеров активации условных переменных. Переменная активируется, если одному из этих триггеров присвоено значение true, а всем остальным – false. Обрабатывается как неупорядоченное множество. Можно редактировать
formatValue.convertFalseToValue.key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Редактируемый объект
formatValue.convertFalseToValue.list[] list Параметры этого параметра-списка (ключи игнорируются). Редактируемый объект
formatValue.convertFalseToValue.map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Редактируемый объект
formatValue.convertFalseToValue.value string Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). Редактируемый объект
formatValue.convertNullToValue.key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Редактируемый объект
formatValue.convertNullToValue.list[] list Параметры этого параметра-списка (ключи игнорируются). Редактируемый объект
formatValue.convertNullToValue.map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Редактируемый объект
formatValue.convertNullToValue.value string Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). Редактируемый объект
formatValue.convertTrueToValue.key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Редактируемый объект
formatValue.convertTrueToValue.list[] list Параметры этого параметра-списка (ключи игнорируются). Редактируемый объект
formatValue.convertTrueToValue.map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Редактируемый объект
formatValue.convertTrueToValue.value string Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). Редактируемый объект
formatValue.convertUndefinedToValue.key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Редактируемый объект
formatValue.convertUndefinedToValue.list[] list Параметры этого параметра-списка (ключи игнорируются). Редактируемый объект
formatValue.convertUndefinedToValue.map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Редактируемый объект
formatValue.convertUndefinedToValue.value string Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). Можно редактировать
notes string Примечания об использовании переменной в контейнере. Редактируемый объект
parameter[] list Параметры переменной. Редактируемый объект
parameter[].key string Именованный ключ, служащий уникальным идентификатором параметра. Требуется для параметров верхнего уровня и значений в ассоциативных массивах. Игнорируется для элементов списка. Редактируемый объект
parameter[].list[] list Параметры этого параметра-списка (ключи игнорируются). Редактируемый объект
parameter[].map[] list Параметры этого параметра-массива (должны содержать уникальные ключи). Редактируемый объект
parameter[].value string Значение параметра, соответствующее указанному типу (может содержать ссылку на переменную, например "{{myVariable}}"). Редактируемый объект
scheduleEndMs long Временная метка, соответствующая окончанию выполнения переменной (в миллисекундах). Редактируемый объект
scheduleStartMs long Начальная временная метка в миллисекундах для определения времени действия переменной. Редактируемый объект

Ответ

Если метод выполнен без ошибок, он возвращает в теле ответа ресурс Variables.

Практическое задание

Воспользуйтесь инструментом API Explorer, чтобы применить этот метод к реальным данным и узнать, как он работает.