Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Alur kerja memublikasikan konektor untuk mempermudah akses ke produkGoogle Cloud lainnya dalam alur kerja. Untuk referensi mendetail tentang konektor yang tersedia, lihat Referensi konektor.
Konektor dapat digunakan untuk terhubung ke API Google Cloud lainnya dalam
alur kerja, dan untuk mengintegrasikan alur kerja Anda dengan produk
Google Cloudtersebut. Misalnya, Anda dapat menggunakan konektor untuk memublikasikan pesan Pub/Sub, membaca atau menulis data ke database Firestore, atau mengambil kunci autentikasi dari Secret Manager.
Pelajari cara menggunakan konektor.
Konektor menyederhanakan layanan panggilan karena menangani pemformatan
permintaan untuk Anda, menyediakan metode dan argumen sehingga Anda tidak perlu mengetahui
detail API Google Cloud .
Konektor menggunakan autentikasi Identity and Access Management bawaan untuk berinteraksi dengan produkGoogle Cloud lainnya. Perhatikan bahwa alur kerja yang menggunakan konektor masih
perlu memiliki izin yang sesuai yang ditetapkan ke akun layanannya untuk melakukan autentikasi dengan benar
ke API tertentu. Misalnya, untuk memublikasikan pesan ke
Pub/Sub, akun layanan yang terkait dengan alur kerja Anda harus
diberi peran roles/pubsub.publisher.
Untuk mempelajari lebih lanjut cara melakukan autentikasi ke produk Google Cloud lain, lihat
Memberikan izin alur kerja untuk mengakses Google Cloud resource.
Secara default, waktu tunggu permintaan habis setelah 30 menit. Perhatikan bahwa untuk operasi yang berjalan lama, hal ini berlaku untuk setiap permintaan (misalnya, memulai operasi atau memeriksa statusnya) dalam operasi yang berjalan lama. Waktu tunggu
untuk seluruh operasi dapat dikonfigurasi menggunakan
kolom connector_params. Lihat Referensi konektor.
Operasi yang berjalan lama
Untuk panggilan yang melakukan operasi yang berjalan lama, perilaku berikut berlaku:
Alur kerja memblokir eksekusi alur kerja hingga operasi berhasil atau gagal.
Secara default, waktu tunggu panggilan habis setelah 30 menit. Waktu tunggu panggilan dapat
diubah menggunakan kolom connector_params (maksimal satu tahun). Lihat
Referensi konektor.
Konektor melakukan polling operasi yang berjalan lama secara berkala. Secara default,
Alur Kerja menggunakan backoff eksponensial 1,25 saat melakukan polling,
dimulai dengan 1 detik dan melambat menjadi 60 detik di antara polling.
Setiap upaya polling dihitung sebagai langkah yang dapat ditagih. Parameter polling dapat
diubah menggunakan kolom connector_params. Lihat Referensi konektor.
Mekanisme percobaan ulang sebelumnya berlaku untuk upaya polling yang gagal.
Respons polling diperiksa dan jika payload respons tidak valid, error ResponseTypeError akan ditampilkan.
Jika error terjadi selama operasi yang berjalan lama, Alur Kerja
akan menampilkan error OperationError. Error ini menyertakan atribut tambahan,
error, yang berisi detail khusus operasi.
Jika operasi yang berjalan lama gagal, panggilan konektor akan menampilkan pengecualian dengan atribut berikut:
message: Pesan error yang dapat dibaca manusia.
tags: Daftar tag. Untuk panggilan konektor operasi yang berjalan lama, daftar ini mencakup OperationError.
operation: Objek operasi yang berjalan lama dan gagal.
Untuk mengetahui daftar mendetail tentang jenis operasi yang berjalan lama dan didukung, lihat
Referensi konektor.
[[["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 2025-08-18 UTC."],[],[],null,["# Understand connectors\n\nWorkflows publishes connectors to make it easier to access other\nGoogle Cloud products within a workflow. For a detailed reference of available\nconnectors, see the\n[Connectors reference](/workflows/docs/reference/googleapis).\n\nConnectors can be used to connect to other Google Cloud APIs within\na workflow, and to integrate your workflows with those Google Cloud\nproducts. For example, you can use connectors to publish Pub/Sub\nmessages, read or write data to a Firestore database, or retrieve\nauthentication keys from Secret Manager.\n[Learn how to use a connector](/workflows/docs/invoke-connector-to-gcp-service).\n\nConnectors simplify calling services because they handle the formatting of\nrequests for you, providing methods and arguments so that you don't need to know\nthe details of a Google Cloud API.\n\nConnectors have built-in behavior for handling [retries](#retries) and\n[long-running operations](#lro).\n| **Note:** API operations that are facilitated by Workflows connectors should not be confused with calling or invoking a Google Cloud service---such as Cloud Run functions or Cloud Run---which is done through an [HTTP request](/workflows/docs/http-requests).\n\nAuthentication\n--------------\n\nConnectors use built-in Identity and Access Management authentication to interact with other\nGoogle Cloud products. Note that a workflow using a connector still\nneeds to have proper permissions assigned to its service account to properly\nauthenticate to a given API. For example, to publish a message to\nPub/Sub, the service account associated with your workflow needs to be\ngranted the [`roles/pubsub.publisher` role](/pubsub/docs/access-control#roles).\nTo learn more about authenticating to other Google Cloud products, see\n[Grant a workflow permission to access Google Cloud resources](/workflows/docs/authentication).\n\nRetries\n-------\n\nAll connectors apply the following\n[retry policy](/workflows/docs/reference/syntax/retrying) and error\nhandling configurations:\n\n- Workflows uses an\n [idempotent retry policy](/workflows/docs/reference/syntax/retrying#retry-idempotent)\n for GET requests.\n\n- Workflows uses a\n [non-idempotent retry policy](/workflows/docs/reference/syntax/retrying#retry-non-idempotent)\n for all other HTTP methods.\n\n- By default, requests time out after 30 minutes. Note that for long-running\n operations, this applies to individual requests (for example, starting the\n operation or checking its status) within the long-running operation. The\n timeout for the entire operation can be configured using the\n `connector_params` field. See the [Connectors reference](/workflows/docs/reference/googleapis).\n\nLong-running operations\n-----------------------\n\nFor calls performing a long-running operation, the following behaviors apply:\n\n- Workflows blocks the workflow execution until the operation\n completes successfully or fails.\n\n- By default, calls time out after 30 minutes. The timeout of the call can be\n changed using the `connector_params` field (to a maximum of one year). See the\n [Connectors reference](/workflows/docs/reference/googleapis).\n\n- Connectors poll long-running operations periodically. By default,\n Workflows uses an exponential backoff of 1.25 when polling,\n starting with 1 second and slowing to 60 seconds between polls.\n Each polling attempt counts as a billable step. The polling parameters can be\n changed using the `connector_params` field. See the [Connectors reference](/workflows/docs/reference/googleapis).\n\n- The preceding retry mechanism applies to a failed polling attempt.\n\n- Poll responses are checked and if the response payload is invalid, a\n `ResponseTypeError` error is returned.\n\n- When an error occurs during a long-running operation, Workflows\n raises an `OperationError` error. The error includes an additional attribute,\n `error`, which contains operation-specific details.\n\nIf a long-running operation fails, the connector call throws an exception with\nthe following attributes:\n\n- `message`: Human-readable error message.\n- `tags`: A list of tags. For a long-running operation connector call, the list includes `OperationError`.\n- `operation`: The failed long-running operation object.\n\nFor a detailed list of supported long-running operation types, see the\n[Connectors reference](/workflows/docs/reference/googleapis).\n\nWhat's next\n-----------\n\n- [Tutorial: Run a batch translation using the Cloud Translation connector](/workflows/docs/tutorials/translation-connector)"]]
