Variables: create

GTM 변수를 만듭니다. 지금 사용해 보기

요청

HTTP 요청

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

매개변수

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

승인

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

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

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

요청 본문

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

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


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


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


사용 가능한 값은 다음과 같습니다.
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 쓰기 가능
formatValue.convertUndefinedToValue.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"
 쓰기 가능
type string GTM 변수 유형입니다. 쓰기 가능
선택적 속성
disablingTriggerId[] list 모바일 컨테이너에만 해당: 조건부 변수를 사용 중지하기 위한 트리거 ID 목록입니다. 사용 설정 트리거 중 하나가 true이고 모든 중지 트리거가 false인 경우 변수가 사용 설정됩니다. 순서가 지정되지 않은 집합으로 처리됩니다. 쓰기 가능
enablingTriggerId[] list 모바일 컨테이너에만 해당: 조건부 변수를 사용 설정하기 위한 트리거 ID 목록입니다. 사용 설정 트리거 중 하나가 true이고 모든 비활성화 트리거가 false인 경우 변수가 사용 설정됩니다. 순서가 지정되지 않은 집합으로 처리됩니다. 쓰기 가능
formatValue.convertFalseToValue.key string 매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다. 쓰기 가능
formatValue.convertFalseToValue.list[] list 이 목록 매개변수의 매개변수입니다 (키는 무시됨). 쓰기 가능
formatValue.convertFalseToValue.map[] list 이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함). 쓰기 가능
formatValue.convertFalseToValue.value string 지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음) 쓰기 가능
formatValue.convertNullToValue.key string 매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다. 쓰기 가능
formatValue.convertNullToValue.list[] list 이 목록 매개변수의 매개변수입니다 (키는 무시됨). 쓰기 가능
formatValue.convertNullToValue.map[] list 이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함). 쓰기 가능
formatValue.convertNullToValue.value string 지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음) 쓰기 가능
formatValue.convertTrueToValue.key string 매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다. 쓰기 가능
formatValue.convertTrueToValue.list[] list 이 목록 매개변수의 매개변수입니다 (키는 무시됨). 쓰기 가능
formatValue.convertTrueToValue.map[] list 이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함). 쓰기 가능
formatValue.convertTrueToValue.value string 지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음) 쓰기 가능
formatValue.convertUndefinedToValue.key string 매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다. 쓰기 가능
formatValue.convertUndefinedToValue.list[] list 이 목록 매개변수의 매개변수입니다 (키는 무시됨). 쓰기 가능
formatValue.convertUndefinedToValue.map[] list 이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함). 쓰기 가능
formatValue.convertUndefinedToValue.value string 지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음) 쓰기 가능
notes string 컨테이너에서 이 변수를 적용하는 방법에 관한 사용자 메모 쓰기 가능
parameter[] list 변수의 매개변수입니다. 쓰기 가능
parameter[].key string 매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다. 쓰기 가능
parameter[].list[] list 이 목록 매개변수의 매개변수입니다 (키는 무시됨). 쓰기 가능
parameter[].map[] list 이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함). 쓰기 가능
parameter[].value string 지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음) 쓰기 가능
scheduleEndMs long 변수를 예약할 종료 타임스탬프(밀리초)입니다. 쓰기 가능
scheduleStartMs long 변수를 예약할 시작 타임스탬프(밀리초)입니다. 쓰기 가능

응답

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

사용해 보기

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