Halaman ini diterjemahkan oleh Cloud Translation API.

Smartsheet

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

Versi yang didukung

Konektor ini mendukung Smartsheet versi 25.2.0.246.

Sebelum memulai

Sebelum menggunakan konektor Smartsheet, lakukan tugas berikut:

Di project Google Cloud Anda:
- Pastikan konektivitas jaringan telah 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 Anda tidak memiliki akun layanan, Anda harus membuat akun layanan. Untuk mengetahui 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.

Mengonfigurasi konektor

Koneksi khusus untuk sumber data. Artinya, jika Anda memiliki banyak sumber data, Anda harus membuat koneksi terpisah untuk setiap sumber data. Untuk membuat koneksi, lakukan hal berikut:

Di Konsol Cloud, buka halaman Integration Connectors > Connections lalu pilih atau buat project Google Cloud.
Buka halaman Koneksi
Klik + BUAT BARU untuk membuka halaman Buat Koneksi.
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.
Di bagian Detail Koneksi, selesaikan langkah-langkah berikut:
1. Konektor: Pilih Smartsheet dari daftar drop-down Konektor yang tersedia.
2. Versi konektor: Pilih Versi konektor dari menu drop-down versi yang tersedia.
3. Di kolom Connection Name, 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 Deskripsi untuk instance koneksi.
5. Secara opsional, aktifkan Cloud Logging, lalu pilih level log. Secara default, level log ditetapkan ke Error.
6. Akun Layanan: Pilih akun layanan yang memiliki peran yang diperlukan.
7. Header: Secara opsional, tentukan kolom ini untuk mendeteksi nama kolom dari baris pertama.
8. Sembunyikan Karakter Pemformatan: Jika perlu, tentukan kolom ini untuk menyembunyikan simbol mata uang dan tanda persen dalam nilai numerik. Tindakan ini juga akan mengonversi kolom ini dari varchar menjadi double.
9. Abaikan Baris yang Tidak Ditemukan: Secara opsional, jika kolom ini tidak dipilih dan salah satu ID Baris yang ditentukan tidak ditemukan, tidak ada baris yang akan dihapus, dan error 'tidak ditemukan' akan ditampilkan.
10. Tingkat Kompatibilitas Laporan: Secara opsional, tentukan tingkat kompatibilitas untuk data yang ditampilkan.
11. Gunakan Jalur File Lengkap Sebagai Nama Tabel: Secara opsional, tentukan kolom ini untuk menyertakan jalur file lengkap dalam nama tabel atau tampilan yang diekspos, yang sesuai dengan sheet atau laporan.
12. Sumber Nilai: Secara opsional, menunjukkan apakah sel akan menggunakan kolom Nilai sebagai nilainya atau kolom DisplayValue.
13. Jika perlu, konfigurasikan Setelan node koneksi:
  - Jumlah minimum node: Masukkan jumlah minimum node koneksi.
  - Maximum number of nodes: Masukkan jumlah maksimum node koneksi.
  Node adalah unit (atau replika) koneksi yang memproses transaksi. Jumlah node yang diperlukan untuk memproses lebih banyak transaksi untuk koneksi akan bertambah dan sebaliknya, jumlah node yang diperlukan untuk memproses lebih sedikit transaksi akan berkurang. Untuk memahami pengaruh node terhadap harga konektor, 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.
14. Secara opsional, klik + TAMBAHKAN LABEL untuk menambahkan label ke Koneksi dalam bentuk pasangan nilai kunci.
15. Klik NEXT.
Di bagian Authentication, masukkan detail autentikasi.
1. Pilih Jenis autentikasi dan masukkan detail yang relevan.
  Jenis autentikasi berikut didukung oleh koneksi Smartsheet:
  - OAuth2.0 - Kode Otorisasi
  - Token Akses Pribadi
2. Klik NEXT.
Tinjau: Tinjau detail koneksi dan autentikasi Anda.
Klik Buat.

Contoh konfigurasi koneksi

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

Jenis koneksi autentikasi OAuth 2.0

Nama kolom	Detail
Lokasi	us-central1
Konektor	smartsheet
Versi konektor	1
Nama Koneksi	smartsheet-oauth-connection
Akun Layanan	my-service-account@my-project.iam.gserviceaccount.com
Jumlah minimum node	2
ID Klien	CLIENT_ID
Cakupan	ADMIN_SHEETS, ADMIN_SIGHTS, ADMIN_USERS, ADMIN_WEBHOOKS, ADMIN_WORKSPACES, CREATE_SHEETS, CREATE_SIGHTS, DELETE_SHEETS, DELETE_SIGHTS, READ_CONTACTS, READ_EVENTS, READ_SHEETS, READ_SIGHTS, READ_USERS, SHARE_SHEETS, SHARE_SIGHTS, WRITE_SHEETS
Rahasia klien	CLIENT_SECRET
Versi rahasia	1
URL otorisasi	https://app.smartsheet.com/b/authorize

Jenis koneksi autentikasi token akses pribadi

Nama kolom	Detail
Lokasi	us-central1
Konektor	smartsheet
Versi konektor	1
Nama Koneksi	smartsheet-accesstoken-connection
Akun Layanan	my-service-account@my-project.iam.gserviceaccount.com
Jumlah minimum node	2
Jumlah maksimum node	50
Token Akses Pribadi	PERSONAL_ACCESS_TOKEN
Versi rahasia	3

Anda dapat membuat akun Smartsheet menggunakan link Login Smartsheet.

Untuk mengetahui Smartsheet API lebih lanjut, lihat Referensi Smartsheet API.

Batasan sistem

Konektor Smartsheet dapat memproses maksimum 10 transaksi per detik, per node, dan membatasi transaksi apa pun yang melebihi batas ini. Secara default, Integration Connectors mengalokasikan 2 node (untuk ketersediaan yang lebih baik) untuk koneksi.

Untuk mengetahui informasi tentang batas yang berlaku untuk Integration Connectors, lihat Batas.

Catatan: Jumlah node Integration Connectors akan diskalakan otomatis secara dinamis berdasarkan penggunaan Anda. Namun, jika ingin mencadangkan kapasitas untuk volume besar tanpa menunggu penskalaan otomatis, Anda dapat menyesuaikan nilai node minimum untuk koneksi. Jumlah node yang diperlukan meningkat saat jumlah transaksi yang diproses untuk koneksi bertambah. Sebaliknya, jumlah node yang diperlukan lebih sedikit jika koneksi memproses lebih sedikit transaksi. Untuk mengonfigurasi nilai node, lakukan hal berikut:

Jika Anda adalah pelanggan prabayar, konfigurasikan nilai node minimum dan maksimum di halaman edit koneksi.
Jika Anda adalah pelanggan berbasis langganan, hubungi dukungan.

Jumlah transaksi maksimum yang dapat ditangani oleh sebuah node bergantung pada berbagai faktor. Jadi, sebelum menyesuaikan node minimum untuk mendapatkan throughput yang lebih baik, sebaiknya periksa apakah sistem backend Anda telah disiapkan secara optimal untuk menangani traffic yang diperlukan.

Menggunakan koneksi Smartsheet dalam integrasi

Setelah Anda membuat koneksi, koneksi tersebut akan tersedia di Apigee Integration dan Application Integration. 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.

Tindakan

Bagian ini menunjukkan cara melakukan beberapa tindakan di konektor ini.

Tindakan DownloadAttachment

Tindakan ini mendownload lampiran dari sheet.

Parameter input tindakan DownloadAttachment

Nama parameter	Jenis data	Wajib	Deskripsi
SheetId	String	Benar	ID unik sheet.
AttachmentID	String	Benar	ID unik lampiran.

Untuk contoh cara mengonfigurasi tindakan DownloadAttachment, lihat Contoh.

Tindakan DeleteAttachment

Tindakan ini akan menghapus lampiran tertentu dari sheet.

Parameter input tindakan DeleteAttachment

Nama parameter	Jenis data	Wajib	Deskripsi
SheetId	String	Benar	ID unik sheet.
AttachmentID	String	Benar	ID unik lampiran.

Untuk contoh cara mengonfigurasi tindakan DeleteAttachment, lihat Contoh.

Tindakan CopyRowsToAnotherSheet

Tindakan ini menyalin baris dari satu sheet ke sheet lainnya.

Parameter input tindakan CopyRowsToAnotherSheet

Nama parameter	Jenis data	Wajib	Deskripsi
SheetId	String	Benar	ID unik sheet tempat baris akan disalin.
RowIds	String	Benar	Daftar ID baris yang dipisahkan koma untuk disalin dari sheet.
DestinationSheetId	String	Benar	ID unik dari sheet tujuan tempat baris akan disalin.

Untuk contoh cara mengonfigurasi tindakan CopyRowsToAnotherSheet, lihat Contoh.

Tindakan CopySheet

Tindakan ini menyalin sheet ke folder, direktori utama, atau ruang kerja.

Parameter input tindakan CopySheet

Nama parameter	Jenis data	Wajib	Deskripsi
SheetId	String	Benar	ID unik sheet yang akan disalin.
DestinationType	String	Benar	Jenis tujuan tempat sheet akan disalin. Nilai yang diterima adalah folder, rumah, atau ruang kerja.
DestinationId	String	Benar	ID unik tujuan tempat sheet akan disalin. Kolom ini wajib diisi jika DestinationType adalah folder atau ruang kerja, dan harus null jika DestinationType adalah beranda.
NewName	String	Benar	Nama lembar yang disalin yang diinginkan.
Sertakan	String	Salah	Daftar elemen sheet tambahan yang dipisahkan koma untuk disertakan dalam operasi salin. Nilai yang diterima adalah lampiran, cellLinks, data, diskusi, filter, formulir, ruleRecipients, aturan, dan berbagi.

Untuk contoh cara mengonfigurasi tindakan CopySheet, lihat Contoh.

Tindakan MoveRowsToAnotherSheet

Tindakan ini memindahkan baris dari satu sheet ke sheet lainnya.

Parameter input tindakan MoveRowsToAnotherSheet

Nama parameter	Jenis data	Wajib	Deskripsi
SheetId	String	Benar	ID unik sheet tempat baris akan dipindahkan.
RowIds	String	Benar	Daftar ID baris yang dipisahkan koma untuk dipindahkan dari sheet.
DestinationSheetId	String	Benar	ID unik lembar tujuan tempat baris akan dipindahkan.

Untuk contoh cara mengonfigurasi tindakan MoveRowsToAnotherSheet, lihat Contoh.

Tindakan MoveSheet

Tindakan ini akan memindahkan sheet ke folder, direktori utama, atau ruang kerja.

Parameter input tindakan MoveSheet

Nama parameter	Jenis data	Wajib	Deskripsi
SheetId	String	Benar	ID unik sheet yang akan dipindahkan.
DestinationType	String	Benar	Jenis tujuan tempat sheet akan dipindahkan. Nilai yang diterima adalah folder, rumah, atau ruang kerja.
DestinationId	String	Benar	ID unik tujuan tempat sheet akan dipindahkan. Kolom ini wajib diisi jika DestinationType adalah folder atau ruang kerja, dan harus null jika DestinationType adalah beranda.

Untuk contoh cara mengonfigurasi tindakan MoveSheet, lihat Contoh.

Contoh tindakan

Bagian ini menunjukkan cara melakukan beberapa contoh tindakan di konektor ini.

Contoh - Mendownload lampiran

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan DownloadAttachment, lalu klik Selesai.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
{
  "SheetId": "5141926996037508",
  "AttachmentID": "1667587811610500"
}
```

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

 [
  {
    "Success": "true",
    "URL": "https://s3.amazonaws.com/SmartsheetB1/37540b4438a6466a973d678484c1fac8?response-content-disposition=attachment%3Bfilename%3D%22TestGOOGLE3.txt%22%3Bfilename*%3DUTF-8%27%27TestGOOGLE3.txt&Signature=rVHv4loce%2BrL4lYPlteTgAmkB%2Bk%3D&Expires=1744826533&AWSAccessKeyId=11950YFEZZJFSSKKB3G2",
    "Content": "VGhpcyBpcyBhIHRlc3QgYXR0YWNobWVudC4="
  }
]

Contoh - Menghapus lampiran

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan DeleteAttachment, lalu klik Selesai.
Di bagian Pemeta data pada Tugas, klik editor Open Data Mapping, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
{
  "SheetId": "5141926996037508",
  "AttachmentID": "1667587811610500"
}
```

Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas konektor:

[
  {
    "Success": "true",
  }
]

Contoh - Menyalin baris ke sheet lain

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan CopyRowsToAnotherSheet, lalu klik Selesai.
Di bagian Pemeta data pada Tugas, klik editor Open Data Mapping, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
  {
  "SheetId": "7483321975000964",
  "RowIds": "7935781927128964",
  "DestinationSheetId": "7197099985686404"
}
```

Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas konektor:

 [
  {
  "Success": "true",
	"AffectedRows":"1"
  }
]

Contoh - Menyalin sheet

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan CopySheet, lalu klik Selesai.

Di bagian Pemeta data pada Tugas, klik editor Open Data Mapping, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

{
  "SheetId": "5141926996037508",
  "DestinationType": "workspace",
  "DestinationId": "4219254305253252",
  "NewName": "Copied sheet appears",
  "Include": "comments"
}

Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas konektor:

[
  {
    "Success": "true",
  }
]

Contoh - Memindahkan baris ke sheet lain

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan MoveRowsToAnotherSheet, lalu klik Selesai.
Di bagian Pemeta data pada Tugas, klik editor Open Data Mapping, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
{
  "SheetId": "7483321975000964",
  "RowIds": "7935781927128964",
  "DestinationSheetId": "7197099985686404"
}
```

Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas Connector:

[
  {
  "Success": "true",
	"AffectedRows":"1"
  }
]

Contoh - Memindahkan sheet

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan MoveSheet, lalu klik Selesai.
Di bagian Pemeta data pada Tugas, klik editor Open Data Mapping, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
{
  "SheetId": "5141926996037508",
  "DestinationType": "workspace",
  "DestinationId": "4219254305253252"
}
```

Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas konektor:

[
  {
    "Success": "true",
  }
]

Contoh operasi entity

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

Contoh - Mencantumkan semua kolom sheet

Dalam dialog Configure connector task, klik Entities.
Pilih Info_Columns dari daftar Entity.
Pilih operasi List, lalu klik Selesai.
Di bagian Input Tugas pada tugas Konektor, Anda dapat menetapkan filterClause sesuai dengan persyaratan pelanggan.

Anda harus menggunakan tanda kutip tunggal (') untuk menyertakan nilai untuk klausa filter. Anda dapat menggunakan filterClause untuk memfilter rekaman berdasarkan kolom.

Contoh - Mendapatkan detail kolom sheet

Dalam dialog Configure connector task, klik Entities.
Pilih Info_Columns dari daftar Entity.
Pilih operasi Get, lalu klik Selesai.
Tetapkan entityId ke "849633317179268" yang merupakan kunci yang akan diteruskan. Untuk menyetel entityId, di bagian Pemeta Data pada Pemetaan Data, klik Buka Editor Pemetaan Data, lalu masukkan "849633317179268" di kolom Nilai Input dan pilih entityId sebagai variabel lokal.

Nilai entityId harus diteruskan secara langsung, seperti "849633317179268". Di sini, "849633317179268" adalah nilai kunci utama unik, yang harus diteruskan

Dalam beberapa kasus, meneruskan entityId dapat memunculkan error karena dua kunci komposit. Dalam kasus seperti itu, Anda dapat menggunakan filterClause dan meneruskan nilai, seperti id='849633317179268'.

Contoh - Menghapus baris dari sheet

Dalam dialog Configure connector task, klik Entities.
Pilih Sheet_Team_Task_List_by_Priority dari daftar Entity.
Pilih operasi Delete, lalu klik Selesai.
Tetapkan entityId ke "849633317179268" yang merupakan kunci yang akan diteruskan. Untuk menyetel entityId, di bagian Pemeta Data pada Pemetaan Data, klik Buka Editor Pemetaan Data, lalu masukkan "849633317179268" di kolom Nilai Input dan pilih entityId sebagai variabel lokal.

Jika entity memiliki dua kunci bisnis gabungan atau kunci utama, bukan menentukan entityId, Anda juga dapat menyetel filterClause ke id='849633317179268'.

Contoh - Membuat lampiran ke sheet

Dalam dialog Configure connector task, klik Entities.
Pilih Info_Attachments dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta data pada Tugas, klik editor Open Data Mapping, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value:
```
{
  "SheetId": "5141926996037508",
  "RowId": "8196592918597508",
  "Name": "Random.txt",
  "ContentEncoded": "VGhpcyBpcyBhIHRlc3QgYXR0YWNobWVudC4="
}
```
Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas konektor:
```
{"Id": "7144235189178244" }
```

Contoh - Buat project dalam baris dengan tenggat waktu tetap menggunakan tata letak gaya Gantt

Dalam dialog Configure connector task, klik Entities.
Pilih Sheet_Gantt_Project_with_Hard_Deadline dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta data pada Tugas, klik editor Open Data Mapping, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value:
```
{"Task Name": "Created from googlecloud"}
```
Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas konektor:
```
{"RowId": "7860088629366660"}
```

Contoh - Membuat tugas tim di baris sheet

Dalam dialog Configure connector task, klik Entities.
Pilih Sheet_Team_Task_List_by_Priority dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta data pada Tugas, klik editor Open Data Mapping, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value:
```
{"Task Name": "Created from googlecloud"}
```
Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas konektor:
```
{"RowId": "7860088629366660"}
```

Contoh - Membuat aktivitas penjualan di baris sheet

Dalam dialog Configure connector task, klik Entities.
Pilih Sheet_Sales_Activity_Tracking_by_Rep_Month dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta data pada Tugas, klik editor Open Data Mapping, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value:
```
{"Task Name": "Created from googlecloud"}
```
Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas konektor:
```
{"RowId": "7860088629366660"}
```

Contoh - Membuat peluang penjualan di baris spreadsheet

Dalam dialog Configure connector task, klik Entities.
Pilih Sheet_Simple_Sales_Pipeline dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta data pada Tugas, klik editor Open Data Mapping, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value:
```
{"Task Name": "Created from googlecloud"}
```
Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas konektor:
```
{"RowId": "7860088629366660" }
```

Contoh - Membuat laporan penjualan dalam baris sheet

Dalam dialog Configure connector task, klik Entities.
Pilih Report_Sales_Activity_And_Team_Objectives dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta data pada Tugas, klik editor Open Data Mapping, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value:
```
{"Task Name": "Created from googlecloud"}
```
Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas konektor:
```
{"RowId": "7860088629366660" }
```

Contoh - Membuat pesanan dalam baris sheet

Dalam dialog Configure connector task, klik Entities.
Pilih Sheet_Customer_Order_Tracking_History dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta data pada Tugas, klik editor Open Data Mapping, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value:
```
{"Task Name": "Created from googlecloud"}
```
Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas konektor:
```
{"RowId": "7860088629366660" }
```

Contoh - Membuat kolom baru di spreadsheet

Dalam dialog Configure connector task, klik Entities.
Pilih Info_Columns dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta data pada Tugas, klik editor Open Data Mapping, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value:
```
{
  "SheetId": "3315287605596036",
  "Title": "newexposedcolumn",
  "Index": 2,
  "Type": "DATE"
}
```
Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas Connector:
```
{
  "Id": "550917885349764"
}
```

Contoh - Membuat folder baru di ruang kerja

Dalam dialog Configure connector task, klik Entities.
Pilih Info_Folders dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta data pada Tugas, klik editor Open Data Mapping, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value:
```
{
  "ParentFolderId": "8716915511191428",
  "Name": "sub-folder-p2"
}
```
Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas konektor:
```
{
  "Id": "550917885349764"
}
```

Contoh - Membuat ruang kerja baru di akun

Dalam dialog Configure connector task, klik Entities.
Pilih Info_Workspaces dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta data pada Tugas, klik editor Open Data Mapping, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value:
```
{
  "Name": "new workspace (newly exposed)"
}
```
Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas Connector:
```
{
  "Id": "550917885349764"
}
```

Contoh - Membuat pengguna baru di akun

Dalam dialog Configure connector task, klik Entities.
Pilih Info_Users dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta data pada Tugas, klik editor Open Data Mapping, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value:
```
{
  "FirstName": "charlie",
  "Email": "charlie@altostrat.com",
  "LastName": "c",
  "Admin": true,
  "LicensedSheetCreator": true
}
```
Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas konektor:
```
{
  "Id": "550917885349764"
}
```

Contoh - Memperbarui detail project dalam spreadsheet

Dalam dialog Configure connector task, klik Entities.
Pilih Sheet_Gantt_Project_with_Hard_Deadline dari daftar Entity.
Pilih operasi Update, lalu klik Selesai.
Tetapkan entityId di bagian Data mapper pada Tasks, klik entityId, lalu masukkan 849633317179268 di kolom yang tersedia.
Di bagian Pemeta data pada Tugas, klik editor Open Data Mapping, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value:
```
 {"Task Name": "updated from googlecloud"}
```

Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas konektor:

{
  "RowId": null
}

Contoh - Memperbarui tugas tim di spreadsheet

Dalam dialog Configure connector task, klik Entities.
Pilih Sheet_Team_Task_List_by_Priority dari daftar Entity.
Pilih operasi Update, lalu klik Selesai.
Tetapkan entityId di bagian Data mapper pada Tasks, klik entityId, lalu masukkan 849633317179268 di kolom yang tersedia.
Di bagian Pemeta data pada Tugas, klik editor Open Data Mapping, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value:
```
{"Task Name": "updated from googlecloud"}
```

Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas konektor:

{
  "RowId": null
}

Contoh - Memperbarui aktivitas penjualan dalam spreadsheet

Dalam dialog Configure connector task, klik Entities.
Pilih Sheet_Sales_Activity_Tracking_by_Rep_Month dari daftar Entity.
Pilih operasi Update, lalu klik Selesai.
Tetapkan entityId di bagian Pemeta data pada Tugas, klik entityId, lalu masukkan 849633317179268 di kolom yang diberikan.
Di bagian Pemeta data pada Tugas, klik editor Open Data Mapping, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value:
```
 {"Task Name": "updated from googlecloud"}
```

Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas konektor:

{
  "RowId": null
}

Contoh - Memperbarui peluang penjualan dalam spreadsheet

Dalam dialog Configure connector task, klik Entities.
Pilih Sheet_Simple_Sales_Pipeline dari daftar Entity.
Pilih operasi Update, lalu klik Selesai.
Tetapkan entityId di bagian Pemeta data pada Tugas, klik entityId, lalu masukkan 849633317179268 di kolom yang diberikan.
Di bagian Pemeta data pada Tugas, klik editor Open Data Mapping, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value:
```
{"Task Name": "updated from googlecloud"}
```

Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas konektor:

{
  "RowId": null
}

Contoh - Memperbarui laporan penjualan dalam spreadsheet

Dalam dialog Configure connector task, klik Entities.
Pilih Report_Sales_Activity_And_Team_Objectives dari daftar Entity.
Pilih operasi Update, lalu klik Selesai.
Tetapkan entityId di bagian Pemeta data pada Tugas, klik entityId, lalu masukkan 849633317179268 di kolom yang diberikan.
Di bagian Pemeta data pada Tugas, klik editor Open Data Mapping, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value:
```
{"Task Name": "updated from googlecloud"}
```

Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas konektor:

{
  "RowId": null
}

Contoh - Memperbarui pesanan dalam sheet

Dalam dialog Configure connector task, klik Entities.
Pilih Sheet_Customer_Order_Tracking_History dari daftar Entity.
Pilih operasi Update, lalu klik Selesai.
Tetapkan entityId di bagian Pemeta data pada Tugas, klik entityId, lalu masukkan 849633317179268 di kolom yang diberikan.
Di bagian Pemeta data pada Tugas, klik editor Open Data Mapping, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value:
```
{"Task Name": "updated from googlecloud"}
```

Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas konektor:

{
  "RowId": null
}

Mendapatkan bantuan dari komunitas Google Cloud

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

Langkah berikutnya

Pahami cara menangguhkan dan melanjutkan koneksi.
Pahami cara memantau penggunaan konektor.
Pahami cara melihat log konektor.