Workspaces: sync

수정되지 않은 모든 작업공간 항목을 업데이트하고 수정된 항목의 충돌을 표시하여 작업공간을 최신 컨테이너 버전으로 동기화합니다. 지금 사용해 보기

요청

HTTP 요청

POST https://www.googleapis.com/tagmanager/v2/+path:sync

매개변수

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

승인

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

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

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

요청 본문

이 메소드를 사용할 때는 요청 본문을 제공하지 마세요.

응답

요청에 성공할 경우 이 메소드는 다음과 같은 구조의 응답 본문을 반환합니다.

{
  "syncStatus": {
    "mergeConflict": boolean,
    "syncError": boolean
  },
  "mergeConflict": [
    {
      "entityInWorkspace": {
        "tag": accounts.containers.workspaces.tags Resource,
        "trigger": accounts.containers.workspaces.triggers Resource,
        "variable": accounts.containers.workspaces.variables Resource,
        "folder": accounts.containers.workspaces.folders Resource,
        "client": accounts.containers.workspaces.clients Resource,
        "transformation": accounts.containers.workspaces.transformations Resource,
        "zone": accounts.containers.workspaces.zones Resource,
        "customTemplate": accounts.containers.workspaces.templates Resource,
        "builtInVariable": {
          "path": string,
          "accountId": string,
          "containerId": string,
          "workspaceId": string,
          "type": string,
          "name": string
        },
        "gtagConfig": accounts.containers.workspaces.gtag_config Resource,
        "changeStatus": string
      },
      "entityInBaseVersion": {
        "tag": accounts.containers.workspaces.tags Resource,
        "trigger": accounts.containers.workspaces.triggers Resource,
        "variable": accounts.containers.workspaces.variables Resource,
        "folder": accounts.containers.workspaces.folders Resource,
        "client": accounts.containers.workspaces.clients Resource,
        "transformation": accounts.containers.workspaces.transformations Resource,
        "zone": accounts.containers.workspaces.zones Resource,
        "customTemplate": accounts.containers.workspaces.templates Resource,
        "builtInVariable": {
          "path": string,
          "accountId": string,
          "containerId": string,
          "workspaceId": string,
          "type": string,
          "name": string
        },
        "gtagConfig": accounts.containers.workspaces.gtag_config Resource,
        "changeStatus": string
      }
    }
  ]
}
속성 이름 값 설명 Notes
syncStatus nested object 동기화로 인해 병합 충돌 또는 동기화 오류가 발생했는지를 나타냅니다.
syncStatus.mergeConflict boolean 동기부여 작업에서 병합 충돌을 감지했습니다.
syncStatus.syncError boolean 동기화 작업 중에 오류가 발생했습니다.
mergeConflict[] list 동기화 후 병합이 충돌합니다. 이 필드가 비어 있지 않으면 동기화는 성공한 것으로 간주됩니다. 하지만 모든 충돌이 해결될 때까지 버전을 만들 수 없습니다.
mergeConflict[].entityInWorkspace nested object 기본 버전과 충돌하는 변경사항이 있는 작업공간 항목 작업공간에서 항목이 삭제되어도 삭제된 변경사항 상태로 계속 표시됩니다.
mergeConflict[].entityInWorkspace.tag nested object 항목이 나타내는 태그입니다.
mergeConflict[].entityInWorkspace.trigger nested object 항목으로 표시되는 트리거입니다.
mergeConflict[].entityInWorkspace.variable nested object 항목이 나타내는 변수입니다.
mergeConflict[].entityInWorkspace.folder nested object 항목이 나타내는 폴더입니다.
mergeConflict[].entityInWorkspace.changeStatus string 작업공간에서 항목이 변경된 방식을 나타냅니다.

사용 가능한 값은 다음과 같습니다.
  • "added"
  • "changeStatusUnspecified"
  • "deleted"
  • "none"
  • "updated"
mergeConflict[].entityInBaseVersion nested object 작업공간과 충돌하는 변경사항이 있는 기본 버전 항목 (최신 동기화 작업 이후)입니다. 이 필드가 누락되면 작업공간 항목이 기본 버전에서 삭제되었음을 의미합니다.
mergeConflict[].entityInBaseVersion.tag nested object 항목이 나타내는 태그입니다.
mergeConflict[].entityInBaseVersion.trigger nested object 항목으로 표시되는 트리거입니다.
mergeConflict[].entityInBaseVersion.variable nested object 항목이 나타내는 변수입니다.
mergeConflict[].entityInBaseVersion.folder nested object 항목이 나타내는 폴더입니다.
mergeConflict[].entityInBaseVersion.changeStatus string 작업공간에서 항목이 변경된 방식을 나타냅니다.

사용 가능한 값은 다음과 같습니다.
  • "added"
  • "changeStatusUnspecified"
  • "deleted"
  • "none"
  • "updated"
mergeConflict[].entityInWorkspace.client nested object 항목이 나타내는 클라이언트입니다.
mergeConflict[].entityInBaseVersion.client nested object 항목이 나타내는 클라이언트입니다.
mergeConflict[].entityInWorkspace.transformation nested object 항목으로 표현되는 변환입니다.
mergeConflict[].entityInBaseVersion.transformation nested object 항목으로 표현되는 변환입니다.
mergeConflict[].entityInWorkspace.zone nested object 항목이 나타내는 영역입니다.
mergeConflict[].entityInWorkspace.customTemplate nested object 항목이 나타내는 맞춤 템플릿입니다.
mergeConflict[].entityInWorkspace.builtInVariable nested object 항목으로 표현되는 기본 제공 변수입니다.
mergeConflict[].entityInWorkspace.builtInVariable.path string GTM BuiltInVariable의 API 상대 경로입니다.
mergeConflict[].entityInWorkspace.builtInVariable.accountId string GTM 계정 ID입니다.
mergeConflict[].entityInWorkspace.builtInVariable.containerId string GTM 컨테이너 ID입니다.
mergeConflict[].entityInWorkspace.builtInVariable.workspaceId string GTM 작업공간 ID입니다.
mergeConflict[].entityInWorkspace.builtInVariable.type string 기본 제공 변수의 유형입니다.

사용 가능한 값은 다음과 같습니다.
  • "advertiserId"
  • "advertisingTrackingEnabled"
  • "ampBrowserLanguage"
  • "ampCanonicalHost"
  • "ampCanonicalPath"
  • "ampCanonicalUrl"
  • "ampClientId"
  • "ampClientMaxScrollX"
  • "ampClientMaxScrollY"
  • "ampClientScreenHeight"
  • "ampClientScreenWidth"
  • "ampClientScrollX"
  • "ampClientScrollY"
  • "ampClientTimestamp"
  • "ampClientTimezone"
  • "ampGtmEvent"
  • "ampPageDownloadTime"
  • "ampPageLoadTime"
  • "ampPageViewId"
  • "ampReferrer"
  • "ampTitle"
  • "ampTotalEngagedTime"
  • "appId"
  • "appName"
  • "appVersionCode"
  • "appVersionName"
  • "builtInVariableTypeUnspecified"
  • "clickClasses"
  • "clickElement"
  • "clickId"
  • "clickTarget"
  • "clickText"
  • "clickUrl"
  • "clientName"
  • "containerId"
  • "containerVersion"
  • "debugMode"
  • "deviceName"
  • "elementVisibilityFirstTime"
  • "elementVisibilityRatio"
  • "elementVisibilityRecentTime"
  • "elementVisibilityTime"
  • "environmentName"
  • "errorLine"
  • "errorMessage"
  • "errorUrl"
  • "event"
  • "eventName"
  • "firebaseEventParameterCampaign"
  • "firebaseEventParameterCampaignAclid"
  • "firebaseEventParameterCampaignAnid"
  • "firebaseEventParameterCampaignClickTimestamp"
  • "firebaseEventParameterCampaignContent"
  • "firebaseEventParameterCampaignCp1"
  • "firebaseEventParameterCampaignGclid"
  • "firebaseEventParameterCampaignSource"
  • "firebaseEventParameterCampaignTerm"
  • "firebaseEventParameterCurrency"
  • "firebaseEventParameterDynamicLinkAcceptTime"
  • "firebaseEventParameterDynamicLinkLinkid"
  • "firebaseEventParameterNotificationMessageDeviceTime"
  • "firebaseEventParameterNotificationMessageId"
  • "firebaseEventParameterNotificationMessageName"
  • "firebaseEventParameterNotificationMessageTime"
  • "firebaseEventParameterNotificationTopic"
  • "firebaseEventParameterPreviousAppVersion"
  • "firebaseEventParameterPreviousOsVersion"
  • "firebaseEventParameterPrice"
  • "firebaseEventParameterProductId"
  • "firebaseEventParameterQuantity"
  • "firebaseEventParameterValue"
  • "firstPartyServingUrl"
  • "formClasses"
  • "formElement"
  • "formId"
  • "formTarget"
  • "formText"
  • "formUrl"
  • "historySource"
  • "htmlId"
  • "language"
  • "newHistoryFragment"
  • "newHistoryState"
  • "newHistoryUrl"
  • "oldHistoryFragment"
  • "oldHistoryState"
  • "oldHistoryUrl"
  • "osVersion"
  • "pageHostname"
  • "pagePath"
  • "pageUrl"
  • "platform"
  • "queryString"
  • "randomNumber"
  • "referrer"
  • "requestMethod"
  • "requestPath"
  • "resolution"
  • "scrollDepthDirection"
  • "scrollDepthThreshold"
  • "scrollDepthUnits"
  • "sdkVersion"
  • "serverPageLocationHostname"
  • "serverPageLocationPath"
  • "serverPageLocationUrl"
  • "videoCurrentTime"
  • "videoDuration"
  • "videoPercent"
  • "videoProvider"
  • "videoStatus"
  • "videoTitle"
  • "videoUrl"
  • "videoVisible"
  • "visitorRegion"
mergeConflict[].entityInWorkspace.builtInVariable.name string 기본 제공 변수를 참조하는 데 사용할 기본 제공 변수의 이름입니다.
mergeConflict[].entityInWorkspace.gtagConfig nested object 항목으로 표시되는 gtag 구성입니다.
mergeConflict[].entityInBaseVersion.zone nested object 항목이 나타내는 영역입니다.
mergeConflict[].entityInBaseVersion.customTemplate nested object 항목이 나타내는 맞춤 템플릿입니다.
mergeConflict[].entityInBaseVersion.builtInVariable nested object 항목으로 표현되는 기본 제공 변수입니다.
mergeConflict[].entityInBaseVersion.builtInVariable.path string GTM BuiltInVariable의 API 상대 경로입니다.
mergeConflict[].entityInBaseVersion.builtInVariable.accountId string GTM 계정 ID입니다.
mergeConflict[].entityInBaseVersion.builtInVariable.containerId string GTM 컨테이너 ID입니다.
mergeConflict[].entityInBaseVersion.builtInVariable.workspaceId string GTM 작업공간 ID입니다.
mergeConflict[].entityInBaseVersion.builtInVariable.type string 기본 제공 변수의 유형입니다.

사용 가능한 값은 다음과 같습니다.
  • "advertiserId"
  • "advertisingTrackingEnabled"
  • "ampBrowserLanguage"
  • "ampCanonicalHost"
  • "ampCanonicalPath"
  • "ampCanonicalUrl"
  • "ampClientId"
  • "ampClientMaxScrollX"
  • "ampClientMaxScrollY"
  • "ampClientScreenHeight"
  • "ampClientScreenWidth"
  • "ampClientScrollX"
  • "ampClientScrollY"
  • "ampClientTimestamp"
  • "ampClientTimezone"
  • "ampGtmEvent"
  • "ampPageDownloadTime"
  • "ampPageLoadTime"
  • "ampPageViewId"
  • "ampReferrer"
  • "ampTitle"
  • "ampTotalEngagedTime"
  • "appId"
  • "appName"
  • "appVersionCode"
  • "appVersionName"
  • "builtInVariableTypeUnspecified"
  • "clickClasses"
  • "clickElement"
  • "clickId"
  • "clickTarget"
  • "clickText"
  • "clickUrl"
  • "clientName"
  • "containerId"
  • "containerVersion"
  • "debugMode"
  • "deviceName"
  • "elementVisibilityFirstTime"
  • "elementVisibilityRatio"
  • "elementVisibilityRecentTime"
  • "elementVisibilityTime"
  • "environmentName"
  • "errorLine"
  • "errorMessage"
  • "errorUrl"
  • "event"
  • "eventName"
  • "firebaseEventParameterCampaign"
  • "firebaseEventParameterCampaignAclid"
  • "firebaseEventParameterCampaignAnid"
  • "firebaseEventParameterCampaignClickTimestamp"
  • "firebaseEventParameterCampaignContent"
  • "firebaseEventParameterCampaignCp1"
  • "firebaseEventParameterCampaignGclid"
  • "firebaseEventParameterCampaignSource"
  • "firebaseEventParameterCampaignTerm"
  • "firebaseEventParameterCurrency"
  • "firebaseEventParameterDynamicLinkAcceptTime"
  • "firebaseEventParameterDynamicLinkLinkid"
  • "firebaseEventParameterNotificationMessageDeviceTime"
  • "firebaseEventParameterNotificationMessageId"
  • "firebaseEventParameterNotificationMessageName"
  • "firebaseEventParameterNotificationMessageTime"
  • "firebaseEventParameterNotificationTopic"
  • "firebaseEventParameterPreviousAppVersion"
  • "firebaseEventParameterPreviousOsVersion"
  • "firebaseEventParameterPrice"
  • "firebaseEventParameterProductId"
  • "firebaseEventParameterQuantity"
  • "firebaseEventParameterValue"
  • "firstPartyServingUrl"
  • "formClasses"
  • "formElement"
  • "formId"
  • "formTarget"
  • "formText"
  • "formUrl"
  • "historySource"
  • "htmlId"
  • "language"
  • "newHistoryFragment"
  • "newHistoryState"
  • "newHistoryUrl"
  • "oldHistoryFragment"
  • "oldHistoryState"
  • "oldHistoryUrl"
  • "osVersion"
  • "pageHostname"
  • "pagePath"
  • "pageUrl"
  • "platform"
  • "queryString"
  • "randomNumber"
  • "referrer"
  • "requestMethod"
  • "requestPath"
  • "resolution"
  • "scrollDepthDirection"
  • "scrollDepthThreshold"
  • "scrollDepthUnits"
  • "sdkVersion"
  • "serverPageLocationHostname"
  • "serverPageLocationPath"
  • "serverPageLocationUrl"
  • "videoCurrentTime"
  • "videoDuration"
  • "videoPercent"
  • "videoProvider"
  • "videoStatus"
  • "videoTitle"
  • "videoUrl"
  • "videoVisible"
  • "visitorRegion"
mergeConflict[].entityInBaseVersion.builtInVariable.name string 기본 제공 변수를 참조하는 데 사용할 기본 제공 변수의 이름입니다.
mergeConflict[].entityInBaseVersion.gtagConfig nested object 항목으로 표시되는 gtag 구성입니다.

사용해 보기

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