Airtable

Konektor Airtable memungkinkan Anda melakukan operasi penyisipan, penghapusan, pembaruan, dan pembacaan pada data Airtable.

Versi yang didukung

Konektor ini mendukung Airtable API versi v0.

Sebelum memulai

Sebelum menggunakan konektor Airtable, lakukan tugas berikut:

  • Di project Google Cloud Anda:
    • Pastikan konektivitas jaringan sudah disiapkan. Untuk mengetahui informasi tentang pola jaringan, lihat Konektivitas jaringan.
    • Berikan peran IAM roles/connectors.admin kepada pengguna yang mengonfigurasi konektor.
    • Berikan peran IAM berikut ke akun layanan yang ingin Anda gunakan untuk konektor:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Akun layanan adalah jenis Akun Google khusus yang dimaksudkan untuk mewakili pengguna non-manusia yang perlu diautentikasi dan diberi otorisasi untuk mengakses data di Google API. Jika tidak memiliki akun layanan, Anda harus membuat akun layanan. Untuk informasi selengkapnya, lihat Membuat akun layanan.

    • Aktifkan layanan berikut:
      • secretmanager.googleapis.com (Secret Manager API)
      • connectors.googleapis.com (Connectors API)

      Untuk memahami cara mengaktifkan layanan, lihat Mengaktifkan layanan.

    Jika layanan atau izin ini belum diaktifkan untuk project Anda sebelumnya, Anda akan diminta untuk mengaktifkannya saat mengonfigurasi konektor.

  • Untuk informasi tentang cara membuat ruang kerja Airtable, lihat Memulai Airtable. Untuk informasi tentang Airtable API, lihat Referensi Airtable API.

Mengonfigurasi konektor

Untuk mengonfigurasi konektor, Anda harus membuat koneksi ke sumber data (sistem backend). Koneksi bersifat khusus untuk sumber data. Artinya, jika memiliki banyak sumber data, Anda harus membuat koneksi terpisah untuk setiap sumber data. Untuk membuat koneksi, lakukan langkah-langkah berikut:

  1. Di konsol Cloud, buka halaman Konektor Integrasi > Koneksi, lalu pilih atau buat project Google Cloud.

    Buka halaman Koneksi

  2. Klik + BUAT BARU untuk membuka halaman Buat Koneksi.
  3. Di bagian Location, pilih lokasi untuk koneksi.
    1. Region: Pilih lokasi dari menu drop-down.

      Untuk mengetahui daftar semua region yang didukung, lihat Lokasi.

    2. Klik NEXT.
  4. Di bagian Connection Details, selesaikan tindakan berikut:
    1. Konektor: Pilih Airtable dari menu drop-down Konektor yang tersedia.
    2. Versi konektor: Pilih versi Konektor dari menu drop-down versi yang tersedia.
    3. Di kolom Nama Koneksi, masukkan nama untuk instance Koneksi.

      Nama koneksi harus memenuhi kriteria berikut:

      • Nama koneksi dapat menggunakan huruf, angka, atau tanda hubung.
      • Huruf harus berupa huruf kecil.
      • Nama koneksi harus diawali dengan huruf dan diakhiri dengan huruf atau angka.
      • Nama koneksi tidak boleh melebihi 49 karakter.
    4. Secara opsional, masukkan Description untuk instance koneksi.
    5. Secara opsional, aktifkan Cloud Logging, lalu pilih level log. Secara default, level log ditetapkan ke Error.
    6. Service Account: Pilih akun layanan yang memiliki peran yang diperlukan.
    7. ID Dasar: ID dasar Airtable. Jika ID Dasar ditentukan, hanya metadata terkait yang akan diambil. Jika Airtable Metadata API diaktifkan, Anda tidak perlu menentukan ID Dasar.
    8. Nama Dasar: Skema yang akan digunakan yang sesuai dengan dasar Airtable. Gunakan kolom ini hanya jika Airtable Metadata API diaktifkan.
    9. Display Object Ids: Pilih opsi ini untuk mengganti nama skema, tabel, tampilan, dan kolom dengan ID internal yang sesuai.
    10. Pemisah Jalur: Tentukan karakter yang akan digunakan sebagai pemisah untuk membuat nama kolom berdasarkan jalur.
    11. Tampilan yang Ditetapkan Pengguna: Tentukan jalur file konfigurasi JSON yang berisi tampilan kustom Anda.
    12. Pemisah Nilai: Tentukan pemisah yang akan digunakan untuk nilai array sebagai satu string.
    13. Secara opsional, klik + TAMBAHKAN LABEL untuk menambahkan label ke koneksi dalam bentuk pasangan nilai kunci.
    14. Klik NEXT.
    15. Secara opsional, konfigurasikan Setelan node koneksi:

      • Jumlah node minimum: Masukkan jumlah minimum node koneksi.
      • Maximum number of nodes: Masukkan jumlah maksimum node koneksi.

      Node adalah unit (atau replika) koneksi yang memproses transaksi. Semakin banyak node yang diperlukan untuk memproses lebih banyak transaksi untuk koneksi, dan sebaliknya, semakin sedikit node yang diperlukan untuk memproses lebih sedikit transaksi. Untuk memahami pengaruh node terhadap harga konektor Anda, lihat Harga untuk node koneksi. Jika Anda tidak memasukkan nilai apa pun, secara default, node minimum ditetapkan ke 2 (untuk ketersediaan yang lebih baik) dan node maksimum ditetapkan ke 50.

  5. Di bagian Authentication, masukkan detail autentikasi.
    1. Pilih Jenis autentikasi dan masukkan detail yang relevan.

      Jenis autentikasi berikut didukung oleh koneksi Airtable:

      • Token Akses Pribadi

      2. Untuk memahami cara mengonfigurasi jenis autentikasi ini, lihat Mengonfigurasi autentikasi.

    2. Klik NEXT.
  6. Tinjau: Tinjau detail koneksi dan autentikasi Anda.
  7. Klik Buat.

Mengonfigurasi autentikasi

Masukkan detail berdasarkan autentikasi yang ingin Anda gunakan.

  • Token Akses Pribadi: Rahasia pengelola rahasia yang berisi token akses pribadi.
  • Versi secret: Versi secret untuk secret yang dipilih.

Contoh konfigurasi koneksi

Bagian ini mencantumkan contoh nilai untuk berbagai kolom yang Anda konfigurasi saat membuat koneksi.

Jenis koneksi Token Akses Pribadi

Nama kolom Detail
Lokasi europe-west1
Konektor Airtable
Versi konektor 1
Nama Koneksi airtable-connection-new
Mengaktifkan Cloud Logging Ya
Akun Layanan SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
ID Dasar appK32XeZXReEQzja
Nama Dasar Data Pengujian Kendaraan Bermotor
Pembatas Jalur NA
Tampilan yang Ditetapkan Pengguna NA
Pembatas Nilai NA
Jumlah minimum node 2
Jumlah maksimum node 50
Token Akses Pribadi Ya
Token Akses Pribadi projects/617888XXXX/secrets/airtable-new-conn/versions/3
Versi rahasia 3

Batasan sistem

Konektor Airtable dapat memproses maksimum 3 transaksi per detik, per node, dan mencegah transaksi apa pun yang melebihi batas ini. Secara default, Konektor Integrasi mengalokasikan 2 node (untuk ketersediaan yang lebih baik) untuk koneksi.

Untuk mengetahui informasi tentang batas yang berlaku untuk Konektor Integrasi, lihat Batas.

Menggunakan koneksi Airtable dalam integrasi

Setelah Anda membuat koneksi, koneksi tersebut akan tersedia di Integration Apigee dan Integration Aplikasi. Anda dapat menggunakan koneksi dalam integrasi melalui tugas Konektor.

  • Untuk memahami cara membuat dan menggunakan tugas Konektor di Apigee Integration, lihat Tugas konektor.
  • Untuk memahami cara membuat dan menggunakan tugas Konektor di Integrasi Aplikasi, lihat Tugas konektor.

Entity, operasi, dan tindakan

Semua Konektor Integrasi menyediakan lapisan abstraksi untuk objek aplikasi yang terhubung. Anda hanya dapat mengakses objek aplikasi melalui abstraksi ini. Abstraksi ditampilkan kepada Anda sebagai entitas, operasi, dan tindakan.

  • Entity: Entity dapat dianggap sebagai objek, atau kumpulan properti, dalam aplikasi atau layanan yang terhubung. Definisi entitas berbeda dari konektor ke konektor. Misalnya, dalam konektor database, tabel adalah entitas, dalam konektor server file, folder adalah entitas, dan dalam konektor sistem pesan, antrean adalah entitas.

    Namun, mungkin konektor tidak mendukung atau memiliki entity apa pun, dalam hal ini, daftar Entities akan kosong.

  • Operasi: Operasi adalah aktivitas yang dapat Anda lakukan pada entity. Anda dapat melakukan salah satu operasi berikut pada entitas:

    Memilih entitas dari daftar yang tersedia akan menghasilkan daftar operasi yang tersedia untuk entitas tersebut. Untuk deskripsi mendetail tentang operasi, lihat operasi entity tugas Konektor. Namun, jika konektor tidak mendukung operasi entitas apa pun, operasi yang tidak didukung tersebut tidak akan tercantum dalam daftar Operations.

  • Tindakan: Tindakan adalah fungsi kelas satu yang tersedia untuk integrasi melalui antarmuka konektor. Tindakan memungkinkan Anda membuat perubahan pada satu atau beberapa entitas, dan bervariasi dari satu konektor ke konektor lainnya. Biasanya, tindakan akan memiliki beberapa parameter input, dan parameter output. Namun, konektor mungkin tidak mendukung tindakan apa pun, dalam hal ini daftar Actions akan kosong.

Contoh operasi entity

Bagian ini menunjukkan cara melakukan beberapa operasi entity di konektor ini.

Contoh - Operasi daftar untuk entity Data Kontak (Data)

  1. Pada dialog Configure connector task, klik Entities.
  2. Pilih Contact Data dari daftar Entity.
  3. Pilih operasi List, lalu klik Done.
  4. bagian Task Input dari tugas Connectors, Anda dapat menetapkan filterClause sesuai dengan persyaratan pelanggan.

    5. Selalu tentukan nilai klausa filter dalam tanda kutip tunggal (').

Anda juga dapat melakukan operasi daftar pada entitas berikut:
Contacts Data.Main View, Contacts Data.Calendar, Contacts Data.Kanban, Contacts Data.Gallery, Contacts Data.List, dan Contacts Data_Collaborators

Contoh - Mendapatkan data untuk entity Data Kontak (Data)

  1. Pada dialog Configure connector task, klik Entities.
  2. Pilih Contact Data dari daftar Entity.
  3. Pilih operasi GET, lalu klik Done.
  4. Tetapkan ID entity ke "recg7qjPRMa7DBwIb" yang merupakan Kunci yang akan diteruskan. Untuk menetapkan ID entitas, di bagian Data Mapper pada Data Mapping, klik Open Data Mapping Editor, lalu masukkan "recg7qjPRMa7DBwIb" di kolom Input Value dan pilih EntityId sebagai variabel lokal.

    Di sini, ID Entitas: "recg7qjPRMa7DBwIb" adalah nilai kunci utama unik dan harus diteruskan secara langsung.

Jika entity memiliki kunci utama gabungan, Anda dapat menentukan klausa filter.

Anda juga dapat melakukan operasi get pada entitas berikut: Contacts Data.Main View, Contacts Data.Calendar, Contacts Data.Kanban, Contacts Data.Gallery, Contacts Data.List, dan Contacts Data_Collaborators.

Contoh - Menghapus data entitas Data Kontak (Data)

  1. Pada dialog Configure connector task, klik Entities.
  2. Pilih Contact Data dari daftar Entity.
  3. Pilih operasi Delete, lalu klik Done.
  4. Tetapkan ID entitas ke "recg7qjPRMa7DBwIb" yang merupakan Kunci yang akan diteruskan.Untuk menetapkan ID entitas, di bagian Data Mapper pada Pemetaan Data, klik Buka Editor Pemetaan Data, lalu masukkan "recg7qjPRMa7DBwIb" di kolom Nilai Input dan pilih EntityId sebagai Variabel lokal.

Jika entity memiliki kunci utama gabungan, Anda dapat menentukan klausa filter.

Contoh - Membuat operasi untuk entity Data Kontak (Data)

  1. Pada dialog Configure connector task, klik Entities.
  2. Pilih Contact Data dari daftar Entity.
  3. Pilih operasi Create, lalu klik Selesai.
  4. Di bagian Data Mapper pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload sebagai Variabel lokal. 
    {
"First Name": "Demo4",
"Last Name": "Alex",
"Email": "cloudysanfrancisco@gmail.com",
"DOB": "2000-04-14",
"Office": "Denver",
"Phone Number": "1-175-432-1437",
"Current Brand": "Mercedes"
}

    Jika integrasi berhasil, parameter respons connectorOutputPayload tugas konektor Anda akan memiliki nilai yang mirip dengan berikut:

    {
"Internal_Id": "recg7qjPRMa7DBwIb"
}
  
<pre>
  function helloWorld() {
    alert('Hello, world! This sentence is so long that it wraps onto a second
      line.');
  }
  
  /n
  <h3>Example title</h3>
  </pre>

Contoh - Operasi pembaruan untuk entity Data Kontak (Data)

  1. Pada dialog Configure connector task, klik Entities.
  2. Pilih ContactData dari daftar Entity.
  3. Pilih operasi Update, lalu klik Selesai.
  4. Di bagian Data Mapper pada tugas Data Mapping, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal. 
    {
"Phone Number": "1-175-432-4312",
"Current Brand": "Honda"
}

    Daripada menentukan entityId, Anda juga dapat menetapkan filterClause ke Internal_Id='reckqGnFusjDlnmvs'.

    5. Jika integrasi berhasil, variabel output connectorOutputPayload tugas konektor Anda:

    {
"Internal_Id": "reckqGnFusjDlnmvs"
}

Contoh - Operasi pembaruan untuk entity Data Kontak (Lampiran)

  1. Pada dialog Configure connector task, klik Entities.
  2. Pilih Contact Data dari daftar Entity.
  3. Pilih operasi Update, lalu klik Selesai.
  4. Di bagian Data Mapper pada tugas Data Mapping, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal. 
    {
"Attachment": "[{\"url\":\"https://media.istockphoto.com/id/2086323995/photo/global-communication-east-asia.jpg?s=2048x2048&w=is&k=20&c=Z50lesspQQzxWug0m11QrPZMOUzMeTufgnLHh_3COy4=\",\"filename\":\"BMW\"}]"
}

    Daripada menentukan entityId, Anda juga dapat menetapkan filterClause ke Internal_Id='reckqGnFusjDlnmvs'.

    Jika integrasi berhasil, variabel output connectorOutputPayload tugas konektor Anda:

    {
"Internal_Id": "recoGHHp8y11aSx0E"
}

Contoh - Operasi pembaruan untuk entity Data Kontak (Kotak Centang)

  1. Pada dialog Configure connector task, klik Entities.
  2. Pilih Contact Data dari daftar Entity.
  3. Pilih operasi Update, lalu klik Selesai.
  4. Di bagian Data Mapper pada tugas Data Mapping, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal. 
    {
"Checkbox": true
}

    Daripada menentukan entityId, Anda juga dapat menetapkan filterClause ke Internal_Id='reckqGnFusjDlnmvs'.

    Jika integrasi berhasil, variabel output connectorOutputPayload tugas konektor Anda:

    {
"Internal_Id": "recoGHHp8y11aSx0E"
}

Contoh - Operasi pembaruan untuk entity Data Kontak (Nomor)

  1. Pada dialog Configure connector task, klik Entities.
  2. Pilih ContactData dari daftar Entity.
  3. Pilih operasi Update, lalu klik Selesai.
  4. Di bagian Data Mapper pada tugas Data Mapping, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal. 
    {
"Number": 1001.0
}

    Daripada menentukan entityId, Anda juga dapat menetapkan filterClause ke Internal_Id='reckqGnFusjDlnmvs'.

    Jika integrasi berhasil, variabel output connectorOutputPayload tugas konektor Anda:

    {
"Internal_Id": "recoGHHp8y11aSx0E"
}

Contoh - Operasi pembaruan untuk entity Data Kontak (DateField)

  1. Pada dialog Configure connector task, klik Entities.
  2. Pilih ContactData dari daftar Entity.
  3. Pilih operasi Update, lalu klik Selesai.
  4. Di bagian Data Mapper pada tugas Data Mapping, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal. 
    {
"DOB": "2000-04-14"
}

    Daripada menentukan entityId, Anda juga dapat menetapkan filterClause ke Internal_Id='reckqGnFusjDlnmvs'.

    Jika integrasi berhasil, variabel output connectorOutputPayload tugas konektor Anda:

    {
"Internal_Id": "recoGHHp8y11aSx0E"
}

Contoh - Operasi pembaruan untuk entity Data Kontak (Teks)

  1. Pada dialog Configure connector task, klik Entities.
  2. Pilih ContactData dari daftar Entity.
  3. Pilih operasi Update, lalu klik Selesai.
  4. Di bagian Data Mapper pada tugas Data Mapping, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal. 
    {
"Singlelinetext": "Airtable Application",
"Long text": "Airtable is a cloud-based collaboration platform that combines the features of a spreadsheet with the capabilities of a database. "
}

    Daripada menentukan entityId, Anda juga dapat menetapkan filterClause ke Internal_Id='reckqGnFusjDlnmvs'.

    Jika integrasi berhasil, variabel output connectorOutputPayload tugas konektor Anda:

    {
"Internal_Id": "recoGHHp8y11aSx0E"
}

Mendapatkan bantuan dari komunitas Google Cloud

Anda dapat memposting pertanyaan dan mendiskusikan konektor ini di komunitas Google Cloud di Cloud Forums.

Langkah berikutnya