MCP Tools Reference: ces.googleapis.com

Tool: list_changelogs

Listet Änderungsprotokolle in der angegebenen App auf.

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool list_changelogs aufrufen.

Curl-Anfrage
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 }'

Eingabeschema

Anfragenachricht für AgentService.ListChangelogs.

ListChangelogsRequest

JSON-Darstellung
{ "parent": string, "pageSize": integer, "pageToken": string, "filter": string, "orderBy": string }

Felder
parent	string Erforderlich. Der Ressourcenname der App, für die Changelogs aufgeführt werden sollen.
pageSize	integer Optional. Angeforderte Seitengröße. Der Server gibt möglicherweise weniger Elemente als angefordert zurück. Wenn kein Wert angegeben wurde, wählt der Server einen geeigneten Standardwert aus.
pageToken	string Optional. Der Wert next_page_token wurde gegebenenfalls von einem vorherigen AgentService.ListChangelogs-Listenaufruf zurückgegeben.
filter	string Optional. Filter, der beim Auflisten der Änderungsprotokolle angewendet werden soll. Weitere Informationen finden Sie unter https://google.aip.dev/160. Mit dem Filterstring können Sie nach action, resource_type, resource_name, author und create_time filtern. Der Vergleichsoperator : kann für den teilweisen Abgleich von Stringfeldern ohne Berücksichtigung der Groß-/Kleinschreibung verwendet werden, während = einen genauen Abgleich mit Berücksichtigung der Groß-/Kleinschreibung durchführt. Beispiele: * action:update (Teilabgleich ohne Berücksichtigung der Groß-/Kleinschreibung) * action="Create" (genauer Abgleich mit Berücksichtigung der Groß-/Kleinschreibung) * resource_type:agent * resource_name:my-agent * author:[e-mail] * create_time > "2025-01-01T00:00:00Z" * create_time <= "2025-01-01T00:00:00Z" AND resource_type:tool
orderBy	string Optional. Feld, nach dem sortiert werden soll. Nur „name“ und „create_time“ werden unterstützt. Weitere Informationen finden Sie unter https://google.aip.dev/132#ordering.

Ausgabeschema

Antwortnachricht für AgentService.ListChangelogs.

ListChangelogsResponse

JSON-Darstellung
{ "changelogs": [ { object (Changelog) } ], "nextPageToken": string }

Felder
changelogs[]	object (Changelog) Die Liste der Änderungslogs.
nextPageToken	string Ein Token, das als ListChangelogsRequest.page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld fehlt, gibt es keine nachfolgenden Seiten.

Änderungslog

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

Felder
name	string ID. Die eindeutige ID des Änderungsprotokolls. Format: projects/{project}/locations/{location}/apps/{app}/changelogs/{changelog}
author	string Nur Ausgabe. E-Mail-Adresse des Autors der Änderung.
displayName	string Nur Ausgabe. Anzeigename der Änderung. In der Regel sollte es sich um den Anzeigenamen der geänderten Ressource handeln.
description	string Nur Ausgabe. Beschreibung der Änderung, in der in der Regel die geänderten Felder in der Ressource angegeben werden.
resource	string Nur Ausgabe. Die Ressource, die geändert wurde.
resourceType	string Nur Ausgabe. Der Typ der Ressource, die geändert wurde.
action	string Nur Ausgabe. Die Aktion, die für die Ressource ausgeführt wurde.
originalResource	object (Struct format) Nur Ausgabe. Die ursprüngliche Ressource vor der Änderung.
newResource	object (Struct format) Nur Ausgabe. Die neue Ressource nach der Änderung.
dependentResources[]	object (Struct format) Nur Ausgabe. Die abhängigen Ressourcen, die geändert wurden.
createTime	string (Timestamp format) Nur Ausgabe. Zeitpunkt der Änderung. Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
sequenceNumber	string (int64 format) Nur Ausgabe. Die monoton steigende Sequenznummer des Änderungsprotokolls.

Struct

JSON-Darstellung
{ "fields": { string: value, ... } }

Felder
fields	map (key: string, value: value (Value format)) Ungeordnete Zuordnung von dynamisch typisierten Werten. Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

JSON-Darstellung
{ "key": string, "value": value }

Felder
key	string
value	value (Value format)

Wert

JSON-Darstellung
{ // 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. }

Felder
Union-Feld kind. Die Art des Werts. Für kind ist nur einer der folgenden Werte zulässig:
nullValue	null Stellt ein JSON-null dar.
numberValue	number Stellt eine JSON-Zahl dar. Darf nicht NaN, Infinity oder -Infinity sein, da diese in JSON nicht unterstützt werden. Auch große Int64-Werte können nicht dargestellt werden, da das JSON-Format sie in seinem Zahlentyp generell nicht unterstützt.
stringValue	string Stellt einen JSON-String dar.
boolValue	boolean Stellt einen booleschen JSON-Wert dar (true- oder false-Literal in JSON).
structValue	object (Struct format) Stellt ein JSON-Objekt dar.
listValue	array (ListValue format) Stellt ein JSON-Array dar.

ListValue

JSON-Darstellung
{ "values": [ value ] }

Felder
values[]	value (Value format) Wiederkehrendes Feld mit dynamisch typisierten Werten.

Zeitstempel

JSON-Darstellung
{ "seconds": string, "nanos": integer }

Felder
seconds	string (int64 format) Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Muss einschließlich zwischen -62135596800 und 253402300799 liegen (entspricht 0001-01-01T00:00:00Z bis 9999-12-31T23:59:59Z).
nanos	integer Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Dieses Feld enthält den Nanosekundenanteil der Dauer und ist keine Alternative zu Sekunden. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Muss zwischen 0 und 999.999.999 liegen (einschließlich).

NullValue

Stellt ein JSON-null dar.

NullValue ist ein Sentinel, der einen Enum mit nur einem Wert verwendet, um den Nullwert für die Typunion Value darzustellen.

Ein Feld vom Typ NullValue mit einem anderen Wert als 0 gilt als ungültig. Die meisten ProtoJSON-Serialisierungsprogramme geben ein Value mit einem als JSON-null festgelegten null_value aus, unabhängig vom Ganzzahlwert. Daher wird ein Roundtrip zu einem 0-Wert durchgeführt.

Enums
NULL_VALUE	Nullwert.

Tool-Annotationen

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Hinweis „Nur lesen“: ✅ | Hinweis „Offene Welt“: ❌