이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Tags: update

승인 필요

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`	매개변수 유형. 유효한 값은 다음과 같습니다. `boolean`: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다. `integer`: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다. `list`: 매개변수 목록을 지정해야 함 `map`: 매개변수 맵을 지정해야 합니다. `template`: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다. `trigger_reference`: 값은 트리거를 나타내며 트리거 ID로 표시됩니다. 사용 가능한 값은 다음과 같습니다. "`boolean`" "`integer`" "`list`" "`map`" "`template`" "`triggerReference`"	쓰기 가능
`priority.type`	`string`	매개변수 유형. 유효한 값은 다음과 같습니다. `boolean`: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다. `integer`: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다. `list`: 매개변수 목록을 지정해야 함 `map`: 매개변수 맵을 지정해야 합니다. `template`: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다. `trigger_reference`: 값은 트리거를 나타내며 트리거 ID로 표시됩니다. 사용 가능한 값은 다음과 같습니다. "`boolean`" "`integer`" "`list`" "`map`" "`template`" "`triggerReference`"	쓰기 가능
선택적 속성
`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 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.