Tags: create

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

GTM 태그를 만듭니다. 지금 사용해 보기

요청

HTTP 요청

POST https://www.googleapis.com/tagmanager/v2/+parent/tags

매개변수

매개변수 이름 설명
경로 매개변수
parent string GTM Workspace의 API 상대 경로입니다. 예: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}

확인할 내용

다음 범위를 사용하여 이 요청을 인증받아야 합니다.

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

자세한 내용은 인증 및 승인 페이지를 참고하세요.

요청 본문

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

속성 이름 설명 메모
필수 속성
consentSettings.consentType.type string 매개변수 유형입니다. 유효한 값은 다음과 같습니다.
  • boolean: 값이 'true' 또는 'false'로 표시되는 부울을 나타냅니다.
  • integer: 값이 10진수로 부호 있는 64비트 정수 값입니다.
  • list: 매개변수 목록을 지정해야 합니다.
  • map: 매개변수 맵을 지정해야 합니다.
  • template: 값이 텍스트를 나타냅니다. 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조 포함)도 포함될 수 있습니다.
  • trigger_reference: 값이 트리거 ID로 표시되는 트리거를 나타냅니다.
  • tag_reference: 값은 태그를 나타내며 태그 이름으로 표시됩니다.


사용 가능한 값은 다음과 같습니다.
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
쓰기 가능
monitoringMetadata.type string 매개변수 유형입니다. 유효한 값은 다음과 같습니다.
  • boolean: 값이 'true' 또는 'false'로 표시되는 부울을 나타냅니다.
  • integer: 값이 10진수로 부호 있는 64비트 정수 값입니다.
  • list: 매개변수 목록을 지정해야 합니다.
  • map: 매개변수 맵을 지정해야 합니다.
  • template: 값이 텍스트를 나타냅니다. 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조 포함)도 포함될 수 있습니다.
  • trigger_reference: 값이 트리거 ID로 표시되는 트리거를 나타냅니다.
  • tag_reference: 값은 태그를 나타내며 태그 이름으로 표시됩니다.


사용 가능한 값은 다음과 같습니다.
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
쓰기 가능
name string 태그 표시 이름입니다. 쓰기 가능
parameter[].type string 매개변수 유형입니다. 유효한 값은 다음과 같습니다.
  • boolean: 값이 'true' 또는 'false'로 표시되는 부울을 나타냅니다.
  • integer: 값이 10진수로 부호 있는 64비트 정수 값입니다.
  • list: 매개변수 목록을 지정해야 합니다.
  • map: 매개변수 맵을 지정해야 합니다.
  • template: 값이 텍스트를 나타냅니다. 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조 포함)도 포함될 수 있습니다.
  • trigger_reference: 값이 트리거 ID로 표시되는 트리거를 나타냅니다.
  • tag_reference: 값은 태그를 나타내며 태그 이름으로 표시됩니다.


사용 가능한 값은 다음과 같습니다.
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
쓰기 가능
priority.type string 매개변수 유형입니다. 유효한 값은 다음과 같습니다.
  • boolean: 값이 'true' 또는 'false'로 표시되는 부울을 나타냅니다.
  • integer: 값이 10진수로 부호 있는 64비트 정수 값입니다.
  • list: 매개변수 목록을 지정해야 합니다.
  • map: 매개변수 맵을 지정해야 합니다.
  • template: 값이 텍스트를 나타냅니다. 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조 포함)도 포함될 수 있습니다.
  • trigger_reference: 값이 트리거 ID로 표시되는 트리거를 나타냅니다.
  • tag_reference: 값은 태그를 나타내며 태그 이름으로 표시됩니다.


사용 가능한 값은 다음과 같습니다.
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
쓰기 가능
type string GTM 태그 유형입니다. 쓰기 가능
선택 속성
blockingRuleId[] list 차단 규칙 ID. 나열된 규칙 중 하나라도 참으로 판정되면 태그가 실행되지 않습니다. 쓰기 가능
blockingTriggerId[] list 트리거 ID 차단 나열된 트리거 중 하나라도 true로 평가되면 태그가 실행되지 않습니다. 쓰기 가능
consentSettings nested object 태그의 동의 설정 쓰기 가능
consentSettings.consentType.key string 매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값에서는 무시됩니다. 쓰기 가능
consentSettings.consentType.list[] list 이 목록 매개변수의 매개변수 (키는 무시됨) 쓰기 가능
consentSettings.consentType.map[] list 이 지도 매개변수의 매개변수 (키가 있어야 하며 키는 고유해야 함) 쓰기 가능
consentSettings.consentType.value string 지정된 유형에 적합한 매개변수 값(''와 같은 변수 참조가 포함될 수 있음). 쓰기 가능
firingRuleId[] list 실행 규칙 ID. 나열된 규칙 중 하나라도 true이고 모든 blockingRuleIds (지정된 경우)가 false이면 태그가 실행됩니다. 쓰기 가능
firingTriggerId[] list 실행 트리거 ID 나열된 트리거 중 하나라도 true이고 모든 blockingTriggerIds(지정된 경우)가 false이면 태그가 실행됩니다. 쓰기 가능
liveOnly boolean true로 설정하면 이 태그가 실제 환경에서만 실행됩니다 (예: 미리보기 또는 디버그 모드가 아님). 쓰기 가능
monitoringMetadata nested object 태그 모니터링을 위한 이벤트 데이터에 포함될 태그 메타데이터의 키-값 쌍의 맵입니다. 참고:
  • 이 매개변수는 MAP 유형이어야 합니다.
  • 맵의 각 매개변수는 TEMPLATE 유형이지만 변수 참조를 포함할 수 없습니다.
쓰기 가능
monitoringMetadata.key string 매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값에서는 무시됩니다. 쓰기 가능
monitoringMetadata.list[] list 이 목록 매개변수의 매개변수 (키는 무시됨) 쓰기 가능
monitoringMetadata.map[] list 이 지도 매개변수의 매개변수 (키가 있어야 하며 키는 고유해야 함) 쓰기 가능
monitoringMetadata.value string 지정된 유형에 적합한 매개변수 값(''와 같은 변수 참조가 포함될 수 있음). 쓰기 가능
monitoringMetadataTagNameKey string 비어 있지 않으면 지정된 키를 사용하여 모니터링 메타데이터 맵에 태그 표시 이름이 포함됩니다. 쓰기 가능
notes string 사용자가 컨테이너에 이 태그를 적용하는 방법을 메모합니다. 쓰기 가능
parameter[] list 태그의 매개변수입니다. 쓰기 가능
parameter[].key string 매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값에서는 무시됩니다. 쓰기 가능
parameter[].list[] list 이 목록 매개변수의 매개변수 (키는 무시됨) 쓰기 가능
parameter[].map[] list 이 지도 매개변수의 매개변수 (키가 있어야 하며 키는 고유해야 함) 쓰기 가능
parameter[].value string 지정된 유형에 적합한 매개변수 값(''와 같은 변수 참조가 포함될 수 있음). 쓰기 가능
paused boolean 태그가 일시중지 상태인지 여부를 나타내며, 이로 인해 태그가 실행되지 않습니다. 쓰기 가능
priority nested object 태그의 사용자 정의 숫자 우선순위 태그는 우선순위에 따라 비동기적으로 실행됩니다. 숫자 값이 큰 태그가 먼저 실행됩니다. 태그의 우선순위는 양수 또는 음수 값이 될 수 있습니다. 기본값은 0입니다. 쓰기 가능
priority.key string 매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값에서는 무시됩니다. 쓰기 가능
priority.list[] list 이 목록 매개변수의 매개변수 (키는 무시됨) 쓰기 가능
priority.map[] list 이 지도 매개변수의 매개변수 (키가 있어야 하며 키는 고유해야 함) 쓰기 가능
priority.value string 지정된 유형에 적합한 매개변수 값(''와 같은 변수 참조가 포함될 수 있음). 쓰기 가능
scheduleEndMs long 태그를 예약할 종료 타임스탬프(밀리초)입니다. 쓰기 가능
scheduleStartMs long 태그를 예약할 시작 시간(밀리초)입니다. 쓰기 가능

응답

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

사용해 보기

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