Variables

이 리소스에 대한 메소드 목록은 이 페이지의 하단에 나와 있습니다.

리소스 표현

Google 태그 관리자 변수를 나타냅니다.

{
  "path": string,
  "accountId": string,
  "containerId": string,
  "workspaceId": string,
  "variableId": string,
  "name": string,
  "type": string,
  "notes": string,
  "scheduleStartMs": long,
  "scheduleEndMs": long,
  "parameter": [
    {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ],
      "isWeakReference": boolean
    }
  ],
  "enablingTriggerId": [
    string
  ],
  "disablingTriggerId": [
    string
  ],
  "fingerprint": string,
  "parentFolderId": string,
  "tagManagerUrl": string,
  "formatValue": {
    "caseConversionType": string,
    "convertNullToValue": {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ],
      "isWeakReference": boolean
    },
    "convertUndefinedToValue": {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ],
      "isWeakReference": boolean
    },
    "convertTrueToValue": {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ],
      "isWeakReference": boolean
    },
    "convertFalseToValue": {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ],
      "isWeakReference": boolean
    }
  }
}
속성 이름 설명 Notes
accountId string GTM 계정 ID입니다.
containerId string GTM 컨테이너 ID입니다.
disablingTriggerId[] list 모바일 컨테이너에만 해당: 조건부 변수를 사용 중지하기 위한 트리거 ID 목록입니다. 사용 설정 트리거 중 하나가 true이고 모든 중지 트리거가 false인 경우 변수가 사용 설정됩니다. 순서가 지정되지 않은 집합으로 처리됩니다. 쓰기 가능
enablingTriggerId[] list 모바일 컨테이너에만 해당: 조건부 변수를 사용 설정하기 위한 트리거 ID 목록입니다. 사용 설정 트리거 중 하나가 true이고 모든 비활성화 트리거가 false인 경우 변수가 사용 설정됩니다. 순서가 지정되지 않은 집합으로 처리됩니다. 쓰기 가능
fingerprint string 저장 시점에 계산된 GTM 변수의 디지털 지문입니다. 이 값은 변수가 수정될 때마다 다시 계산됩니다.
formatValue nested object 변수 값을 다른 값으로 변환하는 옵션입니다.
formatValue.caseConversionType string 문자열 유형 변수 값을 소문자 또는 대문자로 변환하는 옵션입니다.

사용 가능한 값은 다음과 같습니다.
  • "lowercase"
  • "none"
  • "uppercase"
formatValue.convertFalseToValue nested object 변수 값이 false인 경우 변환할 값입니다.
formatValue.convertFalseToValue.isWeakReference boolean 참조 유형 매개변수가 강하게 참조되거나 약하게 참조되는지 여부입니다. 변환에서만 사용됩니다. 쓰기 가능
formatValue.convertFalseToValue.key string 매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다. 쓰기 가능
formatValue.convertFalseToValue.list[] list 이 목록 매개변수의 매개변수입니다 (키는 무시됨). 쓰기 가능
formatValue.convertFalseToValue.map[] list 이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함). 쓰기 가능
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.convertFalseToValue.value string 지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음) 쓰기 가능
formatValue.convertNullToValue nested object 변수 값이 null인 경우 변환할 값입니다.
formatValue.convertNullToValue.isWeakReference boolean 참조 유형 매개변수가 강하게 참조되거나 약하게 참조되는지 여부입니다. 변환에서만 사용됩니다. 쓰기 가능
formatValue.convertNullToValue.key string 매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다. 쓰기 가능
formatValue.convertNullToValue.list[] list 이 목록 매개변수의 매개변수입니다 (키는 무시됨). 쓰기 가능
formatValue.convertNullToValue.map[] list 이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함). 쓰기 가능
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.convertNullToValue.value string 지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음) 쓰기 가능
formatValue.convertTrueToValue nested object 변수 값이 true인 경우 변환할 값입니다.
formatValue.convertTrueToValue.isWeakReference boolean 참조 유형 매개변수가 강하게 참조되거나 약하게 참조되는지 여부입니다. 변환에서만 사용됩니다. 쓰기 가능
formatValue.convertTrueToValue.key string 매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다. 쓰기 가능
formatValue.convertTrueToValue.list[] list 이 목록 매개변수의 매개변수입니다 (키는 무시됨). 쓰기 가능
formatValue.convertTrueToValue.map[] list 이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함). 쓰기 가능
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.convertTrueToValue.value string 지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음) 쓰기 가능
formatValue.convertUndefinedToValue nested object 변수 값이 정의되지 않은 경우 변환할 값입니다.
formatValue.convertUndefinedToValue.isWeakReference boolean 참조 유형 매개변수가 강하게 참조되거나 약하게 참조되는지 여부입니다. 변환에서만 사용됩니다. 쓰기 가능
formatValue.convertUndefinedToValue.key string 매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다. 쓰기 가능
formatValue.convertUndefinedToValue.list[] list 이 목록 매개변수의 매개변수입니다 (키는 무시됨). 쓰기 가능
formatValue.convertUndefinedToValue.map[] list 이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함). 쓰기 가능
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"
쓰기 가능
formatValue.convertUndefinedToValue.value string 지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음) 쓰기 가능
name string 변수 표시 이름입니다. 쓰기 가능
notes string 컨테이너에서 이 변수를 적용하는 방법에 관한 사용자 메모 쓰기 가능
parameter[] list 변수의 매개변수입니다. 쓰기 가능
parameter[].isWeakReference boolean 참조 유형 매개변수가 강하게 참조되거나 약하게 참조되는지 여부입니다. 변환에서만 사용됩니다. 쓰기 가능
parameter[].key string 매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다. 쓰기 가능
parameter[].list[] list 이 목록 매개변수의 매개변수입니다 (키는 무시됨). 쓰기 가능
parameter[].map[] list 이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함). 쓰기 가능
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"
쓰기 가능
parameter[].value string 지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음) 쓰기 가능
parentFolderId string 상위 폴더 ID입니다.
path string GTM 변수의 API 상대 경로입니다.
scheduleEndMs long 변수를 예약할 종료 타임스탬프(밀리초)입니다. 쓰기 가능
scheduleStartMs long 변수를 예약할 시작 타임스탬프(밀리초)입니다. 쓰기 가능
tagManagerUrl string 자동 생성된 태그 관리자 UI 링크
type string GTM 변수 유형입니다. 쓰기 가능
variableId string 변수 ID로 GTM 변수를 고유하게 식별할 수 있습니다.
workspaceId string GTM 작업공간 ID입니다.

방법

만들기
GTM 변수를 만듭니다.
삭제
GTM 변수를 삭제합니다.
get
GTM 변수를 가져옵니다.
list
컨테이너의 모든 GTM 변수를 나열합니다.
revert
GTM 작업공간에서 GTM 변수의 변경사항을 되돌립니다.
업데이트
GTM 변수를 업데이트합니다.