Workspaces: getStatus

找出工作區中發生衝突和經過修改的實體。立即試用。

要求

HTTP 要求

GET https://www.googleapis.com/tagmanager/v2/+path/status

參數

參數名稱 價值 說明
路徑參數
path string GTM Workspace 的 API 相對路徑。範例： accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}

授權

這項要求需要授權，且至少要有下列其中一個範圍：

內容範圍
https://www.googleapis.com/auth/tagmanager.edit.containers
https://www.googleapis.com/auth/tagmanager.readonly

詳情請參閱「驗證與授權」網頁。

要求主體

請勿使用這個方法提供請求主體。

回覆

如果成功的話，這個方法會傳回回應內文，其結構如下：

{
  "workspaceChange": [
    {
      "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
    }
  ],
  "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
      }
    }
  ]
}
屬性名稱 價值 說明 附註
workspaceChange[] list 已在工作區中變更的實體。
workspaceChange[].tag nested object 由實體代表的標記。
workspaceChange[].trigger nested object 由實體代表的觸發條件。
workspaceChange[].variable nested object 由實體代表的變數。
workspaceChange[].folder nested object 實體代表的資料夾。
workspaceChange[].changeStatus string 代表實體在工作區中的變更情形。

可接受的值為：
  • 「added」
  • 「changeStatusUnspecified」
  • 「deleted」
  • 「none」
  • 「updated」
mergeConflict[] list 同步處理後發生合併衝突。
mergeConflict[].entityInWorkspace nested object 變更與基礎版本有衝突的 Workspace 實體。即使實體在工作區中刪除，狀態仍會顯示變更狀態。
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」
workspaceChange[].client nested object 由實體代表的用戶端。
mergeConflict[].entityInWorkspace.client nested object 由實體代表的用戶端。
mergeConflict[].entityInBaseVersion.client nested object 由實體代表的用戶端。
workspaceChange[].transformation nested object 實體代表的轉換。
mergeConflict[].entityInWorkspace.transformation nested object 實體代表的轉換。
mergeConflict[].entityInBaseVersion.transformation nested object 實體代表的轉換。
workspaceChange[].zone nested object 實體代表的區域。
workspaceChange[].customTemplate nested object 實體代表的自訂範本。
workspaceChange[].builtInVariable nested object 實體代表的內建變數。
workspaceChange[].builtInVariable.path string GTM BuiltInVariable 的 API 相對路徑。
workspaceChange[].builtInVariable.accountId string GTM 帳戶 ID。
workspaceChange[].builtInVariable.containerId string GTM 容器 ID。
workspaceChange[].builtInVariable.workspaceId string GTM 工作區 ID。
workspaceChange[].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」
workspaceChange[].builtInVariable.name string 參照內建變數的內建變數名稱。
workspaceChange[].gtagConfig nested object 實體代表的 gtag 設定。
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 Explorer，針對即時資料呼叫這個方法，然後查看回應。