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.[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
}'

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 Teilübereinstimmungen ohne Berücksichtigung der Groß-/Kleinschreibung für Stringfelder 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:me@example.com * 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 einen Nullwert dar.
numberValue

number

Stellt einen Double-Wert dar.
stringValue

string

Stellt einen Stringwert dar.
boolValue

boolean

Stellt einen booleschen Wert dar.
structValue

object (Struct format)

Stellt einen strukturierten Wert dar.
listValue

array (ListValue format)

Stellt eine wiederholte Value dar.

ListValue

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

value (Value format)

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

Tool-Annotationen

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Nur-Lese-Hinweis: ✅ | Open-World-Hinweis: ❌