Triggers: update

승인 필요

GTM 트리거를 업데이트합니다. 지금 사용해 보기 또는 예시를 확인하세요.

요청

HTTP 요청

PUT https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/triggers/triggerId

매개변수

매개변수 이름	값	설명
경로 매개변수
accountId	string	GTM 계정 ID입니다.
containerId	string	GTM 컨테이너 ID입니다.
triggerId	string	GTM 트리거 ID입니다.
선택적 쿼리 매개변수
fingerprint	string	제공되는 경우 이 디지털 지문은 스토리지에 있는 트리거의 디지털 지문과 일치해야 합니다.

승인

이 요청을 처리하려면 다음 범위의 승인을 받아야 합니다 (인증 및 승인 자세히 알아보기).

범위
https://www.googleapis.com/auth/tagmanager.edit.containers

요청 본문

요청 본문에서는 다음과 같은 속성을 사용하여 트리거 리소스를 제공합니다.

속성 이름	값	설명	Notes
필수 속성
autoEventFilter[].parameter[]	list	조건 유형에 따라 이름이 지정된 매개변수 (키/값) 목록. 참고: 바이너리 연산자의 경우 왼쪽 및 오른쪽 피연산자를 각각 지정하기 위해 arg0 및 arg1라는 매개변수를 포함합니다. 이때 왼쪽 피연산자 (arg0)는 변수 참조여야 합니다. 대소문자를 구분하지 않는 정규식 일치의 경우 true로 설정된 ignore_case이라는 부울 매개변수를 포함합니다. 지정하지 않거나 다른 값으로 설정하면 일치 항목이 대소문자를 구분합니다. 연산자를 무효화하려면 negate 부울 매개변수(true로 설정된 불리언 매개변수)를 포함합니다.	쓰기 가능
autoEventFilter[].parameter[].type	string	매개변수 유형. 유효한 값은 다음과 같습니다. boolean: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다. integer: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다. list: 매개변수 목록을 지정해야 함 map: 매개변수 맵을 지정해야 합니다. template: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다. trigger_reference: 값은 트리거를 나타내며 트리거 ID로 표시됩니다. 사용 가능한 값은 다음과 같습니다. "boolean" "integer" "list" "map" "template" "triggerReference"	쓰기 가능
autoEventFilter[].type	string	이 조건의 연산자 유형입니다. 사용 가능한 값은 다음과 같습니다. "contains" "cssSelector" "endsWith" "equals" "greater" "greaterOrEquals" "less" "lessOrEquals" "matchRegex" "startsWith" "urlMatches"	쓰기 가능
checkValidation.type	string	매개변수 유형. 유효한 값은 다음과 같습니다. boolean: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다. integer: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다. list: 매개변수 목록을 지정해야 함 map: 매개변수 맵을 지정해야 합니다. template: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다. trigger_reference: 값은 트리거를 나타내며 트리거 ID로 표시됩니다. 사용 가능한 값은 다음과 같습니다. "boolean" "integer" "list" "map" "template" "triggerReference"	쓰기 가능
continuousTimeMinMilliseconds.type	string	매개변수 유형. 유효한 값은 다음과 같습니다. boolean: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다. integer: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다. list: 매개변수 목록을 지정해야 함 map: 매개변수 맵을 지정해야 합니다. template: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다. trigger_reference: 값은 트리거를 나타내며 트리거 ID로 표시됩니다. 사용 가능한 값은 다음과 같습니다. "boolean" "integer" "list" "map" "template" "triggerReference"	쓰기 가능
customEventFilter[].parameter[]	list	조건 유형에 따라 이름이 지정된 매개변수 (키/값) 목록. 참고: 바이너리 연산자의 경우 왼쪽 및 오른쪽 피연산자를 각각 지정하기 위해 arg0 및 arg1라는 매개변수를 포함합니다. 이때 왼쪽 피연산자 (arg0)는 변수 참조여야 합니다. 대소문자를 구분하지 않는 정규식 일치의 경우 true로 설정된 ignore_case이라는 부울 매개변수를 포함합니다. 지정하지 않거나 다른 값으로 설정하면 일치 항목이 대소문자를 구분합니다. 연산자를 무효화하려면 negate 부울 매개변수(true로 설정된 불리언 매개변수)를 포함합니다.	쓰기 가능
customEventFilter[].parameter[].type	string	매개변수 유형. 유효한 값은 다음과 같습니다. boolean: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다. integer: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다. list: 매개변수 목록을 지정해야 함 map: 매개변수 맵을 지정해야 합니다. template: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다. trigger_reference: 값은 트리거를 나타내며 트리거 ID로 표시됩니다. 사용 가능한 값은 다음과 같습니다. "boolean" "integer" "list" "map" "template" "triggerReference"	쓰기 가능
customEventFilter[].type	string	이 조건의 연산자 유형입니다. 사용 가능한 값은 다음과 같습니다. "contains" "cssSelector" "endsWith" "equals" "greater" "greaterOrEquals" "less" "lessOrEquals" "matchRegex" "startsWith" "urlMatches"	쓰기 가능
eventName.type	string	매개변수 유형. 유효한 값은 다음과 같습니다. boolean: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다. integer: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다. list: 매개변수 목록을 지정해야 함 map: 매개변수 맵을 지정해야 합니다. template: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다. trigger_reference: 값은 트리거를 나타내며 트리거 ID로 표시됩니다. 사용 가능한 값은 다음과 같습니다. "boolean" "integer" "list" "map" "template" "triggerReference"	쓰기 가능
filter[].parameter[]	list	조건 유형에 따라 이름이 지정된 매개변수 (키/값) 목록. 참고: 바이너리 연산자의 경우 왼쪽 및 오른쪽 피연산자를 각각 지정하기 위해 arg0 및 arg1라는 매개변수를 포함합니다. 이때 왼쪽 피연산자 (arg0)는 변수 참조여야 합니다. 대소문자를 구분하지 않는 정규식 일치의 경우 true로 설정된 ignore_case이라는 부울 매개변수를 포함합니다. 지정하지 않거나 다른 값으로 설정하면 일치 항목이 대소문자를 구분합니다. 연산자를 무효화하려면 negate 부울 매개변수(true로 설정된 불리언 매개변수)를 포함합니다.	쓰기 가능
filter[].parameter[].type	string	매개변수 유형. 유효한 값은 다음과 같습니다. boolean: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다. integer: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다. list: 매개변수 목록을 지정해야 함 map: 매개변수 맵을 지정해야 합니다. template: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다. trigger_reference: 값은 트리거를 나타내며 트리거 ID로 표시됩니다. 사용 가능한 값은 다음과 같습니다. "boolean" "integer" "list" "map" "template" "triggerReference"	쓰기 가능
filter[].type	string	이 조건의 연산자 유형입니다. 사용 가능한 값은 다음과 같습니다. "contains" "cssSelector" "endsWith" "equals" "greater" "greaterOrEquals" "less" "lessOrEquals" "matchRegex" "startsWith" "urlMatches"	쓰기 가능
horizontalScrollPercentageList.type	string	매개변수 유형. 유효한 값은 다음과 같습니다. boolean: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다. integer: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다. list: 매개변수 목록을 지정해야 함 map: 매개변수 맵을 지정해야 합니다. template: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다. trigger_reference: 값은 트리거를 나타내며 트리거 ID로 표시됩니다. 사용 가능한 값은 다음과 같습니다. "boolean" "integer" "list" "map" "template" "triggerReference"	쓰기 가능
interval.type	string	매개변수 유형. 유효한 값은 다음과 같습니다. boolean: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다. integer: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다. list: 매개변수 목록을 지정해야 함 map: 매개변수 맵을 지정해야 합니다. template: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다. trigger_reference: 값은 트리거를 나타내며 트리거 ID로 표시됩니다. 사용 가능한 값은 다음과 같습니다. "boolean" "integer" "list" "map" "template" "triggerReference"	쓰기 가능
intervalSeconds.type	string	매개변수 유형. 유효한 값은 다음과 같습니다. boolean: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다. integer: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다. list: 매개변수 목록을 지정해야 함 map: 매개변수 맵을 지정해야 합니다. template: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다. trigger_reference: 값은 트리거를 나타내며 트리거 ID로 표시됩니다. 사용 가능한 값은 다음과 같습니다. "boolean" "integer" "list" "map" "template" "triggerReference"	쓰기 가능
limit.type	string	매개변수 유형. 유효한 값은 다음과 같습니다. boolean: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다. integer: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다. list: 매개변수 목록을 지정해야 함 map: 매개변수 맵을 지정해야 합니다. template: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다. trigger_reference: 값은 트리거를 나타내며 트리거 ID로 표시됩니다. 사용 가능한 값은 다음과 같습니다. "boolean" "integer" "list" "map" "template" "triggerReference"	쓰기 가능
maxTimerLengthSeconds.type	string	매개변수 유형. 유효한 값은 다음과 같습니다. boolean: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다. integer: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다. list: 매개변수 목록을 지정해야 함 map: 매개변수 맵을 지정해야 합니다. template: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다. trigger_reference: 값은 트리거를 나타내며 트리거 ID로 표시됩니다. 사용 가능한 값은 다음과 같습니다. "boolean" "integer" "list" "map" "template" "triggerReference"	쓰기 가능
name	string	트리거 표시 이름	쓰기 가능
parameter[].type	string	매개변수 유형. 유효한 값은 다음과 같습니다. boolean: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다. integer: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다. list: 매개변수 목록을 지정해야 함 map: 매개변수 맵을 지정해야 합니다. template: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다. trigger_reference: 값은 트리거를 나타내며 트리거 ID로 표시됩니다. 사용 가능한 값은 다음과 같습니다. "boolean" "integer" "list" "map" "template" "triggerReference"	쓰기 가능
selector.type	string	매개변수 유형. 유효한 값은 다음과 같습니다. boolean: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다. integer: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다. list: 매개변수 목록을 지정해야 함 map: 매개변수 맵을 지정해야 합니다. template: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다. trigger_reference: 값은 트리거를 나타내며 트리거 ID로 표시됩니다. 사용 가능한 값은 다음과 같습니다. "boolean" "integer" "list" "map" "template" "triggerReference"	쓰기 가능
totalTimeMinMilliseconds.type	string	매개변수 유형. 유효한 값은 다음과 같습니다. boolean: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다. integer: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다. list: 매개변수 목록을 지정해야 함 map: 매개변수 맵을 지정해야 합니다. template: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다. trigger_reference: 값은 트리거를 나타내며 트리거 ID로 표시됩니다. 사용 가능한 값은 다음과 같습니다. "boolean" "integer" "list" "map" "template" "triggerReference"	쓰기 가능
uniqueTriggerId.type	string	매개변수 유형. 유효한 값은 다음과 같습니다. boolean: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다. integer: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다. list: 매개변수 목록을 지정해야 함 map: 매개변수 맵을 지정해야 합니다. template: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다. trigger_reference: 값은 트리거를 나타내며 트리거 ID로 표시됩니다. 사용 가능한 값은 다음과 같습니다. "boolean" "integer" "list" "map" "template" "triggerReference"	쓰기 가능
verticalScrollPercentageList.type	string	매개변수 유형. 유효한 값은 다음과 같습니다. boolean: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다. integer: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다. list: 매개변수 목록을 지정해야 함 map: 매개변수 맵을 지정해야 합니다. template: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다. trigger_reference: 값은 트리거를 나타내며 트리거 ID로 표시됩니다. 사용 가능한 값은 다음과 같습니다. "boolean" "integer" "list" "map" "template" "triggerReference"	쓰기 가능
visibilitySelector.type	string	매개변수 유형. 유효한 값은 다음과 같습니다. boolean: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다. integer: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다. list: 매개변수 목록을 지정해야 함 map: 매개변수 맵을 지정해야 합니다. template: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다. trigger_reference: 값은 트리거를 나타내며 트리거 ID로 표시됩니다. 사용 가능한 값은 다음과 같습니다. "boolean" "integer" "list" "map" "template" "triggerReference"	쓰기 가능
visiblePercentageMax.type	string	매개변수 유형. 유효한 값은 다음과 같습니다. boolean: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다. integer: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다. list: 매개변수 목록을 지정해야 함 map: 매개변수 맵을 지정해야 합니다. template: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다. trigger_reference: 값은 트리거를 나타내며 트리거 ID로 표시됩니다. 사용 가능한 값은 다음과 같습니다. "boolean" "integer" "list" "map" "template" "triggerReference"	쓰기 가능
visiblePercentageMin.type	string	매개변수 유형. 유효한 값은 다음과 같습니다. boolean: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다. integer: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다. list: 매개변수 목록을 지정해야 함 map: 매개변수 맵을 지정해야 합니다. template: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다. trigger_reference: 값은 트리거를 나타내며 트리거 ID로 표시됩니다. 사용 가능한 값은 다음과 같습니다. "boolean" "integer" "list" "map" "template" "triggerReference"	쓰기 가능
waitForTags.type	string	매개변수 유형. 유효한 값은 다음과 같습니다. boolean: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다. integer: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다. list: 매개변수 목록을 지정해야 함 map: 매개변수 맵을 지정해야 합니다. template: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다. trigger_reference: 값은 트리거를 나타내며 트리거 ID로 표시됩니다. 사용 가능한 값은 다음과 같습니다. "boolean" "integer" "list" "map" "template" "triggerReference"	쓰기 가능
waitForTagsTimeout.type	string	매개변수 유형. 유효한 값은 다음과 같습니다. boolean: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다. integer: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다. list: 매개변수 목록을 지정해야 함 map: 매개변수 맵을 지정해야 합니다. template: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다. trigger_reference: 값은 트리거를 나타내며 트리거 ID로 표시됩니다. 사용 가능한 값은 다음과 같습니다. "boolean" "integer" "list" "map" "template" "triggerReference"	쓰기 가능
선택적 속성
autoEventFilter[]	list	자동 이벤트 추적의 경우에 사용됩니다.	쓰기 가능
autoEventFilter[].parameter[].key	string	매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다.	쓰기 가능
autoEventFilter[].parameter[].list[]	list	이 목록 매개변수의 매개변수입니다 (키는 무시됨).	쓰기 가능
autoEventFilter[].parameter[].map[]	list	이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함).	쓰기 가능
autoEventFilter[].parameter[].value	string	지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음)	쓰기 가능
checkValidation	nested object	유효성 검사 등으로 인해 양식 제출 또는 링크 클릭 이벤트가 다른 이벤트 핸들러에 의해 취소되지 않은 경우에만 태그를 실행해야 하는지 여부입니다. 양식 제출 및 링크 클릭 트리거에만 유효합니다.	쓰기 가능
checkValidation.key	string	매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다.	쓰기 가능
checkValidation.list[]	list	이 목록 매개변수의 매개변수입니다 (키는 무시됨).	쓰기 가능
checkValidation.map[]	list	이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함).	쓰기 가능
checkValidation.value	string	지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음)	쓰기 가능
continuousTimeMinMilliseconds	nested object	공개 상태 트리거는 최소 연속 표시 시간 (밀리초)입니다. AMP 공개 상태 트리거에만 유효합니다.	쓰기 가능
continuousTimeMinMilliseconds.key	string	매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다.	쓰기 가능
continuousTimeMinMilliseconds.list[]	list	이 목록 매개변수의 매개변수입니다 (키는 무시됨).	쓰기 가능
continuousTimeMinMilliseconds.map[]	list	이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함).	쓰기 가능
continuousTimeMinMilliseconds.value	string	지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음)	쓰기 가능
customEventFilter[]	list	모든 조건이 true인 경우 실행되는 맞춤 이벤트의 경우 사용됩니다.	쓰기 가능
customEventFilter[].parameter[].key	string	매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다.	쓰기 가능
customEventFilter[].parameter[].list[]	list	이 목록 매개변수의 매개변수입니다 (키는 무시됨).	쓰기 가능
customEventFilter[].parameter[].map[]	list	이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함).	쓰기 가능
customEventFilter[].parameter[].value	string	지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음)	쓰기 가능
eventName	nested object	발생한 GTM 이벤트의 이름입니다. 타이머 트리거에만 유효합니다.	쓰기 가능
eventName.key	string	매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다.	쓰기 가능
eventName.list[]	list	이 목록 매개변수의 매개변수입니다 (키는 무시됨).	쓰기 가능
eventName.map[]	list	이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함).	쓰기 가능
eventName.value	string	지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음)	쓰기 가능
filter[]	list	모든 조건이 충족되는 경우에만 트리거가 실행됩니다.	쓰기 가능
filter[].parameter[].key	string	매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다.	쓰기 가능
filter[].parameter[].list[]	list	이 목록 매개변수의 매개변수입니다 (키는 무시됨).	쓰기 가능
filter[].parameter[].map[]	list	이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함).	쓰기 가능
filter[].parameter[].value	string	지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음)	쓰기 가능
horizontalScrollPercentageList	nested object	스크롤 트리거의 정수 백분율 값 목록입니다. 뷰를 가로로 스크롤할 때 각 비율에 도달하면 트리거가 실행됩니다. AMP 스크롤 트리거에만 유효합니다.	쓰기 가능
horizontalScrollPercentageList.key	string	매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다.	쓰기 가능
horizontalScrollPercentageList.list[]	list	이 목록 매개변수의 매개변수입니다 (키는 무시됨).	쓰기 가능
horizontalScrollPercentageList.map[]	list	이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함).	쓰기 가능
horizontalScrollPercentageList.value	string	지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음)	쓰기 가능
interval	nested object	반복 타이머 이벤트 트리거 사이의 시간 (밀리초)입니다. 타이머 트리거에만 유효합니다.	쓰기 가능
interval.key	string	매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다.	쓰기 가능
interval.list[]	list	이 목록 매개변수의 매개변수입니다 (키는 무시됨).	쓰기 가능
interval.map[]	list	이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함).	쓰기 가능
interval.value	string	지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음)	쓰기 가능
intervalSeconds	nested object	타이머 이벤트 실행 간격 (초)입니다. AMP 타이머 트리거에만 유효합니다.	쓰기 가능
intervalSeconds.key	string	매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다.	쓰기 가능
intervalSeconds.list[]	list	이 목록 매개변수의 매개변수입니다 (키는 무시됨).	쓰기 가능
intervalSeconds.map[]	list	이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함).	쓰기 가능
intervalSeconds.value	string	지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음)	쓰기 가능
limit	nested object	이 타이머 트리거가 실행할 GTM 이벤트 수의 제한입니다. 제한이 설정되지 않은 경우 사용자가 페이지를 떠날 때까지 GTM 이벤트가 계속 실행됩니다. 타이머 트리거에만 유효합니다.	쓰기 가능
limit.key	string	매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다.	쓰기 가능
limit.list[]	list	이 목록 매개변수의 매개변수입니다 (키는 무시됨).	쓰기 가능
limit.map[]	list	이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함).	쓰기 가능
limit.value	string	지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음)	쓰기 가능
maxTimerLengthSeconds	nested object	타이머 이벤트를 실행할 최대 시간 (초)입니다. AMP 타이머 트리거에만 유효합니다.	쓰기 가능
maxTimerLengthSeconds.key	string	매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다.	쓰기 가능
maxTimerLengthSeconds.list[]	list	이 목록 매개변수의 매개변수입니다 (키는 무시됨).	쓰기 가능
maxTimerLengthSeconds.map[]	list	이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함).	쓰기 가능
maxTimerLengthSeconds.value	string	지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음)	쓰기 가능
parameter[].key	string	매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다.	쓰기 가능
parameter[].list[]	list	이 목록 매개변수의 매개변수입니다 (키는 무시됨).	쓰기 가능
parameter[].map[]	list	이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함).	쓰기 가능
parameter[].value	string	지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음)	쓰기 가능
selector	nested object	클릭 트리거 CSS 선택자 (예: 'a', 'button' 등)입니다. AMP 클릭 트리거에만 유효합니다.	쓰기 가능
selector.key	string	매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다.	쓰기 가능
selector.list[]	list	이 목록 매개변수의 매개변수입니다 (키는 무시됨).	쓰기 가능
selector.map[]	list	이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함).	쓰기 가능
selector.value	string	지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음)	쓰기 가능
totalTimeMinMilliseconds	nested object	공개 상태 트리거의 최소 총 표시 시간 (밀리초)입니다. AMP 공개 상태 트리거에만 유효합니다.	쓰기 가능
totalTimeMinMilliseconds.key	string	매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다.	쓰기 가능
totalTimeMinMilliseconds.list[]	list	이 목록 매개변수의 매개변수입니다 (키는 무시됨).	쓰기 가능
totalTimeMinMilliseconds.map[]	list	이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함).	쓰기 가능
totalTimeMinMilliseconds.value	string	지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음)	쓰기 가능
type	string	이 트리거를 야기하는 데이터 영역 이벤트를 정의합니다. 사용 가능한 값은 다음과 같습니다. "always" "ampClick" "ampScroll" "ampTimer" "ampVisibility" "click" "customEvent" "domReady" "elementVisibility" "formSubmission" "historyChange" "jsError" "linkClick" "pageview" "scrollDepth" "timer" "triggerGroup" "windowLoaded" "youTubeVideo"	쓰기 가능
uniqueTriggerId	nested object	양식 제출, 링크 클릭 또는 타이머 리스너 (양식 제출, 링크 클릭 또는 타이머 리스너)를 자동으로 생성하는 트리거의 전역적으로 고유한 ID입니다. 호환되지 않는 자동 이벤트가 트리거 ID에 기반한 트리거 필터링과 함께 작동하도록 하는 데 사용됩니다. 트리거에 의해 암시된 태그가 그때까지는 존재하지 않으므로 이 값은 출력 생성 중에 채워집니다. 양식 제출, 링크 클릭 및 타이머 트리거에만 유효합니다.	쓰기 가능
uniqueTriggerId.key	string	매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다.	쓰기 가능
uniqueTriggerId.list[]	list	이 목록 매개변수의 매개변수입니다 (키는 무시됨).	쓰기 가능
uniqueTriggerId.map[]	list	이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함).	쓰기 가능
uniqueTriggerId.value	string	지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음)	쓰기 가능
verticalScrollPercentageList	nested object	스크롤 트리거의 정수 백분율 값 목록입니다. 뷰를 세로로 스크롤할 때 각 비율에 도달하면 트리거가 실행됩니다. AMP 스크롤 트리거에만 유효합니다.	쓰기 가능
verticalScrollPercentageList.key	string	매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다.	쓰기 가능
verticalScrollPercentageList.list[]	list	이 목록 매개변수의 매개변수입니다 (키는 무시됨).	쓰기 가능
verticalScrollPercentageList.map[]	list	이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함).	쓰기 가능
verticalScrollPercentageList.value	string	지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음)	쓰기 가능
visibilitySelector	nested object	가시성으로 인해 CSS 선택자가 트리거됩니다 (예: '#id'). AMP 공개 상태 트리거에만 유효합니다.	쓰기 가능
visibilitySelector.key	string	매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다.	쓰기 가능
visibilitySelector.list[]	list	이 목록 매개변수의 매개변수입니다 (키는 무시됨).	쓰기 가능
visibilitySelector.map[]	list	이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함).	쓰기 가능
visibilitySelector.value	string	지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음)	쓰기 가능
visiblePercentageMax	nested object	가시성은 최대 공개 상태를 트리거합니다. AMP 공개 상태 트리거에만 유효합니다.	쓰기 가능
visiblePercentageMax.key	string	매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다.	쓰기 가능
visiblePercentageMax.list[]	list	이 목록 매개변수의 매개변수입니다 (키는 무시됨).	쓰기 가능
visiblePercentageMax.map[]	list	이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함).	쓰기 가능
visiblePercentageMax.value	string	지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음)	쓰기 가능
visiblePercentageMin	nested object	가시성은 최소 노출률(%)을 트리거합니다. AMP 공개 상태 트리거에만 유효합니다.	쓰기 가능
visiblePercentageMin.key	string	매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다.	쓰기 가능
visiblePercentageMin.list[]	list	이 목록 매개변수의 매개변수입니다 (키는 무시됨).	쓰기 가능
visiblePercentageMin.map[]	list	이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함).	쓰기 가능
visiblePercentageMin.value	string	지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음)	쓰기 가능
waitForTags	nested object	모든 태그가 실행될 때까지 (기본 작업을 차단하고 나중에 기본 작업을 시뮬레이션하여) 양식 제출 또는 링크 열기를 지연시켜야 하는지 여부입니다. 양식 제출 및 링크 클릭 트리거에만 유효합니다.	쓰기 가능
waitForTags.key	string	매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다.	쓰기 가능
waitForTags.list[]	list	이 목록 매개변수의 매개변수입니다 (키는 무시됨).	쓰기 가능
waitForTags.map[]	list	이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함).	쓰기 가능
waitForTags.value	string	지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음)	쓰기 가능
waitForTagsTimeout	nested object	위의 'waits_for_tags'가 true로 평가될 때 태그가 실행될 때까지 기다리는 시간 (밀리초)입니다. 양식 제출 및 링크 클릭 트리거에만 유효합니다.	쓰기 가능
waitForTagsTimeout.key	string	매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다.	쓰기 가능
waitForTagsTimeout.list[]	list	이 목록 매개변수의 매개변수입니다 (키는 무시됨).	쓰기 가능
waitForTagsTimeout.map[]	list	이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함).	쓰기 가능
waitForTagsTimeout.value	string	지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음)	쓰기 가능

응답

요청에 성공할 경우 이 메서드는 응답 본문에 트리거 리소스를 반환합니다.

예

참고: 이 메서드에 제공되는 코드 예시가 지원되는 모든 프로그래밍 언어를 나타내는 것은 아닙니다. 지원되는 언어 목록은 클라이언트 라이브러리 페이지를 참조하세요.

Java

자바 클라이언트 라이브러리를 사용합니다.

/*
 * Note: This code assumes you have an authorized tagmanager service object.
 */

/*
 * This request updates an existing trigger for the authorized user.
 */

// Create the condition parameters objects.
Parameter arg0 = new Parameter();
arg0.setType("template");
arg0.setKey("arg0");
arg0.setValue("{{Page URL}}");
Parameter arg1 = new Parameter();
arg1.setType("template");
arg1.setKey("arg1");
arg1.setValue("timed.html");

// Create the auto event condition object.
Condition condition = new Condition();
condition.setType("contains");
condition.setParameter(Arrays.asList(arg0, arg1));

// Create the event parameter.
Parameter eventName = new Parameter();
eventName.setType("template");
eventName.setValue("gtm.timer");

// Create the interval parameter.
Parameter interval = new Parameter();
interval.setType("template");
interval.setValue("10000");

// Create the limit parameter.
Parameter limit = new Parameter();
limit.setType("template");
limit.setValue("10");

// Create the trigger object.
Trigger trigger = new Trigger();
trigger.setName("Updated Timer Trigger");
trigger.setType("timer");
trigger.setAutoEventFilter(Arrays.asList(condition));
trigger.setEventName(eventName);
trigger.setInterval(interval);
trigger.setLimit(limit);

try {
  Trigger response = tagmanager.accounts().containers().
      triggers().update("123456", "54321", "1", trigger).execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

/*
 * The results of the update method are stored in the response object.
 * The following code shows how to access the updated name and fingerprint.
 */
System.out.println("Updated Name = " + response.getName());
System.out.println("Updated Fingerprint = " + response.getFingerprint());

Python

Python 클라이언트 라이브러리를 사용합니다.

# Note: This code assumes you have an authorized tagmanager service object.

# This request updates an existing trigger.
try:
  response = tagmanager.accounts().containers().triggers().update(
      accountId='123456',
      containerId='54321',
      triggerId='3',
      body={
          'name': 'Updated Timed trigger',
          'type': 'timer',
          'autoEventFilter': [
              {
                  'type': 'contains',
                  'parameter': [
                      {
                          'type': 'template',
                          'key': 'arg0',
                          'value': '{{Page URL}}'
                      },
                      {
                          'type': 'template',
                          'key': 'arg1',
                          'value': 'timed.html'
                      }
                  ]
              }
          ],
          'eventName': {
              'type': 'template',
              'value': 'gtm.timer'
          },
          'interval': {
              'type': 'template',
              'value': '10000'
          },
          'limit': {
              'type': 'template',
              'value': '10'
          }
      }
  ).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 update method are stored in the response object.
# The following code shows how to access the updated name and fingerprint.
print 'Updated Name = %s' % response.get('name')
print 'Updated Fingerprint = %s' % response.get('fingerprint')

사용해 보기

아래의 API 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.