MCP Tools Reference: ces.googleapis.com

Ferramenta: list_changelogs

Lista os registros de alterações no app especificado.

O exemplo a seguir demonstra como usar curl para invocar a ferramenta list_changelogs MCP.

Solicitação curl 
                  
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
}'

Esquema de entrada

Mensagem de solicitação para AgentService.ListChangelogs.

ListChangelogsRequest

Representação JSON 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string,
  "filter": string,
  "orderBy": string
}
Campos
parent

string

Obrigatório. O nome do recurso do app para listar os changelogs.
pageSize

integer

Opcional. Tamanho da página solicitada. O servidor pode retornar menos resultados do que o solicitado. Se não for especificado, o servidor escolherá um padrão apropriado.
pageToken

string

Opcional. O valor next_page_token retornado de uma chamada AgentService.ListChangelogs de lista anterior.
filter

string

Opcional. Filtro a ser aplicado ao listar os registros de mudanças. Consulte https://google.aip.dev/160 para mais detalhes.

A string de filtro pode ser usada para filtrar por action, resource_type, resource_name, author e create_time. O comparador : pode ser usado para correspondência parcial sem distinção entre maiúsculas e minúsculas em campos de string, enquanto = realiza uma correspondência exata com distinção entre maiúsculas e minúsculas.

Exemplos: * action:update (correspondência parcial sem diferenciação de maiúsculas e minúsculas) * action="Create" (correspondência exata com diferenciação de maiúsculas e minúsculas) * 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

Opcional. Campo de classificação. Somente "name" e "create_time" são aceitos. Consulte https://google.aip.dev/132#ordering para mais detalhes.

Esquema de saída

Mensagem de resposta para AgentService.ListChangelogs.

ListChangelogsResponse

Representação JSON 
{
  "changelogs": [
    {
      object (Changelog)
    }
  ],
  "nextPageToken": string
}
Campos
changelogs[]

object (Changelog)

A lista de registros de mudanças.
nextPageToken

string

Um token que pode ser enviado como ListChangelogsRequest.page_token para recuperar a próxima página. A ausência desse campo indica que não há páginas subsequentes.

Registro de alterações

Representação 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
}
Campos
name

string

Identificador. O identificador exclusivo do changelog. Formato: projects/{project}/locations/{location}/apps/{app}/changelogs/{changelog}
author

string

Apenas saída. Endereço de e-mail do autor da mudança.
displayName

string

Apenas saída. Nome de exibição da mudança. Normalmente, é o nome de exibição do recurso que foi alterado.
description

string

Apenas saída. Descrição da mudança, que normalmente captura os campos alterados no recurso.
resource

string

Apenas saída. O recurso que foi alterado.
resourceType

string

Apenas saída. O tipo de recurso que foi alterado.
action

string

Apenas saída. A ação realizada no recurso.
originalResource

object (Struct format)

Apenas saída. O recurso original antes da mudança.
newResource

object (Struct format)

Apenas saída. O novo recurso após a mudança.
dependentResources[]

object (Struct format)

Apenas saída. Os recursos dependentes que foram alterados.
createTime

string (Timestamp format)

Apenas saída. O horário em que a mudança foi feita.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
sequenceNumber

string (int64 format)

Apenas saída. O número de sequência monotonicamente crescente do changelog.

Struct

Representação JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Campos
fields

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

Mapa não ordenado de valores com tipagem dinâmica.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Representação JSON 
{
  "key": string,
  "value": value
}
Campos
key

string
value

value (Value format)

Valor

Representação 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.
}
Campos
Campo de união kind. O tipo de valor. kind pode ser apenas de um dos tipos a seguir:
nullValue

null

Representa um valor nulo.
numberValue

number

Representa um valor double.
stringValue

string

Representa um valor de string.
boolValue

boolean

Representa um valor booleano.
structValue

object (Struct format)

Representa um valor estruturado.
listValue

array (ListValue format)

Representa um Value repetido.

ListValue

Representação JSON 
{
  "values": [
    value
  ]
}
Campos
values[]

value (Value format)

Campo repetido de valores digitados dinamicamente.

Carimbo de data/hora

Representação JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa os segundos do horário UTC desde a época Unix 1970-01-01T00:00:00Z. Precisa estar entre -62135596800 e 253402300799 (o que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z).
nanos

integer

Frações não negativas de um segundo com resolução de nanossegundos. Esse campo é a parte de nanossegundos da duração, não uma alternativa aos segundos. Os valores de segundos negativos com frações ainda precisam ter valores em nanossegundos não negativos que representam períodos posteriores. O valor precisa ser de 0 a 999.999.999 (inclusive).

Anotações de ferramentas

Dica destrutiva: ❌ | Dica idempotente: ✅ | Dica somente leitura: ✅ | Dica de mundo aberto: ❌