Halaman ini diterjemahkan oleh Cloud Translation API.

Google Kalender

Versi yang didukung

Konektor ini mendukung Google Calendar REST API.

Sebelum memulai

Di project Google Cloud Anda, lakukan tugas berikut:

Pastikan konektivitas jaringan telah disiapkan. Untuk mengetahui informasi, lihat Konektivitas jaringan.
Berikan peran IAM roles/connectors.admin kepada pengguna yang mengonfigurasi konektor.
Memberikan peran IAM roles/secretmanager.viewer dan roles/secretmanager.secretAccessor ke akun layanan yang ingin Anda gunakan untuk konektor
Aktifkan secretmanager.googleapis.com (Secret Manager API) dan connectors.googleapis.com (Connectors API). Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan layanan.

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 Lokasi, selesaikan langkah-langkah berikut:
1. Region: Pilih lokasi dari menu drop-down.
  Untuk mengetahui daftar semua region yang didukung, lihat Lokasi.
2. Klik Berikutnya.
Di bagian Detail Koneksi, selesaikan langkah-langkah berikut:
1. Konektor: Pilih Google Kalender dari daftar konektor yang tersedia.
2. Versi konektor: Pilih versi konektor dari daftar versi yang tersedia.
3. Di kolom Nama Koneksi, masukkan nama untuk instance koneksi. Nama koneksi dapat berisi huruf kecil, angka, atau tanda hubung. Nama harus diawali dengan huruf dan diakhiri dengan huruf atau angka, serta tidak boleh lebih dari 49 karakter.
4. Deskripsi: 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. Waktu Tunggu Koneksi: Secara opsional, masukkan waktu tunggu koneksi dalam detik.
8. 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.
9. + TAMBAHKAN LABEL: klik ini untuk menambahkan label ke koneksi dalam bentuk pasangan nilai/kunci.
10. Klik Berikutnya.
Di bagian Authentication, masukkan detail autentikasi.
1. Pilih Jenis autentikasi dan masukkan detail yang relevan.
  Jenis autentikasi berikut didukung oleh koneksi Google Kalender:
  - Autentikasi Akun Layanan
  - OAuth 2.0 - JWT Bearer
  - OAuth 2.0 - Kode otorisasi
  Untuk memahami cara mengonfigurasi jenis autentikasi ini, lihat Mengonfigurasi autentikasi.
2. Klik Berikutnya.
Tinjau: Tinjau detail koneksi dan autentikasi Anda.
Klik Buat.

Mengonfigurasi autentikasi

Masukkan detail berdasarkan autentikasi yang ingin Anda gunakan.

Autentikasi Akun Layanan: Tidak ada konfigurasi tambahan yang diperlukan untuk jenis autentikasi ini. Akun layanan yang Anda pilih di bagian Detail Koneksi akan digunakan untuk autentikasi.
OAuth 2.0 - JWT Bearer
- Sertifikat JWT: Pilih sertifikat yang akan digunakan untuk autentikasi JWT.
- Versi secret: Masukkan versi secret sertifikat JWT.
- Subjek JWT: Masukkan subjek JWT.
OAuth 2.0 - Kode otorisasi
- Client ID: Masukkan client ID yang akan digunakan untuk autentikasi OAuth.
- Cakupan: Masukkan daftar cakupan yang diinginkan.
- Client Secret: Masukkan rahasia klien yang akan digunakan untuk autentikasi OAuth.
- Versi secret: Masukkan versi secret dari rahasia klien.

Contoh konfigurasi koneksi

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

Jenis koneksi akun layanan

Nama kolom	Detail
Lokasi	us-central1
Konektor	Google Kalender
Versi konektor	1
Nama Koneksi	service-account-auth
Mengaktifkan Cloud Logging	Ya
Akun Layanan	iam.gserviceaccount.com
Jumlah minimum node	2
Jumlah maksimum node	50
Autentikasi	Ya
Autentikasi Akun Layanan	Ya

OAuth 2.0 - Jenis koneksi pembawa JWT

Nama kolom	Detail
Lokasi	us-central1
Konektor	Google Kalender
Versi konektor	1
Nama Koneksi	jwt-bearer-auth
Mengaktifkan Cloud Logging	Ya
Akun Layanan	iam.gserviceaccount.com
Jumlah minimum node	2
Jumlah maksimum node	50
Autentikasi	Ya
OAuth 2.0 - JWT bearer	Ya
Sertifikat JWT	projects/google-cloud-project/secrets/jwt-cert/versions/1
Versi rahasia	1

OAuth 2.0 - Jenis koneksi kode otorisasi

Nama kolom	Detail
Lokasi	us-central1
Konektor	Google Kalender
Versi konektor	1
Nama Koneksi	gcpcloud-googlecalendar-rest-conn
Mengaktifkan Cloud Logging	Ya
Akun Layanan	iam.gserviceaccount.com
Jumlah minimum node	2
Jumlah maksimum node	50
Autentikasi	Ya
ID klien	60875425788659-mt0cm1tguyiagvst468fvaw7.apps.googleusercontent.com
Cakupan	https://www.googleapis.com/auth/calendar https://www.googleapis.com/auth/drive
Rahasia Klien	ygdruoX-Rtyah9gzkdZc-7CB0Eng9hyaufD0VD
Versi rahasia	1

Batasan sistem

Konektor Google Kalender dapat memproses maksimum 2 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 Google Kalender 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.

Contoh operasi entity

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

Contoh - Mencantumkan semua kalender

Dalam dialog Configure connector task, klik Entities.
Pilih Calendars 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 filterClause.

Anda dapat menggunakan filterClause untuk memfilter rekaman berdasarkan kolom.

Contoh - Mendapatkan detail kalender

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

Nilai untuk entityId harus diteruskan secara langsung, seperti "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com". Di sini, "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com" adalah nilai kunci utama unik yang harus diteruskan.

Dalam kasus tertentu, meneruskan entityId dapat memunculkan error jika entitas menggunakan dua kunci komposit. Dalam kasus seperti itu, Anda dapat menggunakan filterClause untuk meneruskan nilai, seperti id='c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com'.

Contoh - Menghapus kalender

Dalam dialog Configure connector task, klik Entities.
Pilih Calendars dari daftar Entity.
Pilih operasi Delete, lalu klik Selesai.
Tetapkan entityId ke "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com" yang merupakan kunci yang akan diteruskan. Untuk menyetel entityId, di bagian Pemeta Data pada Pemetaan Data, klik Buka Editor Pemetaan Data, lalu masukkan "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com" di kolom Nilai Input dan tetapkan entityId sebagai variabel lokal.
Jika entity memiliki dua kunci bisnis gabungan atau kunci utama, bukan menentukan entityId, Anda juga dapat menyetel filterClause ke id='c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com'.

Contoh - Membuat kalender

Dalam dialog Configure connector task, klik Entities.
Pilih Calendars dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan tetapkan connectorInputPayload sebagai variabel lokal.
```
{
  "Summary": "New calendar"
}
```
Jika integrasi berhasil, parameter respons connectorOutputPayload tugas calendar akan memiliki nilai yang mirip dengan berikut:
```
{
  "Id": "c_5bae32e1c48ed38af98efecbd6da6bb002a31e887276aa65cc2530717123b75f@group.calendar.altostrat.com"
}
```

Contoh - Membuat acara di kalender

Dalam dialog Configure connector task, klik Entities.
Pilih AllCalendars dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan tetapkan connectorInputPayload sebagai variabel lokal.
```
{
  "Summary": "New event",
  "CalendarId": "c_b4e891cebb19267bf5ac838f0c5f691bee164a7cec9dcc1a93e54625279baa80@group.calendar.altostrat.com",
  "StartDate": "2025-09-01",
  "EndDate": "2025-09-02"
}
```
Jika integrasi berhasil, parameter respons connectorOutputPayload tugas calendar akan memiliki nilai yang mirip dengan berikut:
```
{
  "Id": "fnf0p7292pbm2buk59ubc1a37k",
  "CalendarId": null
}
```

Contoh - Membuat acara di kalender utama Anda

Dalam dialog Configure connector task, klik Entities.
Pilih ID email Anda dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan tetapkan connectorInputPayload sebagai variabel lokal.
```
{
  "Summary": "new event for my calendar",
  "CalendarId": "xyz@xwf.altostrat.com",
  "StartDate": "2025-09-01",
  "EndDate": "2025-09-02"
}
```
Jika integrasi berhasil, parameter respons connectorOutputPayload tugas AllCalendars akan memiliki nilai yang mirip dengan berikut:
```
{
  "Id": "fnf0p7292pbm2buk59ubc1a37k",
  "CalendarId": null
}
```

Contoh - Membuat jenis acara di kalender

Dalam dialog Configure connector task, klik Entities.
Pilih AllCalendars dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan tetapkan connectorInputPayload sebagai variabel lokal.
```
{
  "EventType": "outOfOffice",
  "Summary": "outOfOffice",
  "CalendarId": "xyz@xwf.altostrat.com",
  "StartDateTime": "2025-09-03 14:00:00",
  "EndDateTime": "2025-09-03 15:00:00"
}
```
Jika integrasi berhasil, parameter respons connectorOutputPayload tugas AllCalendars akan memiliki nilai yang mirip dengan berikut:
```
{
  "Id": "fnf0p7292pbm2buk59ubc1a37k",
  "CalendarId": null
}
```

Contoh - Membuat acara berulang di kalender

Dalam dialog Configure connector task, klik Entities.
Pilih AllCalendars dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.

Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan tetapkan connectorInputPayload sebagai variabel lokal.

{
  "Summary": "Google Cloud Recurring event",
  "CalendarId": "xyz@xwf.altostrat.com",
  "StartDateTime": "2025-11-2 14:00:00",
  "EndDateTime": "2025-11-2 14:30:00",
  "Recurrences": "RRULE:FREQ=WEEKLY;BYDAY=TH;COUNT=5",
  "StartDateTimeZone": "America/Los_Angeles",
  "EndDateTimeZone": "America/Los_Angeles"
}

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

{
  "Id": "fnf0p7292pbm2buk59ubc1a37k",
  "CalendarId": null
}

Contoh - Memperbarui detail kalender

Dalam dialog Configure connector task, klik Entities.
Pilih Calendars dari daftar Entity.
Pilih operasi Update, lalu klik Selesai.
Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan tetapkan connectorInputPayload sebagai variabel lokal.
```
{
  "Summary": "Updated from Google Cloud"
}
```
Tetapkan entityId di Pemeta Data ke entity Kalender.
Untuk menetapkan entityId, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan tetapkan entityId sebagai variabel lokal.
Selain menentukan entityId, Anda juga dapat menetapkan filterClause ke id='c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com'.

Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas konektor:
```
{
  "Id": "c_5bae32e1c48ed38af98efecbd6da6bb002a31e887276aa65cc2530717123b75f@group.calendar.altostrat.com"
}
```

Contoh - Perbarui semua detail kalender

Dalam dialog Configure connector task, klik Entities.
Pilih AllCalendars dari daftar Entity.
Pilih operasi Update, lalu klik Selesai.
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 tetapkan connectorInputPayload sebagai variabel lokal.
```
{
  "Summary": "Great event"
}
```
Tetapkan entityId di Pemeta Data ke entity AllCalendars.
Untuk menetapkan entityId, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan tetapkan entityId sebagai variabel lokal.
Selain menentukan entityId, Anda juga dapat menetapkan filterClause ke Summary='New sep event'.

Menjalankan contoh ini akan menampilkan respons yang mirip dengan berikut dalam variabel output connectorOutputPayload tugas konektor:
```
{
  "Id": "fnf0p7292pbm2buk59ubc1a37k",
  "CalendarId": 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.