Workspaces: sync

Sincroniza un lugar de trabajo con la última versión del contenedor mediante la actualización de todas las entidades del lugar de trabajo sin modificar y la visualización de los conflictos de las entidades modificadas. Pruébalo ahora.

Solicitud

Solicitud HTTP

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

Parámetros

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

Autorización

Esta solicitud requiere una autorización con el siguiente alcance:

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

Para obtener más información, consulta la página de autenticación y autorización.

Cuerpo de la solicitud

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

Respuesta

Si se aplica correctamente, este método muestra un cuerpo de respuesta con 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,
        "client": accounts.containers.workspaces.clients Resource,
        "transformation": accounts.containers.workspaces.transformations 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,
        "changeStatus": string
      }
    }
  ]
}
Nombre de la propiedad Valor Descripción Notas
syncStatus nested object Indica si la sincronización causó un conflicto de combinación o un error de sincronización.
syncStatus.mergeConflict boolean La operación de sincronización detectó un conflicto de combinación.
syncStatus.syncError boolean Se produjo un error durante la operación de sincronización.
mergeConflict[] list Conflicto de combinación después de la sincronización. Si este campo no está vacío, la sincronización se sigue tratando como exitosa. Sin embargo, no se podrá crear una versión hasta que se resuelvan todos los conflictos.
mergeConflict[].entityInWorkspace nested object La entidad del lugar de trabajo que tiene cambios conflictivos en comparación con la versión base. Si se borra una entidad de un lugar de trabajo, seguirá apareciendo con el estado de cambio borrado.
mergeConflict[].entityInWorkspace.tag nested object La etiqueta que representa la entidad.
mergeConflict[].entityInWorkspace.trigger nested object El activador que representa la entidad.
mergeConflict[].entityInWorkspace.variable nested object Es la variable que representa la entidad.
mergeConflict[].entityInWorkspace.folder nested object La carpeta que representa la entidad.
mergeConflict[].entityInWorkspace.changeStatus string Representa cómo se cambió la entidad en el lugar de trabajo.

Los valores aceptables son los siguientes:
  • "added"
  • "changeStatusUnspecified"
  • "deleted"
  • "none"
  • "updated"
mergeConflict[].entityInBaseVersion nested object La entidad de la versión base (desde la operación de sincronización más reciente) que tiene cambios conflictivos en comparación con el lugar de trabajo. Si falta este campo, significa que la entidad del lugar de trabajo se borró de la versión base.
mergeConflict[].entityInBaseVersion.tag nested object La etiqueta que representa la entidad.
mergeConflict[].entityInBaseVersion.trigger nested object El activador que representa la entidad.
mergeConflict[].entityInBaseVersion.variable nested object Es la variable que representa la entidad.
mergeConflict[].entityInBaseVersion.folder nested object La carpeta que representa la entidad.
mergeConflict[].entityInBaseVersion.changeStatus string Representa cómo se cambió la entidad en el lugar de trabajo.

Los valores aceptables son los siguientes:
  • "added"
  • "changeStatusUnspecified"
  • "deleted"
  • "none"
  • "updated"
mergeConflict[].entityInWorkspace.client nested object El cliente que representa la entidad.
mergeConflict[].entityInBaseVersion.client nested object El cliente que representa la entidad.
mergeConflict[].entityInWorkspace.transformation nested object La transformación que representa la entidad.
mergeConflict[].entityInBaseVersion.transformation nested object La transformación que representa la entidad.

Pruébala

Usa el Explorador de APIs que aparece a continuación para llamar a este método con datos en tiempo real y ver la respuesta.