Workspaces: sync

Synchronisiert einen Arbeitsbereich mit der neuesten Containerversion durch Aktualisieren aller nicht geänderte Arbeitsbereichselemente und Anzeige von Konflikten für geänderte Entitäten. Jetzt testen

Anfrage

HTTP-Anfrage

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

Parameter

Parametername Wert Beschreibung
Pfadparameter
path string Relativer API-Pfad für GTM Workspace Beispiel: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}

Autorisierung

Für diese Anfrage ist eine Autorisierung mit folgendem Bereich erforderlich:

Umfang
https://www.googleapis.com/auth/tagmanager.edit.containers

Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.

Anfragetext

Mit dieser Methode keinen Anfragetext bereitstellen.

Antwort

Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:

{
  "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
      }
    }
  ]
}
Name der Eigenschaft Wert Beschreibung Hinweise
syncStatus nested object Gibt an, ob die Synchronisierung einen Zusammenführungskonflikt oder einen Synchronisierungsfehler verursacht hat.
syncStatus.mergeConflict boolean Bei der Synchronisierung wurde ein Zusammenführungskonflikt erkannt.
syncStatus.syncError boolean Während des Synchronisierungsvorgangs ist ein Fehler aufgetreten.
mergeConflict[] list Der Zusammenführungskonflikt nach der Synchronisierung. Wenn dieses Feld nicht leer ist, wird die Synchronisierung trotzdem als erfolgreich behandelt. Eine Version kann jedoch erst erstellt werden, wenn alle Konflikte behoben sind.
mergeConflict[].entityInWorkspace nested object Die Arbeitsbereichsentität mit widersprüchlichen Änderungen im Vergleich zur Basisversion. Wenn ein Element in einem Arbeitsbereich gelöscht wird, wird es weiterhin mit dem Status „Gelöscht“ angezeigt.
mergeConflict[].entityInWorkspace.tag nested object Das Tag, das von der Entität repräsentiert wird.
mergeConflict[].entityInWorkspace.trigger nested object Der durch die Entität dargestellte Trigger.
mergeConflict[].entityInWorkspace.variable nested object Die durch die Entität dargestellte Variable.
mergeConflict[].entityInWorkspace.folder nested object Der Ordner, der durch die Entität repräsentiert wird.
mergeConflict[].entityInWorkspace.changeStatus string Stellt dar, wie das Element im Arbeitsbereich geändert wurde.

Zulässige Werte sind: <ph type="x-smartling-placeholder">
    </ph>
  • added
  • changeStatusUnspecified
  • deleted
  • none
  • updated
mergeConflict[].entityInBaseVersion nested object Die Entität der Basisversion (seit dem letzten Synchronisierungsvorgang), die im Vergleich zum Arbeitsbereich widersprüchliche Änderungen aufweist. Wenn dieses Feld fehlt, bedeutet dies, dass die Arbeitsbereichsentität aus der Basisversion gelöscht wurde.
mergeConflict[].entityInBaseVersion.tag nested object Das Tag, das von der Entität repräsentiert wird.
mergeConflict[].entityInBaseVersion.trigger nested object Der durch die Entität dargestellte Trigger.
mergeConflict[].entityInBaseVersion.variable nested object Die durch die Entität dargestellte Variable.
mergeConflict[].entityInBaseVersion.folder nested object Der Ordner, der durch die Entität repräsentiert wird.
mergeConflict[].entityInBaseVersion.changeStatus string Stellt dar, wie das Element im Arbeitsbereich geändert wurde.

Zulässige Werte sind: <ph type="x-smartling-placeholder">
    </ph>
  • added
  • changeStatusUnspecified
  • deleted
  • none
  • updated
mergeConflict[].entityInWorkspace.client nested object Der Client, der durch die Entität repräsentiert wird.
mergeConflict[].entityInBaseVersion.client nested object Der Client, der durch die Entität repräsentiert wird.
mergeConflict[].entityInWorkspace.transformation nested object Die durch die Entität dargestellte Transformation.
mergeConflict[].entityInBaseVersion.transformation nested object Die durch die Entität dargestellte Transformation.
mergeConflict[].entityInWorkspace.zone nested object Die von der Entität repräsentierte Zone.
mergeConflict[].entityInWorkspace.customTemplate nested object Die benutzerdefinierte Vorlage, die durch die Entität dargestellt wird.
mergeConflict[].entityInWorkspace.builtInVariable nested object Die integrierte Variable, die durch die Entität dargestellt wird.
mergeConflict[].entityInWorkspace.builtInVariable.path string Relativer API-Pfad von GTM builtInVariable.
mergeConflict[].entityInWorkspace.builtInVariable.accountId string GTM-Konto-ID.
mergeConflict[].entityInWorkspace.builtInVariable.containerId string GTM-Container-ID.
mergeConflict[].entityInWorkspace.builtInVariable.workspaceId string GTM-Arbeitsbereich-ID.
mergeConflict[].entityInWorkspace.builtInVariable.type string Typ der integrierten Variablen.

Zulässige Werte sind: <ph type="x-smartling-placeholder">
    </ph>
  • 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 Name der integrierten Variable, die als Verweis auf die integrierte Variable verwendet werden soll.
mergeConflict[].entityInWorkspace.gtagConfig nested object Die durch die Entität dargestellte gtag-Konfiguration.
mergeConflict[].entityInBaseVersion.zone nested object Die von der Entität repräsentierte Zone.
mergeConflict[].entityInBaseVersion.customTemplate nested object Die benutzerdefinierte Vorlage, die durch die Entität dargestellt wird.
mergeConflict[].entityInBaseVersion.builtInVariable nested object Die integrierte Variable, die durch die Entität dargestellt wird.
mergeConflict[].entityInBaseVersion.builtInVariable.path string Relativer API-Pfad von GTM builtInVariable.
mergeConflict[].entityInBaseVersion.builtInVariable.accountId string GTM-Konto-ID.
mergeConflict[].entityInBaseVersion.builtInVariable.containerId string GTM-Container-ID.
mergeConflict[].entityInBaseVersion.builtInVariable.workspaceId string GTM-Arbeitsbereich-ID.
mergeConflict[].entityInBaseVersion.builtInVariable.type string Typ der integrierten Variablen.

Zulässige Werte sind: <ph type="x-smartling-placeholder">
    </ph>
  • 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 Name der integrierten Variable, die als Verweis auf die integrierte Variable verwendet werden soll.
mergeConflict[].entityInBaseVersion.gtagConfig nested object Die durch die Entität dargestellte gtag-Konfiguration.

Testen!

Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen.