- permintaan HTTP
- Parameter jalur
- Parameter kueri
- Permintaan tubuh
- Badan respons
- Cakupan otorisasi
- Gambar
- gambar kecil
- Status
- Cobalah!
Mencantumkan thumbnail gambar yang dilampirkan pada suatu langkah.
Dapat mengembalikan salah satu kode kesalahan kanonik berikut: - PERMISSION_DENIED - jika pengguna tidak diizinkan membaca dari proyek, atau dari gambar mana pun - INVALID_ARGUMENT - jika permintaan salah format - NOT_FOUND - jika langkahnya tidak ada, atau jika ada gambar yang tidak ada
permintaan HTTP
GET https://toolresults.googleapis.com/toolresults/v1beta3/projects/{projectId}/histories/{historyId}/executions/{executionId}/steps/{stepId}/thumbnails
URL menggunakan sintaks Transcoding gRPC .
Parameter jalur
Parameter | |
---|---|
projectId | ID Proyek. Diperlukan. |
historyId | ID Riwayat. Diperlukan. |
executionId | Id Eksekusi. Diperlukan. |
stepId | ID Langkah. Diperlukan. |
Parameter kueri
Parameter | |
---|---|
pageToken | Token kelanjutan untuk melanjutkan kueri pada item berikutnya. Opsional. |
pageSize | Jumlah maksimum thumbnail yang akan diambil. Nilai default: 50. Server akan menggunakan default ini jika kolom tidak disetel atau memiliki nilai 0. Opsional. |
Permintaan tubuh
Badan permintaan harus kosong.
Badan respons
Respons yang berisi thumbnail dalam satu langkah.
Jika berhasil, isi respons berisi data dengan struktur berikut:
Representasi JSON |
---|
{
"thumbnails": [
{
object ( |
Bidang | |
---|---|
thumbnails[] | Daftar data gambar. Gambar dikembalikan dalam urutan deterministik; mereka diurutkan berdasarkan faktor-faktor berikut, berdasarkan kepentingannya: * Pertama, berdasarkan kasus uji yang terkait. Gambar tanpa test case dianggap lebih besar daripada gambar dengan test case. * Kedua, berdasarkan waktu penciptaannya. Gambar tanpa waktu pembuatan lebih lama daripada gambar dengan waktu pembuatan. * Ketiga, berdasarkan urutan penambahannya ke langkah (dengan panggilan ke langkah.buat atau langkah.patch). |
nextPageToken | Token kelanjutan untuk melanjutkan kueri pada item berikutnya. Jika disetel, tunjukkan bahwa ada lebih banyak thumbnail untuk dibaca, dengan memanggil lagi daftar dengan nilai ini di bidang pageToken. |
Cakupan otorisasi
Memerlukan cakupan OAuth berikut:
-
https://www.googleapis.com/auth/cloud-platform
Untuk informasi lebih lanjut, lihat Ikhtisar Otentikasi .
Gambar
Sebuah gambar, dengan link ke gambar utama dan thumbnail.
Representasi JSON |
---|
{ "stepId": string, "sourceImage": { object ( |
Bidang | |
---|---|
stepId | Langkah dimana gambar dilampirkan. Selalu atur. |
sourceImage | Referensi ke gambar asli ukuran penuh. Ini sama dengan entri toolOutputs untuk gambar di bawah Langkahnya. Selalu atur. |
Bidang gabungan thumbnail_or_error . Mungkin thumbnail gambar tersebut, atau kesalahan yang menjelaskan mengapa thumbnail tersebut tidak dapat dirender. thumbnail_or_error hanya dapat berupa salah satu dari berikut ini: | |
thumbnail | Gambar kecilnya. |
error | Terjadi error yang menjelaskan alasan thumbnail tidak dapat dirender. |
gambar kecil
Satu thumbnail, dengan ukuran dan formatnya.
Representasi JSON |
---|
{ "contentType": string, "heightPx": integer, "widthPx": integer, "data": string } |
Bidang | |
---|---|
contentType | Jenis konten thumbnail, yaitu "gambar/png". Selalu atur. |
heightPx | Tinggi thumbnail, dalam piksel. Selalu atur. |
widthPx | Lebar thumbnail, dalam piksel. Selalu atur. |
data | File thumbnail itu sendiri. Artinya, byte di sini adalah byte yang membentuk file thumbnail; mereka dapat disajikan sebagai gambar apa adanya (dengan tipe konten yang sesuai.) Selalu atur. String yang dikodekan base64. |
Status
Tipe Status
mendefinisikan model kesalahan logis yang cocok untuk berbagai lingkungan pemrograman, termasuk REST API dan RPC API. Ini digunakan oleh gRPC . Setiap pesan Status
berisi tiga bagian data: kode kesalahan, pesan kesalahan, dan rincian kesalahan.
Anda dapat mengetahui lebih lanjut tentang model kesalahan ini dan cara mengatasinya di Panduan Desain API .
Representasi JSON |
---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
Bidang | |
---|---|
code | Kode status, yang seharusnya merupakan nilai enum dari |
message | Pesan kesalahan yang ditujukan kepada pengembang, yang seharusnya dalam bahasa Inggris. Pesan kesalahan apa pun yang dilihat pengguna harus dilokalkan dan dikirim di bidang |
details[] | Daftar pesan yang berisi rincian kesalahan. Ada serangkaian jenis pesan umum yang dapat digunakan oleh API. Objek yang berisi bidang dengan tipe arbitrer. Bidang tambahan |