Container Versions

컨테이너의 컨테이너 버전입니다. 컨테이너 버전은 특정 시점의 컨테이너 구성의 변경 불가능한 사본 (스냅샷)이라고 생각하면 됩니다. create 메서드를 사용하여 새 버전을 만들면 현재 구성 (컨테이너의 매크로, 규칙, 태그)을 기반으로 버전이 생성됩니다. restore 메서드는 지정된 버전을 사용하여 컨테이너의 구성을 복원합니다. update 메서드를 사용하면 버전의 name 및 notes 필드를 업데이트할 수 있습니다. 현재 게시된 버전을 가져오려면 get 메서드를 사용하고 containerVersionId에 published를 지정합니다.

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

리소스 표현

Google 태그 관리자 컨테이너 버전을 나타냅니다.

{
  "accountId": string,
  "containerId": string,
  "containerVersionId": string,
  "name": string,
  "deleted": boolean,
  "notes": string,
  "container": accounts.containers Resource,
  "macro": [
    {
      "accountId": string,
      "containerId": string,
      "macroId": string,
      "name": string,
      "type": string,
      "notes": string,
      "scheduleStartMs": long,
      "scheduleEndMs": long,
      "parameter": [
        {
          "type": string,
          "key": string,
          "value": string,
          "list": [
            (Parameter)
          ],
          "map": [
            (Parameter)
          ]
        }
      ],
      "enablingRuleId": [
        string
      ],
      "disablingRuleId": [
        string
      ],
      "fingerprint": string,
      "parentFolderId": string
    }
  ],
  "rule": [
    {
      "accountId": string,
      "containerId": string,
      "ruleId": string,
      "name": string,
      "notes": string,
      "condition": [
        {
          "type": string,
          "parameter": [
            {
              "type": string,
              "key": string,
              "value": string,
              "list": [
                (Parameter)
              ],
              "map": [
                (Parameter)
              ]
            }
          ]
        }
      ],
      "fingerprint": string
    }
  ],
  "tag": [
    accounts.containers.tags Resource
  ],
  "trigger": [
    accounts.containers.triggers Resource
  ],
  "variable": [
    accounts.containers.variables Resource
  ],
  "folder": [
    accounts.containers.folders Resource
  ],
  "fingerprint": string
}

속성 이름	값	설명	Notes
accountId	string	GTM 계정 ID입니다.
container	nested object	이 버전을 가져온 컨테이너입니다.
containerId	string	GTM 컨테이너 ID입니다.
containerVersionId	string	containerVersionId는 GTM 컨테이너 버전을 고유하게 식별합니다.
deleted	boolean	true 값은 컨테이너 버전이 삭제되었음을 나타냅니다.
fingerprint	string	저장 시점에 계산된 GTM 컨테이너 버전의 지문입니다. 이 값은 컨테이너 버전이 수정될 때마다 다시 계산됩니다.
folder[]	list	이 버전을 가져온 컨테이너의 폴더입니다.
macro[]	list	이 버전을 가져온 컨테이너의 매크로입니다.
macro[].accountId	string	GTM 계정 ID입니다.
macro[].containerId	string	GTM 컨테이너 ID입니다.
macro[].disablingRuleId[]	list	모바일 컨테이너에만 해당: 조건부 매크로를 사용 중지하기 위한 규칙 ID 목록입니다. 사용 설정 규칙 중 하나가 true이고 모든 사용 중지 규칙이 false인 경우 매크로가 사용 설정됩니다. 순서가 지정되지 않은 집합으로 처리됩니다.
macro[].enablingRuleId[]	list	모바일 컨테이너에만 해당: 조건부 매크로를 사용 설정하기 위한 규칙 ID 목록입니다. 사용 설정 규칙 중 하나가 true이고 모든 사용 중지 규칙이 false인 경우 매크로가 사용 설정됩니다. 순서가 지정되지 않은 집합으로 처리됩니다.
macro[].fingerprint	string	저장 시점에 계산된 GTM 매크로의 지문입니다. 이 값은 매크로가 수정될 때마다 다시 계산됩니다.
macro[].macroId	string	매크로 ID는 GTM 매크로를 고유하게 식별합니다.
macro[].name	string	매크로 표시 이름입니다.
macro[].notes	string	사용자가 컨테이너에서 이 매크로를 적용하는 방법에 대한 메모.
macro[].parameter[]	list	매크로의 매개변수입니다.
macro[].parameter[].key	string	매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다.	쓰기 가능
macro[].parameter[].list[]	list	이 목록 매개변수의 매개변수입니다 (키는 무시됨).	쓰기 가능
macro[].parameter[].map[]	list	이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함).	쓰기 가능
macro[].parameter[].type	string	매개변수 유형. 유효한 값은 다음과 같습니다. boolean: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다. integer: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다. list: 매개변수 목록을 지정해야 함 map: 매개변수 맵을 지정해야 합니다. template: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다. trigger_reference: 값은 트리거를 나타내며 트리거 ID로 표시됩니다. 사용 가능한 값은 다음과 같습니다. "boolean" "integer" "list" "map" "template" "triggerReference"	쓰기 가능
macro[].parameter[].value	string	지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음)	쓰기 가능
macro[].parentFolderId	string	상위 폴더 ID입니다.
macro[].scheduleEndMs	long	매크로를 예약할 종료 타임스탬프(밀리초)입니다.
macro[].scheduleStartMs	long	매크로를 예약할 시작 타임스탬프(밀리초)입니다.
macro[].type	string	GTM 매크로 유형입니다.
name	string	컨테이너 버전 표시 이름입니다.	쓰기 가능
notes	string	사용자가 컨테이너에서 이 컨테이너 버전을 적용하는 방법에 대한 메모입니다.	쓰기 가능
rule[]	list	이 버전을 가져온 컨테이너의 규칙입니다.
rule[].accountId	string	GTM 계정 ID입니다.
rule[].condition[]	list	이 규칙을 구성하는 조건의 목록 (규칙 간 암시적 AND)
rule[].condition[].parameter[]	list	조건 유형에 따라 이름이 지정된 매개변수 (키/값) 목록. 참고: 바이너리 연산자의 경우 왼쪽 및 오른쪽 피연산자를 각각 지정하기 위해 arg0 및 arg1라는 매개변수를 포함합니다. 이때 왼쪽 피연산자 (arg0)는 변수 참조여야 합니다. 대소문자를 구분하지 않는 정규식 일치의 경우 true로 설정된 ignore_case이라는 부울 매개변수를 포함합니다. 지정하지 않거나 다른 값으로 설정하면 일치 항목이 대소문자를 구분합니다. 연산자를 무효화하려면 negate 부울 매개변수(true로 설정된 불리언 매개변수)를 포함합니다.	쓰기 가능
rule[].condition[].parameter[].key	string	매개변수를 고유하게 식별하는 이름이 지정된 키입니다. 최상위 수준 매개변수 및 지도 값에 필요합니다. 목록 값의 경우 무시됩니다.	쓰기 가능
rule[].condition[].parameter[].list[]	list	이 목록 매개변수의 매개변수입니다 (키는 무시됨).	쓰기 가능
rule[].condition[].parameter[].map[]	list	이 매핑 매개변수의 매개변수입니다 (키가 있어야 함, 키는 고유해야 함).	쓰기 가능
rule[].condition[].parameter[].type	string	매개변수 유형. 유효한 값은 다음과 같습니다. boolean: 값은 'true' 또는 'false'로 표시되는 부울을 나타냅니다. integer: 이 값은 밑이 10인 64비트의 부호 있는 정수 값을 나타냅니다. list: 매개변수 목록을 지정해야 함 map: 매개변수 맵을 지정해야 합니다. template: 값은 모든 텍스트를 나타냅니다. 여기에는 변수 참조 (문자열이 아닌 유형을 반환할 수 있는 변수 참조도 포함)가 포함될 수 있습니다. trigger_reference: 값은 트리거를 나타내며 트리거 ID로 표시됩니다. 사용 가능한 값은 다음과 같습니다. "boolean" "integer" "list" "map" "template" "triggerReference"	쓰기 가능
rule[].condition[].parameter[].value	string	지정된 유형에 적합한 매개변수의 값(''과 같은 변수 참조를 포함할 수 있음)	쓰기 가능
rule[].condition[].type	string	이 조건의 연산자 유형입니다. 사용 가능한 값은 다음과 같습니다. "contains" "cssSelector" "endsWith" "equals" "greater" "greaterOrEquals" "less" "lessOrEquals" "matchRegex" "startsWith" "urlMatches"	쓰기 가능
rule[].containerId	string	GTM 컨테이너 ID입니다.
rule[].fingerprint	string	저장 시점에 계산된 GTM 규칙의 지문입니다. 이 값은 규칙이 수정될 때마다 다시 계산됩니다.
rule[].name	string	규칙 표시 이름입니다.
rule[].notes	string	사용자가 컨테이너에서 이 규칙을 적용하는 방법에 대한 메모
rule[].ruleId	string	규칙 ID는 GTM 규칙을 고유하게 식별합니다.
tag[]	list	이 버전을 가져온 컨테이너의 태그입니다.
trigger[]	list	이 버전을 가져온 컨테이너의 트리거입니다.
variable[]	list	이 버전을 가져온 컨테이너의 변수입니다.

방법

만들기

컨테이너 버전을 만듭니다.

삭제

컨테이너 버전을 삭제합니다.

get

컨테이너 버전을 가져옵니다.

list

GTM 컨테이너의 모든 컨테이너 버전을 나열합니다.

publish

컨테이너 버전을 게시합니다.

복원

컨테이너 버전을 복원합니다. 이렇게 하면 컨테이너의 현재 구성 (변수, 트리거, 태그 포함)을 덮어씁니다. 이 작업은 제공되는 버전 (즉, 게시된 버전)에 영향을 미치지 않습니다.

undelete

컨테이너 버전을 삭제 취소합니다.

업데이트

컨테이너 버전을 업데이트합니다.