Workspaces: sync

Requiere autorización

Sincroniza un recurso Workspace con el último recurso Container Version actualizando todas las entidades del recurso Workspace no modificadas y mostrando los conflictos de las entidades modificadas. Pruébalo ahora.

Solicitud

Solicitud HTTP

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

Parámetros

Nombre de parámetro Valor Descripción
Parámetros de ruta
path string Ruta relativa de la API del recurso Workspace de GTM. Ejemplo: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}

Autorización

Esta solicitud requiere autorización con el siguiente ámbito. Consulta más información sobre la autenticación y la autorización.

Ámbito
https://www.googleapis.com/auth/tagmanager.edit.containers

Cuerpo de la solicitud

No proporciones un cuerpo de solicitud con este método.

Respuesta

Si este método se realiza correctamente, el cuerpo de respuesta tendrá la siguiente estructura:

{
  "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,
        "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,
        "changeStatus": string
      }
    }
  ]
}
Nombre de propiedad Valor Descripción Notas
syncStatus nested object Indica si la sincronización ha provocado un conflicto de combinación o un error de sincronización.
syncStatus.mergeConflict boolean La operación de sincronización ha detectado un conflicto de combinación.
syncStatus.syncError boolean Se ha producido un error durante la operación de sincronización.
mergeConflict[] list Conflicto de combinación surgido después de la sincronización. Si este campo no está vacío, la sincronización aún se considera válida. Sin embargo, no se puede crear una versión hasta que se resuelven todos los conflictos.
mergeConflict[].entityInWorkspace nested object Entidad del recurso Workspace que presenta cambios conflictivos en comparación con la versión básica. Si se elimina una entidad en un recurso Workspace, seguirá mostrándose con un estado de cambio eliminado.
mergeConflict[].entityInWorkspace.tag nested object Recurso Tag que representa la entidad.
mergeConflict[].entityInWorkspace.trigger nested object Recurso Trigger que representa la entidad.
mergeConflict[].entityInWorkspace.variable nested object Recurso Variable que representa la entidad.
mergeConflict[].entityInWorkspace.folder nested object Recurso Folder que representa la entidad.
mergeConflict[].entityInWorkspace.changeStatus string Representa cómo se ha modificado la entidad en el recurso Workspace.

Estos son los valores posibles:
  • "added"
  • "changeStatusUnspecified"
  • "deleted"
  • "none"
  • "updated"
mergeConflict[].entityInBaseVersion nested object Entidad de la versión básica (desde la última operación de sincronización) que presenta cambios conflictivos en comparación con el recurso Workspace. Si no se incluye este campo, significa que la entidad del recurso Workspace se ha eliminado de la versión básica.
mergeConflict[].entityInBaseVersion.tag nested object Recurso Tag que representa la entidad.
mergeConflict[].entityInBaseVersion.trigger nested object Recurso Trigger que representa la entidad.
mergeConflict[].entityInBaseVersion.variable nested object Recurso Variable que representa la entidad.
mergeConflict[].entityInBaseVersion.folder nested object Recurso Folder que representa la entidad.
mergeConflict[].entityInBaseVersion.changeStatus string Representa cómo se ha modificado la entidad en el recurso Workspace.

Estos son los valores posibles:
  • "added"
  • "changeStatusUnspecified"
  • "deleted"
  • "none"
  • "updated"

Pruébalo

Utiliza el siguiente explorador de APIs para llamar a este método con datos en tiempo real y ver la respuesta.