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.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 null JSON.
numberValue

number

Representa um número JSON. Não pode ser NaN, Infinity ou -Infinity, porque esses valores não são compatíveis com JSON. Isso também não pode representar valores Int64 grandes, já que o formato JSON geralmente não os aceita no tipo de número.
stringValue

string

Representa uma string JSON.
boolValue

boolean

Representa um booleano JSON (literal true ou false em JSON).
structValue

object (Struct format)

Representa um objeto JSON.
listValue

array (ListValue format)

Representa uma matriz JSON.

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).

NullValue

Representa um null JSON.

NullValue é um sentinela que usa uma enumeração com apenas um valor para representar o valor nulo da união de tipos Value.

Um campo do tipo NullValue com qualquer valor diferente de 0 é considerado inválido. A maioria dos serializadores ProtoJSON vai emitir um Value com um null_value definido como um null JSON, independente do valor inteiro, e, portanto, fará uma viagem de ida e volta para um valor 0.

Tipos enumerados
NULL_VALUE Valor nulo.

Anotações de ferramentas

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