Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menghubungkan ke HubSpot
HubSpotPlatform CRM memiliki semua alat dan integrasi yang Anda butuhkan untuk pemasaran, penjualan, manajemen konten, dan layanan pelanggan.
+ Marketing Hub - Perangkat lunak pemasaran untuk membantu Anda meningkatkan lalu lintas, mengonversi lebih banyak pengunjung, dan menjalankan kampanye pemasaran masuk lengkap dalam skala besar.
+ Sales Hub - Perangkat lunak CRM Penjualan untuk membantu Anda mendapatkan wawasan yang lebih dalam tentang prospek, mengotomatiskan tugas yang Anda miliki, dan menutup lebih banyak transaksi lebih cepat.
+ Service Hub - Perangkat lunak layanan pelanggan untuk membantu Anda terhubung dengan pelanggan, melebihi harapan, dan mengubahnya menjadi promotor yang mengembangkan bisnis Anda.
+ Operations Hub - Perangkat lunak operasi yang menyinkronkan aplikasi Anda, membersihkan dan membuat data pelanggan, dan mengotomatiskan proses - sehingga semua sistem dan tim Anda bekerja sama dengan lebih baik.
**Topics**
+ [AWS Glue dukungan untuk HubSpot](hubspot-support.md)
+ [Kebijakan yang berisi operasi API untuk membuat dan menggunakan koneksi](hubspot-configuring-iam-permissions.md)
+ [Mengkonfigurasi HubSpot](hubspot-configuring.md)
+ [Mengkonfigurasi koneksi HubSpot](hubspot-configuring-connections.md)
+ [Membaca dari HubSpot entitas](hubspot-reading-from-entities.md)
+ [Menulis ke HubSpot Entitas](hubspot-writing-to-entities.md)
+ [HubSpot opsi koneksi](hubspot-connection-options.md)
+ [Keterbatasan dan catatan untuk HubSpot konektor](hubspot-connector-limitations.md)
# AWS Glue dukungan untuk HubSpot
AWS Glue mendukung HubSpot sebagai berikut:
**Didukung sebagai sumber?**
Ya — Sinkronisasi dan Async. Anda dapat menggunakan pekerjaan AWS Glue ETL untuk meminta data dari HubSpot.
**Didukung sebagai target?**
Ya. Anda dapat menggunakan pekerjaan AWS Glue ETL untuk menulis data. HubSpot
**Versi HubSpot API yang didukung**
Versi HubSpot API berikut didukung:
+ v1
+ v2
+ v3
+ v4
Untuk dukungan entitas per versi tertentu, lihat [Entitas yang didukung untuk sumber Sinkronisasi](hubspot-reading-from-entities.md#sync-table) dan[Entitas yang didukung untuk sumber Async](hubspot-reading-from-entities.md#async-table).
# Kebijakan yang berisi operasi API untuk membuat dan menggunakan koneksi
Kebijakan contoh berikut menjelaskan izin AWS IAM yang diperlukan untuk membuat dan menggunakan koneksi. Jika Anda membuat peran baru, buat kebijakan yang berisi hal-hal berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"glue:ListConnectionTypes",
"glue:DescribeConnectionType",
"glue:RefreshOAuth2Tokens",
"glue:ListEntities",
"glue:DescribeEntity"
],
"Resource": "*"
}
]
}
```
------
Jika Anda tidak ingin menggunakan metode di atas, gunakan kebijakan IAM terkelola berikut ini:
+ [AWSGlueServiceRole](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Memberikan akses ke sumber daya yang diperlukan berbagai AWS Glue proses untuk dijalankan atas nama Anda. Sumber daya ini termasuk AWS Glue, Amazon S3, IAM, CloudWatch Log, dan Amazon. EC2 Jika Anda mengikuti konvensi penamaan untuk sumber daya yang ditentukan dalam kebijakan ini, AWS Glue proses memiliki izin yang diperlukan. Kebijakan ini biasanya dilampirkan pada peran yang ditentukan saat menentukan crawler, tugas, dan titik akhir pengembangan.
+ [AWSGlueConsoleFullAccess](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Memberikan akses penuh ke AWS Glue sumber daya saat identitas yang dilampirkan kebijakan menggunakan Konsol AWS Manajemen. Jika Anda mengikuti konvensi penamaan untuk sumber daya yang ditentukan dalam kebijakan ini, maka pengguna memiliki kemampuan konsol penuh. Kebijakan ini biasanya dilampirkan ke pengguna AWS Glue konsol.
# Mengkonfigurasi HubSpot
Sebelum Anda dapat menggunakan AWS Glue untuk mentransfer data dari HubSpot, Anda harus memenuhi persyaratan ini:
## Persyaratan minimum
Berikut ini adalah persyaratan minimum:
+ Anda memiliki HubSpot akun. Untuk informasi selengkapnya, lihat [Membuat HubSpot akun](#hubspot-configuring-creating-hubspot-account).
+ HubSpot Akun Anda diaktifkan untuk akses API.
+ Anda harus memiliki aplikasi di bawah akun HubSpot pengembang Anda yang menyediakan kredensyal klien yang AWS Glue digunakan untuk mengakses data Anda dengan aman saat melakukan panggilan terautentikasi ke akun Anda. Untuk informasi selengkapnya, lihat [Membuat aplikasi HubSpot pengembang](#hubspot-configuring-creating-hubspot-developer-app).
Jika memenuhi persyaratan ini, Anda siap untuk terhubung AWS Glue ke HubSpot akun Anda. Untuk koneksi tipikal, Anda tidak perlu melakukan hal lain HubSpot.
## Membuat HubSpot akun
Untuk membuat HubSpot akun:
1. Pergi ke [ SignUp URL HubSpot CRM](https://app.hubspot.com/login).
1. Masukkan alamat email Anda dan pilih **Verifikasi email** (sebagai alternatif, Anda dapat memilih untuk mendaftar dengan akun Google, Microsoft, atau Apple).
1. Periksa kotak masuk Anda untuk kode verifikasi dari HubSpot.
1. Masukkan kode verifikasi 6 digit dan klik **Berikutnya**.
1. Masukkan kata sandi dan klik **Berikutnya**.
1. Masukkan nama depan dan nama belakang Anda dan klik **Berikutnya**, atau daftar menggunakan tautan **Daftar dengan Google**.
1. Masuk ke industri Anda dan klik **Berikutnya**.
1. Masukkan peran pekerjaan Anda dan klik **Berikutnya**.
1. Masukkan nama perusahaan Anda dan klik **Berikutnya**.
1. Pilih ukuran perusahaan Anda (jumlah karyawan yang bekerja di perusahaan Anda) dan klik **Berikutnya**.
1. Masukkan situs web perusahaan Anda dan klik **Berikutnya**.
1. Pilih di mana data Anda harus di-host (Amerika Serikat atau Eropa) dan **klik Buat** Akun.
1. Pilih tujuan pembuatan akun Anda dan klik **Berikutnya**.
1. Pilih **Connect Google Account** atau pilih untuk menambahkan kontak sendiri untuk menautkan kontak Anda dengan HubSpot akun Anda.
1. Masuk ke akun Google Anda jika Anda memilih opsi **Connect Google Account** untuk menautkan kontak Anda dan mulai menggunakan HubSpot akun Anda.
## Membuat aplikasi HubSpot pengembang
Akun pengembang aplikasi ditujukan untuk membuat dan mengelola aplikasi, integrasi, dan akun pengujian pengembang. Mereka juga tempat Anda dapat membuat dan mengelola daftar App Marketplace. Namun, akun pengembang aplikasi dan akun pengujian terkait tidak terhubung ke HubSpot akun standar. Mereka tidak dapat menyinkronkan data atau aset ke atau dari HubSpot akun lain. Untuk mendapatkan ID Klien dan Rahasia Klien, Anda membuat akun pengembang.
1. Pergi ke https://developers.hubspot.com/
1. Pilih **Buat akun pengembang** dan gulir ke bawah.
1. Anda akan ditanya apakah Anda ingin membuat akun pengembang Aplikasi, akun Aplikasi Pribadi, atau akun CMS Developer Sandbox. Pilih **Buat akun pengembang Aplikasi**.
1. Karena Anda sudah membuat Akun dengan HubSpot, Anda dapat memilih **Lanjutkan dengan pengguna ini**.
1. Klik **Mulai mendaftar.**
1. Masukkan Job Role Anda dan klik **Next**.
1. Beri nama akun pengembang Anda dan klik **Berikutnya**, lalu **Lewati**.
1. Pilih **Buat Aplikasi**.
1. Setelah Aplikasi Anda dibuat, pilih **Auth**.
1. Di bawah Auth, catat ID Klien dan Rahasia Klien.
1. Tambahkan **URL Pengalihan** khusus wilayah Anda sebagai https: *//* .console.aws.amazon. com/gluestudio/oauth. For example, add https://us-east-1.console.aws.amazon.com/gluestudio/oauthuntuk wilayah us-east-1.
1. Gulir ke bawah dan temukan cakupan. Ada dua jenis cakupan yang harus Anda pilih di bawah judul “CRM” dan “Standar”.
1. Tambahkan cakupan berikut:
```
content
automation
oauth
crm.objects.owners.read
forms
tickets
crm.objects.contacts.write
e-commerce
crm.schemas.custom.read
crm.objects.custom.read
sales-email-read
crm.objects.custom.write
crm.objects.companies.write
crm.lists.write
crm.objects.companies.read
crm.lists.read
crm.objects.deals.read
crm.objects.deals.write
crm.objects.contacts.read
```
1. Klik **Simpan** dan akun dev Anda sekarang siap digunakan.
1. Gulir ke atas untuk menemukan **ID Klien**.
1. Pada halaman yang sama, klik **Tampilkan** untuk mendapatkan **rahasia Klien**.
## Membuat akun pengujian HubSpot pengembang
Dalam akun pengembang aplikasi, Anda dapat membuat akun pengujian pengembang untuk menguji aplikasi dan integrasi tanpa memengaruhi HubSpot data nyata apa pun. Akun pengujian pengembang tidak mencerminkan akun produksi, melainkan memiliki akses ke uji coba 90 hari dari versi Enterprise dari Marketing, Sales, Service, CMS, dan Operations Hub, menyediakan kemampuan untuk menguji sebagian besar HubSpot alat dan. APIs
1. Klik **Beranda**.
1. Klik **Buat akun uji**.
1. Klik **Buat Akun Uji Aplikasi**.
1. Jendela baru muncul. Masukkan nama akun uji aplikasi dan klik **Buat**.
Akun pengujian aplikasi Anda sekarang dibuat.
**catatan**
Akun pengembang terkait dengan aktivitas pengembangan seperti integrasi API, dan akun pengujian aplikasi digunakan untuk melihat data yang dibuat atau ditarik oleh akun pengembang.
# Mengkonfigurasi koneksi HubSpot
HubSpot mendukung jenis hibah AUTHORIZATION\$1CODE untuk. OAuth2
+ Jenis hibah ini dianggap “berkaki tiga” OAuth karena bergantung pada pengalihan pengguna ke server otorisasi pihak ketiga untuk mengautentikasi pengguna. Ini digunakan saat membuat koneksi melalui AWS Glue konsol. Pengguna yang membuat koneksi perlu memberikan informasi OAuth terkait seperti Client ID dan Client Secret untuk aplikasi HubSpot klien mereka. AWS Glue Konsol akan mengarahkan pengguna ke HubSpot tempat pengguna harus masuk dan mengizinkan izin AWS Glue yang diminta untuk mengakses instance mereka HubSpot .
+ Pengguna masih dapat memilih untuk membuat aplikasi terhubung mereka sendiri HubSpot dan memberikan id klien dan rahasia klien mereka sendiri saat membuat koneksi melalui AWS Glue konsol. Dalam skenario ini, mereka masih akan diarahkan ke login dan memberi wewenang HubSpot AWS Glue untuk mengakses sumber daya mereka.
+ Jenis hibah ini menghasilkan token penyegaran dan token akses. Token akses berumur pendek, dan dapat disegarkan secara otomatis tanpa interaksi pengguna menggunakan token penyegaran.
+ Untuk HubSpot dokumentasi publik tentang cara membuat aplikasi yang terhubung untuk OAuth alur Kode Otorisasi, lihat [Aplikasi publik](https://developers.hubspot.com/docs/api/creating-an-app).
Untuk mengkonfigurasi HubSpot koneksi:
1. Di AWS Secrets Manager, buat rahasia dengan detail berikut:
1. Untuk aplikasi terhubung yang dikelola pelanggan, Rahasia harus berisi aplikasi yang terhubung Rahasia Konsumen dengan kunci `USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` sebagai.
1. Catatan: Anda harus membuat rahasia untuk koneksi di AWS Glue.
1. Di AWS Glue Glue Studio, buat koneksi di bawah **Koneksi Data** dengan mengikuti langkah-langkah di bawah ini:
1. Saat memilih **jenis Koneksi**, pilih HubSpot.
1. Menyediakan HubSpot lingkungan.
1. Pilih peran AWS IAM yang AWS Glue dapat mengasumsikan dan memiliki izin untuk tindakan berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:DescribeSecret",
"secretsmanager:GetSecretValue",
"secretsmanager:PutSecretValue",
"ec2:CreateNetworkInterface",
"ec2:DescribeNetworkInterfaces",
"ec2:DeleteNetworkInterface"
],
"Resource": "*"
}
]
}
```
------
1. Pilih `secretName` yang ingin Anda gunakan untuk koneksi ini AWS Glue untuk memasukkan token.
1. Pilih opsi jaringan jika Anda ingin menggunakan jaringan Anda.
1. Berikan peran IAM yang terkait dengan izin AWS Glue pekerjaan Anda untuk membaca`secretName`.
1. Dalam konfigurasi AWS Glue pekerjaan Anda, berikan `connectionName` sebagai **koneksi jaringan tambahan**.
# Membaca dari HubSpot entitas
**Prasyarat**
HubSpot Objek yang ingin Anda baca. Anda akan memerlukan nama objek seperti kontak atau tugas. Tabel berikut menunjukkan entitas yang didukung untuk sumber Sync.
## Entitas yang didukung untuk sumber Sinkronisasi
| Entitas | Versi API | Dapat disaring | Mendukung batas | Mendukung Pesanan oleh | Mendukung Pilih \$1 | Mendukung partioning |
| --- | --- | --- | --- | --- | --- | --- |
| Kampanye | v1 | Tidak | Ya | Tidak | Ya | Tidak |
| Perusahaan | v3 | Ya | Ya | Ya | Ya | Ya |
| Kontak | v3 | Ya | Ya | Ya | Ya | Ya |
| Daftar Kontak | v1 | Tidak | Ya | Tidak | Ya | Tidak |
| Penawaran | v3 | Ya | Ya | Ya | Ya | Ya |
| Pipa CRM (Saluran Pipa Kesepakatan) | v1 | Tidak | Tidak | Tidak | Ya | Tidak |
| Acara Email | v1 | Tidak | Ya | Tidak | Ya | Tidak |
| Panggilan | v3 | Ya | Ya | Ya | Ya | Ya |
| Catatan | v3 | Ya | Ya | Ya | Ya | Ya |
| Email | v3 | Ya | Ya | Ya | Ya | Ya |
| Rapat | v3 | Ya | Ya | Ya | Ya | Ya |
| Tugas | v3 | Ya | Ya | Ya | Ya | Ya |
| Surat Pos | v3 | Ya | Ya | Ya | Ya | Ya |
| Objek Kustom | v3 | Ya | Ya | Ya | Ya | Ya |
| Formulir | v2 | Tidak | Tidak | Tidak | Ya | Tidak |
| Pemilik | v3 | Tidak | Ya | Tidak | Ya | Tidak |
| Produk | v3 | Ya | Ya | Ya | Ya | Ya |
| Tiket | v3 | Ya | Ya | Ya | Ya | Ya |
| Alur kerja | v3 | Tidak | Tidak | Tidak | Ya | Tidak |
| Asosiasi | v4 | Ya | Tidak | Tidak | Ya | Tidak |
| Label Asosiasi | v4 | Tidak | Tidak | Tidak | Ya | Tidak |
**Contoh:**
```
hubspot_read = glueContext.create_dynamic_frame.from_options(
connection_type="hubspot",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "contact",
"API_VERSION": "v3"
}
```
## Entitas yang didukung untuk sumber Async
| Entitas | Versi API | Dapat disaring | Mendukung batas | Mendukung Pesanan oleh | Mendukung Pilih \$1 | Mendukung partioning |
| --- | --- | --- | --- | --- | --- | --- |
| Perusahaan | v3 | Ya | Tidak | Ya | Ya | Tidak |
| Kontak | v3 | Ya | Tidak | Ya | Ya | Tidak |
| Penawaran | v3 | Ya | Tidak | Ya | Ya | Tidak |
| Panggilan | v3 | Ya | Tidak | Ya | Ya | Tidak |
| Catatan | v3 | Ya | Tidak | Ya | Ya | Tidak |
| Email | v3 | Ya | Tidak | Ya | Ya | Tidak |
| Rapat | v3 | Ya | Tidak | Ya | Ya | Tidak |
| Tugas | v3 | Ya | Tidak | Ya | Ya | Tidak |
| Surat Pos | v3 | Ya | Tidak | Ya | Ya | Tidak |
| Objek Kustom | v3 | Ya | Tidak | Ya | Ya | Tidak |
| Produk | v3 | Ya | Tidak | Ya | Ya | Tidak |
| Tiket | v3 | Ya | Tidak | Ya | Ya | Tidak |
**Contoh:**
```
hubspot_read = glueContext.create_dynamic_frame.from_options(
connection_type="hubspot",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "contact",
"API_VERSION": "v3",
"TRANSFER_MODE": "ASYNC"
}
```
**HubSpot detail entitas dan bidang**:
**HubSpot API v4**:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/hubspot-reading-from-entities.html)
**catatan**
Untuk `Associations` objek, untuk mengambil asosiasi antara dua objek, Anda perlu memberikan 'dari Id' (ID objek pertama) melalui filter wajib saat membuat pekerjaan. AWS Glue Jika Anda ingin mengambil asosiasi untuk beberapa dari IDs dalam kasus itu, Anda harus memberikan beberapa IDs dalam `where` klausa. Misalnya: untuk mengambil kontak `Associations` IDs '1' dan '151', Anda perlu memberikan filter sebagai. `where id=1 AND id=151`
**HubSpot API v3**:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/hubspot-reading-from-entities.html)
Untuk entitas berikut, HubSpot sediakan titik akhir untuk mengambil metadata secara dinamis, sehingga dukungan operator ditangkap pada tingkat tipe data untuk setiap entitas.
**catatan**
`DML_STATUS`adalah bidang virtual yang ditambahkan pada setiap catatan saat runtime untuk menentukan statusnya (DIBUAT/DIPERBARUI) dalam mode Sinkronisasi. `CONTAINS/LIKE`Operator tidak didukung dalam mode Async.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/hubspot-reading-from-entities.html)
**HubSpot API v2**:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/hubspot-reading-from-entities.html)
**HubSpot API v1:**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/hubspot-reading-from-entities.html)
## Mempartisi kueri
Anda dapat memberikan opsi Spark tambahan`PARTITION_FIELD`,, `LOWER_BOUND``UPPER_BOUND`, dan `NUM_PARTITIONS` jika Anda ingin memanfaatkan konkurensi di Spark. Dengan parameter ini, kueri asli akan dibagi menjadi `NUM_PARTITIONS` sejumlah sub-kueri yang dapat dijalankan oleh tugas Spark secara bersamaan.
+ `PARTITION_FIELD`: nama bidang yang akan digunakan untuk mempartisi kueri.
+ `LOWER_BOUND`: nilai batas bawah **inklusif** dari bidang partisi yang dipilih.
Untuk DateTime bidang, kami menerima nilai dalam format ISO.
Contoh nilai valid:
```
“2024-01-01T10:00:00.115Z"
```
+ `UPPER_BOUND`: nilai batas atas **eksklusif** dari bidang partisi yang dipilih.
+ `NUM_PARTITIONS`: jumlah partisi.
Tabel berikut menjelaskan rincian dukungan bidang partisi entitas:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/hubspot-reading-from-entities.html)
Contoh:
```
hubspot_read = glueContext.create_dynamic_frame.from_options(
connection_type="hubspot",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "company",
"API_VERSION": "v3",
"PARTITION_FIELD": "hs_object_id"
"LOWER_BOUND": "50"
"UPPER_BOUND": "16726619290"
"NUM_PARTITIONS": "10"
}
```
# Menulis ke HubSpot Entitas
## Prasyarat
+ HubSpot Objek yang ingin Anda tulis. Anda akan memerlukan nama objek seperti kontak atau tiket.
+ HubSpot Konektor mendukung operasi penulisan berikut:
+ INSERT
+ UPDATE
+ Saat menggunakan operasi `UPDATE` tulis, `ID_FIELD_NAMES` opsi harus disediakan untuk menentukan bidang ID untuk catatan.
## Entitas yang didukung untuk Tujuan Sinkronisasi
| Entitas | Versi API | Akan didukung sebagai Konektor Tujuan | Dapat Dimasukkan | Dapat Diperbarui |
| --- | --- | --- | --- | --- |
| Perusahaan | v3 | Ya | Ya (Tunggal, Massal) | Ya (Tunggal, Massal) |
| Kontak | v3 | Ya | Ya (Tunggal, Massal) | Ya (Tunggal, Massal) |
| Penawaran | v3 | Ya | Ya (Tunggal, Massal) | Ya (Tunggal, Massal) |
| Produk | v3 | Ya | Ya (Tunggal, Massal) | Ya (Tunggal, Massal) |
| Panggilan | v3 | Ya | Ya (Tunggal, Massal) | Ya (Tunggal, Massal) |
| Rapat | v3 | Ya | Ya (Tunggal, Massal) | Ya (Tunggal, Massal) |
| Catatan | v3 | Ya | Ya (Tunggal, Massal) | Ya (Tunggal, Massal) |
| Email | v3 | Ya | Ya (Tunggal, Massal) | Ya (Tunggal, Massal) |
| Tugas | v3 | Ya | Ya (Tunggal, Massal) | Ya (Tunggal, Massal) |
| Surat Pos | v3 | Ya | Ya (Tunggal, Massal) | Ya (Tunggal, Massal) |
| Objek Kustom | v3 | Ya | Ya (Tunggal, Massal) | Ya (Tunggal, Massal) |
| Tiket | v3 | Ya | Ya (Tunggal, Massal) | Ya (Tunggal, Massal) |
| Asosiasi | v4 | Ya | Ya (Tunggal, Massal) | Tidak |
| Label Asosiasi | v4 | Ya | Ya (Tunggal, Massal) | Ya (Tunggal, Massal) |
**Contoh:**
**Operasi INSERT**
```
hubspot_write = glueContext.write_dynamic_frame.from_options(
frame=frameToWrite,
connection_type="hubspot",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "contact",
"API_VERSION": "v3",
"WRITE_OPERATION": "INSERT"
}
)
```
**UPDATE Operasi**
```
hubspot_write = glueContext.write_dynamic_frame.from_options(
frame=frameToWrite,
connection_type="hubspot",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "deal",
"API_VERSION": "v3",
"WRITE_OPERATION": "UPDATE",
"ID_FIELD_NAMES": "hs_object_id"
}
)
```
# HubSpot opsi koneksi
Berikut ini adalah opsi koneksi untuk HubSpot:
+ `ENTITY_NAME`(String) - (Diperlukan) Digunakan untuk Baca. Nama objek Anda di HubSpot.
+ `API_VERSION`(String) - (Diperlukan) Digunakan untuk Baca. HubSpot Rest versi API yang ingin Anda gunakan. Misalnya: v1, v2, v3, v4.
+ `SELECTED_FIELDS`(Daftar) - Default: kosong (SELECT \$1). Digunakan untuk Baca. Kolom yang ingin Anda pilih untuk objek.
+ `FILTER_PREDICATE`(String) - Default: kosong. Digunakan untuk Baca. Itu harus dalam format Spark SQL.
+ `QUERY`(String) - Default: kosong. Digunakan untuk Baca. Kueri SQL Spark penuh.
+ `PARTITION_FIELD`(String) - Digunakan untuk Baca. Bidang yang akan digunakan untuk mempartisi kueri.
+ `LOWER_BOUND`(String) - Digunakan untuk Baca. Nilai batas bawah inklusif dari bidang partisi yang dipilih.
+ `UPPER_BOUND`(String) - Digunakan untuk Baca. Nilai batas atas eksklusif dari bidang partisi yang dipilih.
+ `NUM_PARTITIONS`(Integer) - Default: 1. Digunakan untuk Baca. Jumlah partisi untuk dibaca.
+ `TRANSFER_MODE`(String) - Digunakan untuk menunjukkan apakah query harus dijalankan pada modus Async.
+ `WRITE_OPERATION`(String) - Default: SISIPKAN. Digunakan untuk menulis. Nilai harus INSERT atau UPDATE.
+ `ID_FIELD_NAMES`(String) - Default: null. Diperlukan untuk UPDATE.
# Keterbatasan dan catatan untuk HubSpot konektor
Berikut ini adalah batasan atau catatan untuk HubSpot konektor:
+ Titik akhir pencarian dibatasi hingga 10.000 total hasil untuk setiap kueri yang diberikan. Setiap partisi yang memiliki lebih dari 10.000 catatan akan menghasilkan kesalahan 400.
+ Keterbatasan penting lainnya untuk konektor dijelaskan dalam [Batasan](https://developers.hubspot.com/docs/api/crm/search#limitations).
+ Maksimal tiga pernyataan penyaringan diterima oleh HubSpot.
+ Saat ini, HubSpot mendukung Asosiasi antara HubSpot objek standar (misalnya kontak, perusahaan, kesepakatan, atau tiket) dan objek khusus.
+ Untuk akun Gratis: Anda hanya dapat membuat hingga 10 jenis asosiasi antara setiap pasangan objek (misalnya kontak dan perusahaan).
+ Untuk akun Super Admin: Anda hanya dapat membuat hingga 50 jenis asosiasi antara setiap pasangan objek.
+ Untuk informasi selengkapnya, lihat [Asosiasi v4](https://developers.hubspot.com/docs/api/crm/) serta [Membuat dan menggunakan label asosiasi](https://knowledge.hubspot.com/object-settings/create-and-use-association-labels).
+ Objek 'Kutipan' dan 'Komunikasi' tidak ada untuk Asosiasi karena saat ini tidak didukung di konektor.
+ Untuk Async, SaaS mengurutkan nilai dalam urutan menaik saja.
+ Untuk `Ticket` entitas, SaaS tidak mengembalikan `hs_object_id` bidang dalam mode Async.