Firestore - Tugas Pengambilan Dokumen

Pengumuman: Application Integration kini tersedia untuk project Google Cloud Anda. Anda kini dapat menggunakan Integrasi Apigee dan Application Integration dalam project Google Cloud yang sama. Pelajari lebih lanjut

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

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

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

   Mengaktifkan Cloud Firestore API

2. Buat profil autentikasi. Integrasi Apigee menggunakan profil autentikasi guna 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 UI Apigee, pilih Organisasi Apigee.
2. Klik Develop > Integrations.
3. Pilih integrasi yang ada atau buat integrasi baru dengan mengklik Buat Integrasi.

   Jika Anda membuat integrasi baru:

   1. Masukkan nama dan deskripsi dalam dialog Create Integration.
   2. Pilih Region untuk integrasi dari daftar wilayah yang didukung.
   3. Klik Create.

   Tindakan ini akan membuka integrasi di desainer integrasi.

4. Di menu navigasi desainer integrasi, klik +Tambahkan tugas/pemicu > Tasks untuk melihat daftar tugas yang tersedia.
5. Klik dan tempatkan elemen Firestore - Document Get di desainer 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.

Untuk informasi tentang parameter kueri opsional yang tersedia, lihat Parameter kueri.

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.