Lihat konektor yang didukung untuk Application Integration.

Spreadsheet - Dapatkan tugas

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 Spreadsheet - Dapatkan memungkinkan Anda membaca dan mengambil satu rentang nilai dari spreadsheet Google.

Spreadsheet: Objek utama di Google Spreadsheet yang dapat berisi beberapa sheet. Setiap sheet memiliki informasi terstruktur yang terdapat dalam sel.

Anda dapat menemukan ID spreadsheet dari URL webnya. Contoh, https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit#gid=0

Google Spreadsheet adalah salah satu dari banyak solusi produktivitas berbasis cloud di Google Workspace. Alat ini memungkinkan Anda membuat dan mengedit spreadsheet online dengan fungsi kolaborasi real-time.

Sebelum memulai

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

1. Mengaktifkan Google Sheets API (sheets.googleapis.com).

   Mengaktifkan Google Sheets API

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

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

3. Pahami dan pelajari istilah umum yang digunakan di Spreadsheet Google.

Mengonfigurasi Spreadsheet - Dapatkan tugas

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 Spreadsheet - Get di editor integrasi.
6. Klik elemen Spreadsheet - Get pada desainer untuk melihat panel konfigurasi tugas Spreadsheet - 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 Sheets - Get:

Properti	Jenis data	Deskripsi
SpreadsheetId	String	ID spreadsheet Anda. Anda dapat menemukan ID spreadsheet dari URL webnya. Contoh, https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit#gid=0
MajorDimension	enum (Dimensi)	Kategori atau dimensi utama yang harus diterapkan. Misalnya ROWS atau COLUMNS. Nilai default: DIMENSION_UNSPECIFIED
Rentang	String	Notasi A1 atau notasi R1C1 rentang yang nilainya akan diambil.
dateTimeRenderOption	enum (DateTimeRenderOption)	Menunjukkan bagaimana nilai terkait tanggal, waktu, dan durasi dinyatakan dalam output. Catatan: dateTimeRenderOption tidak dipertimbangkan jika nilai yang ditentukan untuk valueRenderOption adalah FORMATTED_VALUE. Nilai default: SERIAL_NUMBER
ValueRenderOption	enum (ValueRenderOption)	Menunjukkan bagaimana nilai yang diambil diwakili dalam output. Nilai default: FORMATTED_VALUE

Output tugas

Tugas Spreadsheet - Get menampilkan output respons yang berisi objek ValueRange yang sesuai dengan rentang yang diminta. Berikut adalah contoh output:

    {
        "range": "Sheet1!A1:D5",
        "majorDimension": "ROWS",
        "values": [
          ["Item", "Cost", "Stocked", "Ship Date"],
          ["Wheel", "$20.50", "4", "42430"],
          ["Door", "$15", "2", "42444"],
          ["Engine", "$100", "1", "42449"],
          ["Totals", "=SUM(B2:B4)", "=SUM(C2:C4)", "=MAX(D2:D4)"]
        ],
      }

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.