Lihat konektor yang didukung untuk Application Integration.

Firestore - Tugas Pengambilan Dokumen

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dalam Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Tugas Firestore - Document Get memungkinkan Anda mengambil isi dari satu dokumen Firestore. Secara default, tugas Firestore - Document Get mengambil snapshot dokumen terbaru dari database Firestore Anda.

Firestore adalah database dokumen NoSQL yang dibangun untuk penskalaan otomatis, performa tinggi, dan kemudahan pengembangan aplikasi.

Sebelum memulai

Pastikan Anda melakukan tugas berikut di project Google Cloud sebelum mengonfigurasi tugas Firestore - Document Get:

1. Mengaktifkan Cloud Firestore API (firestore.googleapis.com).

   Mengaktifkan Cloud Firestore API

2. Buat profil autentikasi. Application Integration menggunakan profil autentikasi untuk terhubung ke endpoint autentikasi untuk tugas Firestore - Document Get.

   Untuk informasi tentang memberikan peran atau izin tambahan ke akun layanan, lihat Memberikan, mengubah, dan mencabut akses.

Mengonfigurasi tugas Firestore - Pengambilan Dokumen

1. Di konsol Google Cloud, buka halaman Application Integration.

   Buka Application Integration

2. Di menu navigasi, klik Integrasi.

   Halaman Integrations akan muncul dan mencantumkan semua integrasi yang tersedia di project Google Cloud.

3. Pilih integrasi yang ada atau klik Buat integrasi untuk membuat integrasi baru.

   Jika Anda membuat integrasi baru:

   1. Masukkan nama dan deskripsi di panel Create Integration.
   2. Pilih region untuk integrasi.
      Catatan: Dropdown Regions hanya mencantumkan region yang disediakan di project Google Cloud Anda. Untuk menyediakan wilayah baru, klik Aktifkan Wilayah. Lihat Mengaktifkan wilayah baru untuk informasi selengkapnya.
   3. Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Integration summary di toolbar integrasi.
      Catatan: Opsi untuk memilih akun layanan hanya ditampilkan jika Anda telah mengaktifkan tata kelola integrasi untuk wilayah yang dipilih.
   4. Klik Create.

   Tindakan ini akan membuka integrasi di editor integrasi.

4. Di menu navigasi editor integrasi, klik Tasks untuk melihat daftar tugas yang tersedia.
5. Klik dan tempatkan elemen Firestore - Document Get di editor integrasi.
6. Klik elemen Firestore - Document Get pada desainer untuk melihat panel konfigurasi tugas Firestore - Document Get.
7. Buka Authentication, lalu pilih profil autentikasi yang ada yang ingin Anda gunakan.

   Opsional. Jika Anda belum membuat profil autentikasi sebelum mengonfigurasi tugas, Klik + Profil autentikasi baru, lalu ikuti langkah-langkah yang disebutkan dalam Membuat profil autentikasi baru.

8. Buka Input Tugas, dan konfigurasi kolom input yang ditampilkan menggunakan tabel Parameter input tugas berikut.

   Perubahan pada kolom input disimpan secara otomatis.

Parameter input tugas

Tabel berikut menjelaskan parameter input dari tugas Firestore - Document Get:

Properti	Jenis data	Deskripsi
Region	String	Lokasi database Firestore. Misalnya, us-central1.
ProjectsId	String	ID Project Google Cloud Anda.
DatabasesId	String	ID database Firestore.
DocumentsId	String	Jalur atau lokasi ke dokumen Firestore.

Output tugas

Tugas Firestore - Document Get menampilkan data dokumen dalam format berenkode base64. Anda harus mendekode nilai berenkode base64 untuk mendapatkan string output.

Tips: Anda dapat mengenkode atau mendekode data base64 menggunakan perintah base64 di Linux atau macOS, atau perintah Base64.exe di Windows. Bahasa pemrograman dan skrip biasanya menyertakan library untuk encoding base64. Untuk mengetahui contoh command line, baca Mendekode base64 dalam dokumentasi Cloud Text-to-Speech.

Strategi penanganan error

Strategi penanganan error untuk tugas menentukan tindakan yang akan diambil jika tugas gagal karena error sementara. Untuk mendapatkan informasi tentang cara menggunakan strategi penanganan error, dan mengetahui berbagai jenis strategi penanganan error, lihat Strategi penanganan error.

Langkah selanjutnya

1. Tambahkan kondisi tepi dan tepi.
2. Uji dan publikasikan integrasi Anda.
3. Mengonfigurasi pemicu.
4. Tambahkan tugas Pemetaan Data.
5. Lihat semua tugas untuk layanan Google Cloud.