승인 필요
GTM 태그를 업데이트합니다. 지금 사용해 보기 또는 예시를 확인하세요.
요청
HTTP 요청
PUT https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/tags/tagId
매개변수
매개변수 이름 | 값 | 설명 |
---|---|---|
경로 매개변수 | ||
accountId |
string |
GTM 계정 ID입니다. |
containerId |
string |
GTM 컨테이너 ID입니다. |
tagId |
string |
GTM 태그 ID입니다. |
선택적 쿼리 매개변수 | ||
fingerprint |
string |
제공되는 경우 이 디지털 지문은 저장소에 있는 태그의 디지털 지문과 일치해야 합니다. |
승인
이 요청을 처리하려면 다음 범위의 승인을 받아야 합니다 (인증 및 승인 자세히 알아보기).
범위 |
---|
https://www.googleapis.com/auth/tagmanager.edit.containers |
요청 본문
요청 본문에서는 다음과 같은 속성을 사용하여 태그 리소스를 제공합니다.
속성 이름 | 값 | 설명 | Notes |
---|---|---|---|
필수 속성 | |||
name |
string |
태그 표시 이름입니다. | 쓰기 가능 |
parameter[].type |
string |
매개변수 유형. 유효한 값은 다음과 같습니다.
사용 가능한 값은 다음과 같습니다.
|
쓰기 가능 |
priority.type |
string |
매개변수 유형. 유효한 값은 다음과 같습니다.
사용 가능한 값은 다음과 같습니다.
|
쓰기 가능 |
선택적 속성 | |||
blockingRuleId[] |
list |
차단 규칙 ID를 클릭합니다. 나열된 규칙 중 하나라도 true로 판정되면 태그가 실행되지 않습니다. | 쓰기 가능 |
blockingTriggerId[] |
list |
차단 트리거 ID 목록에 있는 트리거 중 하나라도 true로 판정되면 태그가 실행되지 않습니다. | 쓰기 가능 |
firingRuleId[] |
list |
규칙 ID를 실행하는 중입니다. 나열된 규칙 중 하나가 true이고 모든 blockingRuleIds (지정된 경우)이 false일 때 태그가 실행됩니다. |
쓰기 가능 |
firingTriggerId[] |
list |
트리거 ID를 실행하는 중입니다. 나열된 트리거 중 하나가 true이고 모든 blockingTriggerIds (지정된 경우)이 false일 때 태그가 실행됩니다. |
쓰기 가능 |
liveOnly |
boolean |
true로 설정하면 이 태그는 실제 환경에서만 실행됩니다 (예: 미리보기 또는 디버그 모드에서는 실행되지 않음). | 쓰기 가능 |
notes |
string |
컨테이너에서 이 태그를 적용하는 방법에 대한 사용자 메모 | 쓰기 가능 |
parameter[] |
list |
태그의 매개변수입니다. | 쓰기 가능 |
parameter[].key |
string |
매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다. | 쓰기 가능 |
parameter[].list[] |
list |
이 목록 매개변수의 매개변수입니다 (키는 무시됨). | 쓰기 가능 |
parameter[].map[] |
list |
이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함). | 쓰기 가능 |
parameter[].value |
string |
지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음) | 쓰기 가능 |
paused |
boolean |
태그가 일시중지 상태인 경우 true입니다. | 쓰기 가능 |
priority |
nested object |
사용자가 정의한 태그의 숫자 우선순위입니다. 태그는 우선순위에 따라 비동기식으로 실행됩니다. 숫자 값이 더 큰 태그가 먼저 실행됩니다. 태그의 우선순위는 양수 또는 음수일 수 있습니다. 기본값은 0입니다. | 쓰기 가능 |
priority.key |
string |
매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다. | 쓰기 가능 |
priority.list[] |
list |
이 목록 매개변수의 매개변수입니다 (키는 무시됨). | 쓰기 가능 |
priority.map[] |
list |
이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함). | 쓰기 가능 |
priority.value |
string |
지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음) | 쓰기 가능 |
scheduleEndMs |
long |
태그를 예약할 종료 타임스탬프(밀리초)입니다. | 쓰기 가능 |
scheduleStartMs |
long |
태그를 예약할 시작 타임스탬프(밀리초)입니다. | 쓰기 가능 |
type |
string |
GTM 태그 유형입니다. | 쓰기 가능 |
응답
요청에 성공할 경우 이 메서드는 응답 본문에 태그 리소스를 반환합니다.
예
참고: 이 메서드에 제공되는 코드 예시가 지원되는 모든 프로그래밍 언어를 나타내는 것은 아닙니다. 지원되는 언어 목록은 클라이언트 라이브러리 페이지를 참조하세요.
Java
자바 클라이언트 라이브러리를 사용합니다.
/* * Note: This code assumes you have an authorized tagmanager service object. */ /* * This request updates an existing tag for the authorized user. */ // 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.setType("ua"); tag.setLiveOnly(false); tag.setParameter(Arrays.asList(arg0, arg1)); try { Tag response = tagmanager.accounts(). containers().tags().update("123456", "54321", "1", tag).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 new container tag. try: response = tagmanager.accounts().containers().tags().update( accountId='123456', containerId='54321', tagId='1', 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 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 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.