Workspaces: sync

Sincronizza un'area di lavoro alla versione più recente del contenitore aggiornando tutte le entità dell'area di lavoro non modificate e visualizzando i conflitti per le entità modificate. Prova subito.

Richiesta

Richiesta HTTP

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

Parametri

Nome del parametro Valore Descrizione
Parametri del percorso
path string Percorso relativo dell'API GTM Workspace. Esempio: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}

Autorizzazione

Questa richiesta richiede un'autorizzazione con il seguente ambito:

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

Per ulteriori informazioni, consulta la pagina relativa all'autenticazione e autorizzazione.

Corpo della richiesta

Non fornire il corpo di una richiesta con questo metodo.

Risposta

In caso di esito positivo, questo metodo restituisce un corpo della risposta con la seguente struttura:

{
  "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
      }
    }
  ]
}
Nome proprietà Valore Descrizione Note
syncStatus nested object Indica se la sincronizzazione ha causato un conflitto di unione o un errore di sincronizzazione.
syncStatus.mergeConflict boolean L'operazione di sincronizzazione ha rilevato un conflitto di unione.
syncStatus.syncError boolean Si è verificato un errore durante l'operazione di sincronizzazione.
mergeConflict[] list Conflitto di unione dopo la sincronizzazione. Se questo campo non è vuoto, la sincronizzazione viene comunque considerata riuscita. Tuttavia, non è possibile creare una versione finché non vengono risolti tutti i conflitti.
mergeConflict[].entityInWorkspace nested object L'entità area di lavoro che presenta modifiche in conflitto rispetto alla versione di base. Se un'entità viene eliminata in un'area di lavoro, continuerà a essere visualizzata con lo stato di modifica Eliminato.
mergeConflict[].entityInWorkspace.tag nested object Il tag rappresentato dall'entità.
mergeConflict[].entityInWorkspace.trigger nested object L'attivatore rappresentato dall'entità.
mergeConflict[].entityInWorkspace.variable nested object La variabile rappresentata dall'entità.
mergeConflict[].entityInWorkspace.folder nested object La cartella rappresentata dall'entità.
mergeConflict[].entityInWorkspace.changeStatus string Rappresenta il modo in cui l'entità è stata modificata nell'area di lavoro.

I valori accettati sono:
  • "added"
  • "changeStatusUnspecified"
  • "deleted"
  • "none"
  • "updated"
mergeConflict[].entityInBaseVersion nested object L'entità della versione di base (dall'ultima operazione di sincronizzazione) che presenta modifiche in conflitto rispetto all'area di lavoro. Se questo campo non è presente, significa che l'entità area di lavoro viene eliminata dalla versione di base.
mergeConflict[].entityInBaseVersion.tag nested object Il tag rappresentato dall'entità.
mergeConflict[].entityInBaseVersion.trigger nested object L'attivatore rappresentato dall'entità.
mergeConflict[].entityInBaseVersion.variable nested object La variabile rappresentata dall'entità.
mergeConflict[].entityInBaseVersion.folder nested object La cartella rappresentata dall'entità.
mergeConflict[].entityInBaseVersion.changeStatus string Rappresenta il modo in cui l'entità è stata modificata nell'area di lavoro.

I valori accettati sono:
  • "added"
  • "changeStatusUnspecified"
  • "deleted"
  • "none"
  • "updated"
mergeConflict[].entityInWorkspace.client nested object Il cliente rappresentato dall'entità.
mergeConflict[].entityInBaseVersion.client nested object Il cliente rappresentato dall'entità.
mergeConflict[].entityInWorkspace.transformation nested object La trasformazione rappresentata dall'entità.
mergeConflict[].entityInBaseVersion.transformation nested object La trasformazione rappresentata dall'entità.

Prova.

Utilizza Explorer API di seguito per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.