Workspaces: updateProposal

Actualiza una propuesta de lugar de trabajo de GTM. Pruébalo ahora.

Solicitud

Solicitud HTTP

PUT https://www.googleapis.com/tagmanager/v2/path

Parámetros

Nombre del parámetro Valor Descripción
Parámetros de ruta de acceso
path string Ruta relativa de la propuesta de lugar de trabajo de GTM: Ejemplo: accounts/{aid}/containers/{cid}/workspace/{wid}/workspace_proposal

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporciona datos con la siguiente estructura:

{
  "status": string,
  "reviewers": [
    {
      "type": string,
      "gaiaId": long
    }
  ],
  "newComment": {
    "content": string
  },
  "fingerprint": string
}
Nombre de la propiedad Valor Descripción Notas
status string Si está presente, se actualiza el estado de la propuesta del lugar de trabajo.

Los valores aceptables son los siguientes:
  • "approved"
  • "cancelled"
  • "completed"
  • "requested"
  • "reviewed"
  • "statusUnspecified"
reviewers[] list Si está presente, se actualiza la lista de revisores de la propuesta del lugar de trabajo.
reviewers[].type string El tipo de usuario distingue entre un usuario y el sistema de Google Tag Manager.

Los valores aceptables son los siguientes:
  • "gaiaId"
  • "system"
reviewers[].gaiaId long Es el ID de GAIA asociado a un usuario, que no está incluido en el sistema de Google Tag Manager.
newComment nested object Si está presente, se agrega un comentario nuevo al historial de propuestas del lugar de trabajo.
newComment.content string El contenido del comentario del autor o el revisor
fingerprint string Cuando se proporciona, esta huella digital debe coincidir con la de la propuesta almacenada.

Respuesta

Si se aplica correctamente, este método muestra un cuerpo de respuesta con la siguiente estructura:

{
  "path": string,
  "status": string,
  "authors": [
    {
      "type": string,
      "gaiaId": long
    }
  ],
  "reviewers": [
    {
      "type": string,
      "gaiaId": long
    }
  ],
  "history": [
    {
      "type": string,
      "comment": {
        "content": string
      },
      "statusChange": {
        "oldStatus": string,
        "newStatus": string
      },
      "createdBy": {
        "type": string,
        "gaiaId": long
      },
      "createdTimestamp": {
        "seconds": long,
        "nanos": integer
      }
    }
  ],
  "fingerprint": string
}
Nombre de la propiedad Valor Descripción Notas
path string Ruta relativa de la propuesta de lugar de trabajo de GTM.
status string Es el estado de la propuesta del lugar de trabajo durante el proceso de revisión.

Los valores aceptables son los siguientes:
  • "approved"
  • "cancelled"
  • "completed"
  • "requested"
  • "reviewed"
  • "statusUnspecified"
authors[] list Es la lista de autores de la propuesta de lugar de trabajo.
authors[].type string El tipo de usuario distingue entre un usuario y el sistema de Google Tag Manager.

Los valores aceptables son los siguientes:
  • "gaiaId"
  • "system"
authors[].gaiaId long Es el ID de GAIA asociado a un usuario, que no está incluido en el sistema de Google Tag Manager.
reviewers[] list Listas de revisores para la propuesta del lugar de trabajo.
reviewers[].type string El tipo de usuario distingue entre un usuario y el sistema de Google Tag Manager.

Los valores aceptables son los siguientes:
  • "gaiaId"
  • "system"
reviewers[].gaiaId long Es el ID de GAIA asociado a un usuario, que no está incluido en el sistema de Google Tag Manager.
history[] list Registra el historial de comentarios y cambios de estado.
history[].type string El tipo de historial que distingue entre comentarios y cambios de estado.

Los valores aceptables son los siguientes:
  • "comment"
  • "statusChange"
  • "unspecified"
history[].comment nested object El comentario de un usuario o un revisor.
history[].comment.content string El contenido del comentario del autor o el revisor
history[].statusChange nested object Es un cambio en el estado de la propuesta.
history[].statusChange.oldStatus string El estado de la propuesta anterior antes del cambio de estado.

Los valores aceptables son los siguientes:
  • "approved"
  • "cancelled"
  • "completed"
  • "requested"
  • "reviewed"
  • "statusUnspecified"
history[].statusChange.newStatus string El nuevo estado de la propuesta después de ese cambio de estado.

Los valores aceptables son los siguientes:
  • "approved"
  • "cancelled"
  • "completed"
  • "requested"
  • "reviewed"
  • "statusUnspecified"
history[].createdBy nested object La parte responsable del cambio en el historial.
history[].createdBy.type string El tipo de usuario distingue entre un usuario y el sistema de Google Tag Manager.

Los valores aceptables son los siguientes:
  • "gaiaId"
  • "system"
history[].createdBy.gaiaId long Es el ID de GAIA asociado a un usuario, que no está incluido en el sistema de Google Tag Manager.
history[].createdTimestamp nested object Cuándo se agregó este evento de historial a la propuesta del lugar de trabajo.
history[].createdTimestamp.seconds long Representa los segundos de la hora UTC desde la época de Unix 1970-01-01T00:00:00Z. Debe ser de 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z inclusive.
history[].createdTimestamp.nanos integer Fracciones no negativas de un segundo a una resolución de nanosegundos. Los valores de segundos negativos con fracciones deben tener valores nanos no negativos que se cuentan hacia adelante en el tiempo. Debe ser de 0 a 999,999,999 inclusive.
fingerprint string La huella digital de la propuesta del lugar de trabajo de GTM tal como se calculó en el momento del almacenamiento. Este valor se vuelve a calcular cada vez que se modifica la propuesta.

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.