Resource: HttpBody
Pesan yang merepresentasikan isi HTTP arbitrer. Metode ini hanya boleh digunakan untuk format payload yang tidak dapat direpresentasikan sebagai JSON, seperti biner mentah atau halaman HTML.
Pesan ini dapat digunakan dalam metode API streaming dan non-streaming dalam permintaan serta respons.
Kolom ini dapat digunakan sebagai kolom permintaan tingkat atas, yang memudahkan jika seseorang ingin mengekstrak parameter dari template URL atau HTTP ke kolom permintaan dan juga ingin mengakses isi HTTP mentah.
Contoh:
message GetResourceRequest {
// A unique request id.
string requestId = 1;
// The raw HTTP body is bound to this field.
google.api.HttpBody httpBody = 2;
}
service ResourceService {
rpc GetResource(GetResourceRequest)
returns (google.api.HttpBody);
rpc UpdateResource(google.api.HttpBody)
returns (google.protobuf.Empty);
}
Contoh dengan metode streaming:
service CaldavService {
rpc GetCalendar(stream google.api.HttpBody)
returns (stream google.api.HttpBody);
rpc UpdateCalendar(stream google.api.HttpBody)
returns (stream google.api.HttpBody);
}
Penggunaan jenis ini hanya mengubah cara penanganan isi permintaan dan respons, semua fitur lainnya akan terus berfungsi tanpa perubahan.
| Representasi JSON |
|---|
{ "contentType": string, "data": string, "extensions": [ { "@type": string, field1: ..., ... } ] } |
| Kolom | |
|---|---|
contentType |
Nilai header Content-Type HTTP yang menentukan jenis konten isi. |
data |
Isi permintaan/respons HTTP sebagai biner mentah. String berenkode base64. |
extensions[] |
Metadata respons khusus aplikasi. Harus ditetapkan dalam respons pertama untuk API streaming. Objek yang berisi kolom tipe arbitrer. Kolom tambahan |
Metode |
|
|---|---|
|
Membuat tampilan Iceberg di namespace. |
|
Menghapus tampilan di namespace. |
|
Mendapatkan tampilan di namespace. |
|
Menampilkan 204 jika tampilan ada, atau 404 jika tidak ada. |
|
Mencantumkan ID tampilan daftar (bukan tampilan) di namespace. |
|
Memperbarui tampilan di namespace. |