Workspaces: sync

Synchronisiert einen Arbeitsbereich mit der neuesten Containerversion, indem alle unveränderten Arbeitsbereichsentitäten aktualisiert und Konflikte für geänderte Entitäten angezeigt werden. 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:

Bereich
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. Wird ein Element in einem Arbeitsbereich gelöscht, 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:
  • „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:
  • „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:
  • „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:
  • „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.

Jetzt testen

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