REST Resource: projects.locations.apps.versions

Risorsa: AppVersion

In Customer Engagement Suite (CES), una versione dell'app è uno snapshot dell'app in un momento specifico. È immutabile e non può essere modificato dopo la creazione.

Rappresentazione JSON 
{
  "name": string,
  "displayName": string,
  "description": string,
  "creator": string,
  "createTime": string,
  "updateTime": string,
  "snapshot": {
    object (AppSnapshot)
  },
  "etag": string
}
Campi
name

string

Identificatore. L'identificatore univoco della versione dell'app. Formato: projects/{project}/locations/{location}/apps/{app}/versions/{version}
displayName

string

Facoltativo. Il nome visualizzato della versione dell'app.
description

string

Facoltativo. La descrizione della versione dell'app.
creator

string

Solo output. Email dell'utente che ha creato la versione dell'app.
createTime

string (Timestamp format)

Solo output. Timestamp di creazione della versione dell'app.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. Timestamp dell'ultimo aggiornamento della versione dell'app.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
snapshot

object (AppSnapshot)

Solo output. Lo snapshot dell'app al momento della creazione della versione.
etag

string

Solo output. Etag utilizzato per garantire che l'oggetto non sia stato modificato durante un'operazione di lettura, modifica e scrittura. Se l'etag è vuoto, l'aggiornamento sovrascriverà eventuali modifiche simultanee.

AppSnapshot

Uno snapshot dell'app.

Rappresentazione JSON 
{
  "app": {
    object (App)
  },
  "agents": [
    {
      object (Agent)
    }
  ],
  "tools": [
    {
      object (Tool)
    }
  ],
  "examples": [
    {
      object (Example)
    }
  ],
  "guardrails": [
    {
      object (Guardrail)
    }
  ],
  "toolsets": [
    {
      object (Toolset)
    }
  ]
}
Campi
app

object (App)

Facoltativo. Le impostazioni di base per l'app.
agents[]

object (Agent)

Facoltativo. Elenco degli agenti nell'app.
tools[]

object (Tool)

Facoltativo. Elenco degli strumenti nell'app.
examples[]

object (Example)

Facoltativo. Elenco di esempi nell'app.
guardrails[]

object (Guardrail)

Facoltativo. Elenco delle barriere protettive nell'app.
toolsets[]

object (Toolset)

Facoltativo. Elenco di toolset nell'app.

Metodi

create

 Crea una nuova versione dell'app nell'app specificata.

delete

 Elimina la versione dell'app specificata.

get

 Recupera i dettagli della versione dell'app specificata.

getExtendedAgentCard

 Recupera la scheda dell'agente estesa per l'agente autenticato.

list

 Elenca tutte le versioni dell'app specificata.

patch

 Aggiorna la versione dell'app specificata.

restore

 Ripristina la versione dell'app specificata.