MCP Tools Reference: ces.googleapis.com

Alat: list_changelogs

Mencantumkan log perubahan di aplikasi tertentu.

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP list_changelogs.

Permintaan 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
}'

Skema Input

Pesan permintaan untuk AgentService.ListChangelogs.

ListChangelogsRequest

Representasi JSON 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string,
  "filter": string,
  "orderBy": string
}
Kolom
parent

string

Wajib. Nama resource aplikasi untuk mencantumkan log perubahannya.
pageSize

integer

Opsional. Ukuran halaman yang diminta. Server dapat menampilkan lebih sedikit item daripada yang diminta. Jika tidak ditentukan, server akan memilih default yang sesuai.
pageToken

string

Opsional. Nilai next_page_token yang ditampilkan dari panggilan AgentService.ListChangelogs daftar sebelumnya.
filter

string

Opsional. Filter yang akan diterapkan saat mencantumkan log perubahan. Lihat https://google.aip.dev/160 untuk mengetahui detail selengkapnya.

String filter dapat digunakan untuk memfilter menurut action, resource_type, resource_name, author, dan create_time. Pembanding : dapat digunakan untuk pencocokan sebagian yang tidak peka huruf besar/kecil pada kolom string, sedangkan = melakukan pencocokan persis yang peka huruf besar/kecil.

Contoh: * action:update (pencocokan parsial tidak peka huruf besar/kecil) * action="Create" (pencocokan persis peka huruf besar/kecil) * 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

Opsional. Kolom yang akan diurutkan. Hanya "name" dan "create_time" yang didukung. Lihat https://google.aip.dev/132#ordering untuk mengetahui detail selengkapnya.

Skema Output

Pesan respons untuk AgentService.ListChangelogs.

ListChangelogsResponse

Representasi JSON 
{
  "changelogs": [
    {
      object (Changelog)
    }
  ],
  "nextPageToken": string
}
Kolom
changelogs[]

object (Changelog)

Daftar log perubahan.
nextPageToken

string

Token yang dapat dikirim sebagai ListChangelogsRequest.page_token untuk mengambil halaman berikutnya. Tidak adanya kolom ini menunjukkan bahwa tidak ada halaman berikutnya.

Log perubahan

Representasi 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
}
Kolom
name

string

ID. ID unik log perubahan. Format: projects/{project}/locations/{location}/apps/{app}/changelogs/{changelog}
author

string

Hanya output. Alamat email penulis perubahan.
displayName

string

Hanya output. Nama tampilan perubahan. Biasanya, nilai ini adalah nama tampilan resource yang diubah.
description

string

Hanya output. Deskripsi perubahan, yang biasanya mencakup kolom yang diubah dalam resource.
resource

string

Hanya output. Resource yang diubah.
resourceType

string

Hanya output. Jenis resource yang diubah.
action

string

Hanya output. Tindakan yang dilakukan pada resource.
originalResource

object (Struct format)

Hanya output. Sumber daya asli sebelum perubahan.
newResource

object (Struct format)

Hanya output. Resource baru setelah perubahan.
dependentResources[]

object (Struct format)

Hanya output. Resource dependen yang diubah.
createTime

string (Timestamp format)

Hanya output. Waktu saat perubahan dilakukan.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
sequenceNumber

string (int64 format)

Hanya output. Nomor urut {i}changelog{i} yang meningkat secara monoton.

Struct

Representasi JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Kolom
fields

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

Peta nilai yang diketik secara dinamis dan tidak berurutan.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Representasi JSON 
{
  "key": string,
  "value": value
}
Kolom
key

string
value

value (Value format)

Nilai

Representasi 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.
}
Kolom
Kolom union kind. Jenis nilai. kind hanya ada berupa salah satu diantara berikut:
nullValue

null

Mewakili JSON null.
numberValue

number

Mewakili angka JSON. Tidak boleh NaN, Infinity, atau -Infinity, karena tidak didukung dalam JSON. Hal ini juga tidak dapat merepresentasikan nilai Int64 besar, karena format JSON umumnya tidak mendukungnya dalam jenis angka.
stringValue

string

Mewakili string JSON.
boolValue

boolean

Mewakili boolean JSON (literal true atau false dalam JSON).
structValue

object (Struct format)

Mewakili objek JSON.
listValue

array (ListValue format)

Mewakili array JSON.

ListValue

Representasi JSON 
{
  "values": [
    value
  ]
}
Kolom
values[]

value (Value format)

Kolom berulang dari nilai yang diketik secara dinamis.

Stempel waktu

Representasi JSON 
{
  "seconds": string,
  "nanos": integer
}
Kolom
seconds

string (int64 format)

Mewakili detik waktu UTC sejak epoch Unix 1970-01-01T00:00:00Z. Harus antara -62135596800 dan 253402300799 inklusif (yang sesuai dengan 0001-01-01T00:00:00Z hingga 9999-12-31T23:59:59Z).
nanos

integer

Pecahan detik non-negatif pada resolusi nanodetik. Kolom ini adalah bagian nanodetik dari durasi, bukan alternatif untuk detik. Nilai detik negatif dengan pecahan harus tetap memiliki nilai nano non-negatif yang dihitung maju dalam waktu. Harus antara 0 dan 999.999.999 inklusif.

NullValue

Mewakili JSON null.

NullValue adalah sentinel, menggunakan enum dengan hanya satu nilai untuk merepresentasikan nilai null untuk gabungan jenis Value.

Kolom berjenis NullValue dengan nilai selain 0 dianggap tidak valid. Sebagian besar serializer ProtoJSON akan memancarkan Value dengan null_value yang ditetapkan sebagai null JSON, terlepas dari nilai bilangan bulatnya, dan akan melakukan perjalanan pulang pergi ke nilai 0.

Enum
NULL_VALUE Nilai null.

Anotasi Alat

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ✅ | Petunjuk Hanya Baca: ✅ | Petunjuk Dunia Terbuka: ❌