Ikhtisar

Topik ini memperkenalkan produk Calendar, termasuk cara mengaktifkan Calendar, kemampuan API yang disediakan Calendar, dan cara mengintegrasikan kemampuan Calendar.

Apa itu Calendar

DingTalk Calendar terintegrasi secara mendalam dengan pesan instan. Rekan kerja dapat berbagi acara, memulai rapat acara dengan mudah, dan melihat hal-hal penting sekilas, sehingga memungkinkan kolaborasi tim yang lebih efisien dan pengalaman yang baik bagi karyawan. Untuk informasi selengkapnya, lihat Panduan Pengguna DingTalk - Calendar.

Notifikasi yang tepat untuk rapat acara

Buat acara rapat dengan satu klik. Undangan dikirim langsung ke setiap partisipan sebagai pesan obrolan, memastikan tidak ada yang terlewat.

Manajemen acara terpadu

Hubungkan dengan Alibaba Mail untuk melihat dan mengedit acara secara terpadu di dalam kalender DingTalk. Perbarui di satu tempat dan sinkronkan di mana saja, sehingga Anda tidak pernah melewatkan rapat atau jadwal.

Cara mengaktifkan Calendar

Di perangkat seluler: Ketuk Collaboration > Calendar, atau ketuk Calendar di bilah alat. Di desktop: Klik Calendar.

Ikhtisar kemampuan terbuka

Daftar API

Calendar menyediakan sekumpulan open API yang lengkap. Developer dapat menggunakan API ini untuk mengintegrasikan Calendar dengan sistem bisnis organisasi mereka.

Catatan

API New Event, Update Event, Add Event Attendees, dan Delete Event Attendees masing-masing mendukung hingga 500 partisipan per operasi, dan maksimum 5.000 partisipan per acara.
Untuk menambahkan atau menghapus partisipan acara, kami merekomendasikan penggunaan API Add Event Attendees dan Delete Event Attendees.

Kontrol akses pengguna

API	Deskripsi	Spesifikasi baru (Server API baru)	Spesifikasi lama (Server API)
Buat kontrol akses	Tambahkan kontrol akses ke kalender yang ditentukan.	Buat kontrol akses	-
Hapus kontrol akses	Hapus kontrol akses.	Hapus kontrol akses	-
Dapatkan daftar kontrol akses	Dapatkan daftar kontrol akses kalender.	Dapatkan daftar kontrol akses	-

Acara

API	Deskripsi	Spesifikasi baru (Server API baru)	Spesifikasi lama (Server API)
Acara Baru	Buat acara.	Acara Baru	-
Hapus Acara	Hapus acara yang ditentukan.	Hapus Acara	-
Perbarui acara	Perbarui informasi tentang satu acara.	Perbarui acara	-
Kueri detail acara	Kueri detail satu acara.	Kueri detail acara	-
Kueri daftar acara	Kueri acara pengguna dalam rentang waktu tertentu.	Kueri daftar acara	-
Kueri tampilan acara	Kueri tampilan acara kalender utama DingTalk pengguna dalam rentang waktu tertentu.	Kueri tampilan acara	-

Partisipan acara

API	Deskripsi	Spesifikasi baru (Server API baru)	Spesifikasi lama (Server API)
Tambah partisipan acara	Tambahkan partisipan acara.	Tambah partisipan acara
Hapus partisipan acara	Hapus pengguna yang ditentukan dari partisipan acara.	Hapus partisipan acara	-
Dapatkan partisipan acara	Dapatkan daftar partisipan acara.	Dapatkan partisipan acara	-
Setel status respons undangan acara	Setel status respons undangan acara.	Setel status respons undangan acara	-

Luang/sibuk

API	Deskripsi	Spesifikasi baru (Server API baru)	Spesifikasi lama (Server API)
Dapatkan informasi luang/sibuk pengguna	Kueri informasi luang/sibuk dari daftar pengguna yang ditentukan dalam rentang waktu tertentu.	Dapatkan informasi luang/sibuk pengguna	-

Calendar

API	Deskripsi	Spesifikasi baru (Server API baru)	Spesifikasi lama (Server API)
Kueri kalender	Panggil API ini untuk mengkueri kalender pengguna.	Kueri kalender	-
Berlangganan kalender publik	Panggil API ini untuk berlangganan kalender publik.	Berlangganan kalender publik	-
Berhenti berlangganan kalender publik	Panggil API ini untuk berhenti berlangganan kalender publik.	Berhenti berlangganan kalender publik	-
Buat kalender langganan	Panggil API ini untuk membuat kalender langganan.	Buat kalender langganan	-
Kueri detail kalender langganan	Panggil API ini untuk mengkueri detail kalender langganan.	Kueri detail kalender langganan	-
Perbarui kalender langganan	Panggil API ini untuk memperbarui informasi tentang satu kalender langganan.	Perbarui kalender langganan	-
Hapus kalender langganan	Panggil API ini untuk menghapus kalender langganan.	Hapus kalender langganan	-

Check-in

API	Deskripsi	Spesifikasi baru (Server API baru)	Spesifikasi lama (Server API)
Lihat detail check-in satu acara	Panggil API ini untuk melihat detail check-in satu acara.	Lihat detail check-in satu acara	-
Check in untuk satu acara	Check in untuk acara yang ditentukan berdasarkan event ID.	Check in untuk satu acara	-
Check out untuk satu acara	Check out untuk acara yang ditentukan berdasarkan event ID.	Check out untuk satu acara	-
Lihat detail check-in satu acara	Kueri daftar pengguna yang sudah dan belum check in untuk satu acara berdasarkan event ID.	Lihat detail check-out satu acara	-
Dapatkan tautan check-in	Kueri tautan check-in berdasarkan calendar ID, unionId pengguna, dan eventId acara.	Dapatkan tautan check-in	-
Dapatkan tautan check-out	Kueri tautan check-out berdasarkan calendar ID, unionId pengguna, dan eventId acara.	Dapatkan tautan check-out	-

Ruang

API	Deskripsi	Spesifikasi baru (Server API baru)	Spesifikasi lama (Server API)
Dapatkan informasi luang/sibuk ruang	Dapatkan informasi luang/sibuk ruang.	Dapatkan informasi luang/sibuk ruang	-
Pesan ruang	Pesan ruang.	Pesan ruang	-
Batalkan pemesanan ruang	Batalkan pemesanan ruang.	Batalkan pemesanan ruang	-

Daftar peristiwa callback

Calendar mendukung peristiwa callback yang terpicu saat pengguna melakukan perubahan acara.

Tutorial

DingTalk menyediakan contoh alur kerja untuk skenario umum seperti membuat dan menghapus acara, serta mengelola partisipan acara:

Glosarium

Nilai izin	Deskripsi
free_busy_reader	Periksa luang/sibuk
title_reader	Lihat judul
reader	Lihat Detail
writer	Buat dan edit

Definisi sumber daya

Atribut	Tipe	Deskripsi
id	String	ID unik global dari acara.
summary	String	Judul acara.
description	String	Deskripsi acara.
start	Object	Waktu mulai acara.
start.date	String	Tanggal mulai acara dalam format yyyy-MM-dd. Wajib untuk acara sepanjang hari; harus kosong untuk acara non-sepanjang-hari.
start.dateTime	String	Waktu mulai acara dalam format tanggal-waktu ISO-8601. Wajib untuk acara non-sepanjang-hari; harus kosong untuk acara sepanjang hari.
start.timeZone	String	Zona waktu dari waktu mulai acara. Wajib untuk acara non-sepanjang-hari; harus kosong untuk acara sepanjang hari.
end	Object	Waktu akhir acara.
end.date	String	Tanggal akhir acara dalam format yyyy-MM-dd. Wajib untuk acara sepanjang hari; harus kosong untuk acara non-sepanjang-hari.
end.dateTime	String	Waktu akhir acara dalam format tanggal-waktu ISO-8601. Wajib untuk acara non-sepanjang-hari; harus kosong untuk acara sepanjang hari.
end.timeZone	String	Zona waktu dari waktu akhir acara. Harus sesuai dengan zona waktu dari waktu mulai, dalam format nama TZ database. Wajib untuk acara non-sepanjang-hari; harus kosong untuk acara sepanjang hari.
isAllDay	Boolean	Apakah acara merupakan acara sepanjang hari.
recurrence	Object	Aturan pengulangan acara.
recurrence.pattern	Object	Pola pengulangan.
recurrence.pattern.type	String	Tipe pola pengulangan: - daily: Berulang setiap `interval` hari. - weekly: Berulang pada `daysOfWeek` setiap `interval` minggu. - absoluteMonthly: Berulang pada hari `dayOfMonth` setiap `interval` bulan. - relativeMonthly: Berulang pada `daysOfWeek` dari minggu `index` setiap `interval` bulan. - absoluteYearly: Berulang setiap `interval` tahun.
recurrence.pattern.dayOfMonth	Integer	Ketika `type=absoluteMonthly`, menentukan hari dalam bulan.
recurrence.pattern.daysOfWeek	String	Menentukan hari dalam seminggu sebagai kata bahasa Inggris huruf kecil. Pisahkan beberapa nilai dengan koma.
recurrence.pattern.index	String	Ketika `type=relativeMonthly`, menentukan minggu dalam bulan: - first - second - third - fourth - last `last` menunjukkan minggu terakhir dalam bulan.
recurrence.pattern.interval	Integer	Interval pengulangan. Satuannya bervariasi menurut tipe. Misalnya, ketika `type=daily`, intervalnya dalam hari; ketika `type=absoluteYearly`, intervalnya dalam tahun.
recurrence.range	Object	Rentang pengulangan.
recurrence.range.type	String	Tipe rentang pengulangan: - noEnd: Tidak pernah berakhir. - endDate: Berakhir pada tanggal yang ditentukan. - numbered: Berakhir setelah sejumlah kemunculan yang ditentukan.
recurrence.range.endDate	String	Tanggal akhir pengulangan.
recurrence.range.numberOfOccurrences	Integer	Jumlah kemunculan.
attendees	Array	Daftar partisipan acara.
attendees.id	String	unionId dari pengguna.
attendees.displayName	String	Nama pengguna.
attendees.responseStatus	String	Status partisipan: - needsAction: Tidak ada tindakan yang diambil (status default). - accepted: Diterima. - declined: Ditolak. - tentative: Diterima sementara.
attendees.self	Boolean	Apakah ini pengguna yang sedang mengoperasikan.
organizer	Object	Penyelenggara acara.
organizer.id	String	unionId dari penyelenggara.
organizer.displayName	String	Nama pengguna penyelenggara.
organizer.responseStatus	String	Status respons penyelenggara.
organizer.self	Boolean	Apakah ini pengguna saat ini.
location	Object	Lokasi acara.
location.displayName	String	Nama lokasi.
reminders	Array	Pengingat acara.
reminders.method	String	Metode pengingat: - dingtalk: Pengingat dalam aplikasi. - sms: Pengingat SMS. - phone: Pengingat telepon.
reminders.minutes	String	Berapa menit sebelum acara pengingat dikirim.
onlineMeetingInfo	Object	Buat rapat online bersama dengan acara.
onlineMeetingInfo.type	String	Tipe rapat online: - dingtalk: Rapat video DingTalk.
onlineMeetingInfo.conferenceId	String	ID rapat.
onlineMeetingInfo.url	String	URL rapat.
onlineMeetingInfo.extraInfo	Map	Informasi tambahan yang diperluas.
seriesMasterId	String	ID acara utama dari acara berulang. Kosong untuk acara non-berulang.
createTime	String	Waktu pembuatan.
updateTime	String	Waktu pembaruan.
status	String	Status acara: - confirmed: Normal. - cancelled: Dibatalkan.

Panduan pemanggilan API

Autentikasi & otorisasi

Kontak

Kalender

Konferensi

AI Table

Dokumen & file

IM

Apa itu Calendar

Notifikasi yang tepat untuk rapat acara

Manajemen acara terpadu

Cara mengaktifkan Calendar

Ikhtisar kemampuan terbuka

Daftar API

Catatan

Kontrol akses pengguna

Acara

Partisipan acara

Luang/sibuk

Calendar

Check-in

Ruang

Daftar peristiwa callback

Tutorial

Glosarium

Definisi sumber daya

​Apa itu Calendar

​Notifikasi yang tepat untuk rapat acara

​Manajemen acara terpadu

​Cara mengaktifkan Calendar

​Ikhtisar kemampuan terbuka

​Daftar API

​Catatan

​Kontrol akses pengguna

​Acara

​Partisipan acara

​Luang/sibuk

​Calendar

​Check-in

​Ruang

​Daftar peristiwa callback

​Tutorial

​Glosarium

​Definisi sumber daya

Apa itu Calendar

Notifikasi yang tepat untuk rapat acara

Manajemen acara terpadu

Cara mengaktifkan Calendar

Ikhtisar kemampuan terbuka

Daftar API

Catatan

Kontrol akses pengguna

Acara

Partisipan acara

Luang/sibuk

Calendar

Check-in

Ruang

Daftar peristiwa callback

Tutorial

Glosarium

Definisi sumber daya