MCP Tools Reference: ces.googleapis.com

Strumento: list_changelogs

Elenca i log delle modifiche nell'app specificata.

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP list_changelogs.

Curl Request 
                  
curl --location 'https://ces.[REGION].rep.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_changelogs",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schema di input

Messaggio di richiesta per AgentService.ListChangelogs.

ListChangelogsRequest

Rappresentazione JSON 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string,
  "filter": string,
  "orderBy": string
}
Campi
parent

string

Obbligatorio. Il nome della risorsa dell'app da cui elencare i log delle modifiche.
pageSize

integer

Facoltativo. Dimensioni della pagina richiesta. Il server potrebbe restituire meno elementi di quelli richiesti. Se non specificato, il server sceglierà un valore predefinito appropriato.
pageToken

string

Facoltativo. Il valore next_page_token restituito da una precedente chiamata AgentService.ListChangelogs dell'elenco.
filter

string

Facoltativo. Filtro da applicare quando vengono elencati i log delle modifiche. Per maggiori dettagli, visita la pagina https://google.aip.dev/160.

La stringa di filtro può essere utilizzata per filtrare per action, resource_type, resource_name, author e create_time. Il comparatore : può essere utilizzato per la corrispondenza parziale senza distinzione tra maiuscole e minuscole nei campi stringa, mentre = esegue una corrispondenza esatta sensibile alle maiuscole.

Esempi: * action:update (corrispondenza parziale senza distinzione tra maiuscole e minuscole) * action="Create" (corrispondenza esatta con distinzione tra maiuscole e minuscole) * resource_type:agent * resource_name:my-agent * author:me@example.com * create_time > "2025-01-01T00:00:00Z" * create_time <= "2025-01-01T00:00:00Z" AND resource_type:tool
orderBy

string

Facoltativo. Campo in base al quale ordinare. Sono supportati solo "name" e "create_time". Per maggiori dettagli, visita la pagina https://google.aip.dev/132#ordering.

Schema di output

Messaggio di risposta per AgentService.ListChangelogs.

ListChangelogsResponse

Rappresentazione JSON 
{
  "changelogs": [
    {
      object (Changelog)
    }
  ],
  "nextPageToken": string
}
Campi
changelogs[]

object (Changelog)

L'elenco dei log delle modifiche.
nextPageToken

string

Un token che può essere inviato come ListChangelogsRequest.page_token per recuperare la pagina successiva. L'assenza di questo campo indica che non sono presenti pagine successive.

Log delle modifiche

Rappresentazione JSON 
{
  "name": string,
  "author": string,
  "displayName": string,
  "description": string,
  "resource": string,
  "resourceType": string,
  "action": string,
  "originalResource": {
    object
  },
  "newResource": {
    object
  },
  "dependentResources": [
    {
      object
    }
  ],
  "createTime": string,
  "sequenceNumber": string
}
Campi
name

string

Identificatore. L'identificatore univoco del log delle modifiche. Formato: projects/{project}/locations/{location}/apps/{app}/changelogs/{changelog}
author

string

Solo output. L'indirizzo email dell'autore della modifica.
displayName

string

Solo output. Nome visualizzato della modifica. In genere, dovrebbe essere il nome visualizzato della risorsa modificata.
description

string

Solo output. Descrizione della modifica, che in genere acquisisce i campi modificati nella risorsa.
resource

string

Solo output. La risorsa modificata.
resourceType

string

Solo output. Il tipo di risorsa modificata.
action

string

Solo output. L'azione eseguita sulla risorsa.
originalResource

object (Struct format)

Solo output. La risorsa originale prima della modifica.
newResource

object (Struct format)

Solo output. La nuova risorsa dopo la modifica.
dependentResources[]

object (Struct format)

Solo output. Le risorse dipendenti che sono state modificate.
createTime

string (Timestamp format)

Solo output. L'ora in cui è stata apportata la modifica.

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".
sequenceNumber

string (int64 format)

Solo output. Il numero di sequenza crescente monotonicamente del changelog.

Struct

Rappresentazione JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Campi
fields

map (key: string, value: value (Value format))

Mappa non ordinata di valori con tipo dinamico.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Rappresentazione JSON 
{
  "key": string,
  "value": value
}
Campi
key

string
value

value (Value format)

Valore

Rappresentazione JSON 
{

  // Union field kind can be only one of the following:
  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
  // End of list of possible types for union field kind.
}
Campi
Campo unione kind. Il tipo di valore. kind può essere solo uno dei seguenti tipi:
nullValue

null

Rappresenta un valore null.
numberValue

number

Rappresenta un valore double.
stringValue

string

Rappresenta un valore stringa.
boolValue

boolean

Rappresenta un valore booleano.
structValue

object (Struct format)

Rappresenta un valore strutturato.
listValue

array (ListValue format)

Rappresenta un Value ripetuto.

ListValue

Rappresentazione JSON 
{
  "values": [
    value
  ]
}
Campi
values[]

value (Value format)

Campo ripetuto di valori con tipo dinamico.

Timestamp

Rappresentazione JSON 
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

Rappresenta i secondi di tempo UTC a partire dall'epoca Unix 1970-01-01T00:00:00Z. Deve essere compreso tra -62135596800 e 253402300799 inclusi (corrispondenti a 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z).
nanos

integer

Frazioni di secondo non negative con risoluzione in nanosecondi. Questo campo è la parte in nanosecondi della durata, non un'alternativa ai secondi. I valori negativi dei secondi con frazioni devono comunque avere valori non negativi dei nanosecondi che vengono conteggiati in avanti nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi.

Annotazioni dello strumento

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌