Mengelola operasi yang berjalan lama dengan layanan API.
Jika metode API biasanya memerlukan waktu lama untuk diselesaikan, metode tersebut dapat didesain untuk menampilkan Operation ke klien, dan klien tersebut dapat menggunakan antarmuka ini untuk menerima respons sebenarnya secara asinkron dengan melakukan polling pada resource operasi, atau meneruskan resource operasi ke API lain (seperti Pub/Sub API) untuk menerima respons. Setiap layanan API yang menampilkan operasi yang berjalan lama harus menerapkan antarmuka Operations sehingga developer dapat memiliki pengalaman klien yang konsisten.
Memulai pembatalan asinkron pada operasi yang berjalan lama. Server berusaha semaksimal mungkin untuk membatalkan operasi, tetapi keberhasilan tidak dijamin. Jika server tidak mendukung metode ini, google.rpc.Code.UNIMPLEMENTED akan ditampilkan. Klien dapat menggunakan Operations.GetOperation atau metode lain untuk memeriksa apakah pembatalan berhasil atau apakah operasi selesai meskipun terjadi pembatalan. Jika pembatalan berhasil, operasi tidak dihapus; sebagai gantinya, operasi ini menjadi operasi dengan nilai Operation.error dengan google.rpc.Status.code 1, yang sesuai dengan Code.CANCELLED.
Menghapus operasi yang berjalan lama. Metode ini menunjukkan bahwa klien tidak lagi tertarik pada hasil operasi. Metode tersebut tidak membatalkan operasi. Jika server tidak mendukung metode ini, google.rpc.Code.UNIMPLEMENTED akan ditampilkan.
Mengambil status terbaru dari operasi yang berjalan lama. Klien dapat menggunakan metode ini untuk polling hasil operasi pada interval seperti yang direkomendasikan oleh layanan API.
Menampilkan operasi yang sesuai dengan filter yang ditentukan dalam permintaan. Jika server tidak mendukung metode ini, UNIMPLEMENTED akan ditampilkan.
Menunggu hingga operasi jangka panjang yang ditentukan selesai atau mencapai waktu tunggu maksimum yang telah ditentukan, sehingga menampilkan status terbaru. Jika operasi sudah selesai, status terbaru segera ditampilkan. Jika waktu tunggu yang ditentukan lebih besar daripada waktu tunggu HTTP/RPC default, waktu tunggu HTTP/RPC akan digunakan. Jika server tidak mendukung metode ini, google.rpc.Code.UNIMPLEMENTED akan ditampilkan. Perhatikan bahwa metode ini atas dasar upaya terbaik. Fungsi ini dapat menampilkan status terbaru sebelum waktu tunggu yang ditentukan (termasuk seketika), yang berarti bahkan respons langsung tidak menjamin bahwa operasi selesai.
Daftar operasi yang cocok dengan filter yang ditentukan dalam permintaan.
next_page_token
string
Daftar standar token halaman berikutnya.
Operasi
Resource ini mewakili operasi yang berjalan lama yang merupakan hasil dari panggilan API jaringan.
Kolom
name
string
Nama server yang ditetapkan, yang hanya bersifat unik dalam layanan yang sama yang awalnya menampilkannya. Jika Anda menggunakan pemetaan HTTP default, name harus berupa nama resource yang diakhiri dengan operations/{unique_id}.
Metadata khusus layanan yang terkait dengan operasi. Biasanya berisi informasi kemajuan dan metadata umum, seperti membuat waktu. Beberapa layanan mungkin tidak menyediakan metadata semacam itu. Setiap metode yang menampilkan operasi yang berjalan lama harus mendokumentasikan tipe metadata, jika ada.
done
bool
Jika nilainya false, itu berarti operasi masih berlangsung. Jika true, operasi selesai, dan error atau response tersedia.
Kolom union result. Hasil operasi, yang dapat berupa error atau response yang valid. Jika done == false, error atau response tidak ditetapkan. Jika done == true, tepat satu dari error atau response dapat ditetapkan. Beberapa layanan mungkin tidak memberikan hasilnya. result hanya dapat berupa salah satu dari berikut:
Respons operasi normal dan berhasil. Jika metode asli tidak menampilkan data saat berhasil, seperti Delete, responsnya adalah google.protobuf.Empty. Jika metode asli adalah Get/Create/Update standar, responsnya harus berupa resource. Untuk metode lain, respons harus memiliki jenis XxxResponse, dengan Xxx yang merupakan nama metode asli. Misalnya, jika nama metode aslinya adalah TakeSnapshot(), jenis respons yang disimpulkan adalah TakeSnapshotResponse.
Durasi maksimum untuk menunggu sebelum waktu habis. Jika dibiarkan kosong, waktu menunggu paling lama adalah yang diizinkan oleh protokol HTTP / RPC yang mendasarinya. Jika batas waktu RPC juga ditentukan, yang lebih singkat akan digunakan.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2024-04-19 UTC."],[],[],null,["# Package google.longrunning\n\nIndex\n-----\n\n- [Operations](/speech-to-text/v2/docs/reference/rpc/google.longrunning#google.longrunning.Operations) (interface)\n- [CancelOperationRequest](/speech-to-text/v2/docs/reference/rpc/google.longrunning#google.longrunning.CancelOperationRequest) (message)\n- [DeleteOperationRequest](/speech-to-text/v2/docs/reference/rpc/google.longrunning#google.longrunning.DeleteOperationRequest) (message)\n- [GetOperationRequest](/speech-to-text/v2/docs/reference/rpc/google.longrunning#google.longrunning.GetOperationRequest) (message)\n- [ListOperationsRequest](/speech-to-text/v2/docs/reference/rpc/google.longrunning#google.longrunning.ListOperationsRequest) (message)\n- [ListOperationsResponse](/speech-to-text/v2/docs/reference/rpc/google.longrunning#google.longrunning.ListOperationsResponse) (message)\n- [Operation](/speech-to-text/v2/docs/reference/rpc/google.longrunning#google.longrunning.Operation) (message)\n- [WaitOperationRequest](/speech-to-text/v2/docs/reference/rpc/google.longrunning#google.longrunning.WaitOperationRequest) (message)\n\nOperations\n----------\n\nManages long-running operations with an API service.\n\nWhen an API method normally takes long time to complete, it can be designed to return [Operation](/speech-to-text/v2/docs/reference/rpc/google.longrunning#google.longrunning.Operation) to the client, and the client can use this interface to receive the real response asynchronously by polling the operation resource, or pass the operation resource to another API (such as Pub/Sub API) to receive the response. Any API service that returns long-running operations should implement the `Operations` interface so developers can have a consistent client experience.\n\nCancelOperationRequest\n----------------------\n\nThe request message for [Operations.CancelOperation](/speech-to-text/v2/docs/reference/rpc/google.longrunning#google.longrunning.Operations.CancelOperation).\n\nDeleteOperationRequest\n----------------------\n\nThe request message for [Operations.DeleteOperation](/speech-to-text/v2/docs/reference/rpc/google.longrunning#google.longrunning.Operations.DeleteOperation).\n\nGetOperationRequest\n-------------------\n\nThe request message for [Operations.GetOperation](/speech-to-text/v2/docs/reference/rpc/google.longrunning#google.longrunning.Operations.GetOperation).\n\nListOperationsRequest\n---------------------\n\nThe request message for [Operations.ListOperations](/speech-to-text/v2/docs/reference/rpc/google.longrunning#google.longrunning.Operations.ListOperations).\n\nListOperationsResponse\n----------------------\n\nThe response message for [Operations.ListOperations](/speech-to-text/v2/docs/reference/rpc/google.longrunning#google.longrunning.Operations.ListOperations).\n\nOperation\n---------\n\nThis resource represents a long-running operation that is the result of a network API call.\n\nWaitOperationRequest\n--------------------\n\nThe request message for [Operations.WaitOperation](/speech-to-text/v2/docs/reference/rpc/google.longrunning#google.longrunning.Operations.WaitOperation)."]]
