Halaman ini diterjemahkan oleh Cloud Translation API.

Mengundang pengguna ke acara

Membuat peristiwa

Jika memiliki akses tulis ke Google Kalender penyelenggara, Anda dapat menambahkan acara menggunakan metode Events: insert.

Metode ini menambahkan acara langsung ke kalender penyelenggara, terlepas dari setelan mereka untuk menambahkan undangan.

Tambahkan tamu

Dengan metode ini, Anda juga dapat menambahkan tamu ke acara yang sama dengan menambahkan alamat email mereka ke properti attendees acara. Perubahan mendatang apa pun yang dibuat oleh penyelenggara pada acara tersebut diterapkan kepada tamu.

Peserta akan menerima undangan dari alamat email penyelenggara. Pengguna Google Kalender akan menerima undangan di email dan/atau di kalender mereka, bergantung pada setelan Acara dalam setelan Google Kalender mereka:

Jika mereka memiliki setelan From everyone, acara akan ditambahkan langsung ke kalender mereka
Jika mereka memiliki setelan Only if the sender is known, acara akan ditambahkan langsung ke kalender mereka jika sebelumnya telah berinteraksi dengan penyelenggara, jika penyelenggara berada di organisasi yang sama, atau jika penyelenggara ada dalam kontak Google mereka. Jika tidak dikenali oleh penyelenggara, mereka dapat mengklik Saya kenal pengirim ini atau RSVP dengan mengklik Ya atau Mungkin di email undangan. Kemudian acara tersebut ditambahkan ke kalender mereka.
Jika pengguna memiliki setelan When I respond in email, semua undangan tidak ditambahkan ke kalender mereka sampai pengguna merespons dengan mengklik Ya, Mungkin, atau Tidak di email undangan.

Untuk informasi selengkapnya tentang cara undangan ditambahkan ke Google Kalender, lihat Mengelola undangan di Kalender.

Jangan tetapkan respons tamu menggunakan properti attendees[].responseStatus ke apa pun selain needsAction. Mengisi otomatis respons tamu tidak secara otomatis menambahkan acara ke kalender pengguna.

Menampilkan acara langsung di kalender tamu

Untuk menampilkan acara secara langsung di kalender tamu Google Kalender untuk setelan apa pun yang mungkin dimiliki tamu, Anda dapat menyetel RSVP tamu atau mengimpor salinan acara langsung di kalender tamu. Untuk kedua metode tersebut, Anda memerlukan akses tulis ke kalender tamu; jika tidak, pertimbangkan untuk menambahkan penyelenggara ke kontak peserta, yang mungkin memerlukan akses tulis ke kontak tamu.

Tetapkan RSVP tamu

Untuk menyetel RSVP tamu ke acara, lakukan langkah-langkah berikut:

Buat acara di kalender penyelenggara Google Kalender dan tambahkan tamu (lihat di atas).
Gunakan metode Events: update untuk menetapkan RSVP peserta ke accepted atau tentative. Anda harus memiliki akses tulis ke kalender tamu. Mungkin ada sedikit keterlambatan sebelum acara muncul di kalender peserta. Pelajari lebih lanjut cara menggunakan metode Events: update.

Metode ini akan menambahkan acara ke kalender tamu, tetapi tamu mungkin masih melihat banner di email mereka bahwa undangan tersebut dikirim dari alamat yang sebelumnya tidak mereka kenal.

Mengimpor salinan acara langsung di kalender tamu

Untuk mengimpor salinan acara ke kalender tamu, lakukan langkah-langkah berikut:

Jika Anda memiliki akses tulis ke Google Kalender penyelenggara, impor salinan acara menggunakan metode Events: import.
Impor salinan lain dari acara yang sama di kalender tamu menggunakan Events: import. Anda harus memiliki akses tulis ke kalender tamu. Gunakan ID acara yang sama (iCalUID) untuk salinan penyelenggara dan tamu, serta pastikan untuk menentukan penyelenggara dalam salinan tamu.

Dengan metode ini, tamu dapat melihat acara di kalendernya, tetapi tidak menerima email undangan dari Google Kalender.

Tambahkan penyelenggara ke kontak tamu

Jika tidak memiliki kredensial tamu, Anda dapat meminta tamu atau organisasi untuk menambahkan alamat email penyelenggara ke kontak Google mereka terlebih dahulu untuk menampilkan acara langsung di kalender mereka. Mungkin ada sedikit penundaan agar kontak yang baru dibuat diterapkan.

Minta pengguna Google Kalender untuk menambahkan penyelenggara ke kontak Google mereka.
Jika tamu adalah anggota organisasi, Anda dapat meminta administrator organisasi untuk menambahkan alamat email secara terprogram ke kontak pengguna mereka. Minta administrator untuk mengaktifkan delegasi tingkat luas domain, meniru identitas pengguna, dan menggunakan metode People: createContact untuk membuat kontak bagi setiap pengguna, guna memastikan bahwa undangan mendatang dari alamat email ini akan otomatis muncul di kalender pengguna mereka.
Jika memiliki akses ke kontak tamu, Anda juga dapat menambahkan alamat email penyelenggara ke kontak tamu menggunakan metode People: createContact.

Mengundang pengguna dari alamat email

Jika Anda tidak memiliki akses tulis ke Google Kalender penyelenggara, atau jika tidak ingin mengekspos alamat email penyelenggara, gunakan protokol iCalendar (RFC-5545) untuk mengundang pengguna dengan email menggunakan file .ICS.

Jika tamu adalah pengguna Google Kalender dengan setelan Only if the sender is known dan mereka belum pernah berinteraksi dengan atau mencatat alamat yang mereka ketahui, undangan tidak akan ditambahkan ke kalender mereka hingga mereka mengklik Saya kenal pengirim ini atau mereka melakukan RSVP ke acara tersebut.

Berikan link bagi pengguna untuk menambahkan acara

Atau, jika Anda ingin memudahkan pengguna Google Kalender untuk menambahkan acara sebagai acara satu kali tanpa memperbaruinya, Anda dapat memberikan link dengan acara yang telah diisi sebelumnya untuk ditambahkan sendiri oleh pengguna. Metode ini membuat acara yang berbeda di kalender pengguna, yang tidak dapat diperbarui kecuali jika Anda memiliki akses ke kalender pengguna.

Gunakan template link berikut:


https://calendar.google.com/calendar/r/eventedit?action=TEMPLATE&dates=20230325T224500Z%2F20230326T001500Z&stz=Europe/Brussels&etz=Europe/Brussels&details=EVENT_DESCRIPTION_HERE&location=EVENT_LOCATION_HERE&text=EVENT_TITLE_HERE

dengan memperbarui informasi berikut:

Tanggal dan waktu mulai dan akhir: Gunakan format ISO 8601. Pada contoh di atas, ganti 20230325T224500Z dan 20230326T001500Z.
Zona waktu mulai dan akhir: Format sebagai nama Database Zona Waktu IANA. Tempatkan zona waktu di kolom stz dan etz.
Deskripsi peristiwa: Harus dienkode ke URL.
Lokasi acara: Harus dienkode ke URL.
Judul acara: Harus dienkode ke URL.

Contoh

Mari kita perhatikan contoh membuat layanan reservasi janji temu untuk membantu pengguna membuat janji temu di sebuah bisnis. Saat pengguna membuat janji temu, Anda ingin layanan Anda menambahkan acara ke pemesan dan Google Kalender bisnis.

Untuk pengalaman pengguna terbaik, sebaiknya bisnis tersebut memberikan akses tulis ke kalender mereka, sehingga Anda dapat menambahkan acara langsung ke kalender bisnis (Buat acara) dan mengundang pemesan ke acara tersebut (Tambahkan tamu). Untuk memastikan pemesanan melihat acara di kalender dan diingatkan tentang acara tersebut, beri tahu mereka untuk memeriksa email dan RSVP Ya ke acara segera setelah melakukan pemesanan. Setelah melakukan RSVP ke acara, mereka akan menerima notifikasi acara dari Google Kalender sesuai dengan setelan notifikasi mereka.

Jika Anda ingin menambahkan acara secara langsung ke kalender pemesan, beri tahu pemesan untuk menambahkan ke kontak mereka alamat email yang akan digunakan untuk menerima undangan. Atau, minta pemesanan akses tulis ke kalender mereka untuk melakukan RSVP secara terprogram atas nama mereka (Tetapkan RSVP tamu) dan kirimkan notifikasi email kepada mereka tentang pemesanan yang dikonfirmasi.

Jika bisnis tidak ingin mengekspos alamat emailnya, gunakan alamat email khusus pengguna untuk mengirim acara ke pemesan menggunakan email (Undang pengguna dari alamat email).

Penerapan peristiwa

Diagram berikut menjelaskan dinamika. Pertama, Jack membuat acara di kalender utamanya (dan dengan demikian memiliki salinan penyelenggara). Kemudian, dia mengundang kalender sekunder grup pelajaran Celo dan Susan, yang memiliki setelan acara Only if the sender is known. Salinan peserta dibuat di kalender sekunder grup pelajaran Cello, dan di kalender Susan jika dia mengenal Jack, sebaliknya saat dia melakukan RSVP atau menunjukkan bahwa dia mengenal Jack. Saat Susan merespons, perubahan RSVP akan disebarkan kembali ke penyelenggara, yang memperbarui salinan penyelenggara dengan respons Susan. Perubahan ini dibuat pada salinan acara penyelenggara dan disebarluaskan kepada tamu lain.

Properti peristiwa bersama

Kalender tempat acara dibuat adalah kalender penyelenggara. Kalender ini memiliki informasi acara bersama, termasuk ID, waktu mulai dan berakhir, ringkasan, serta deskripsi. Saat informasi ini diperbarui di kalender penyelenggara, perubahan akan diterapkan ke salinan tamu.

Properti peristiwa pribadi

Tidak semua informasi dibagikan di antara semua salinan acara. Beberapa properti bersifat pribadi, seperti pengingat, colorId, transparansi, atau properti extendedProperties.private. Properti ini dikontrol oleh setelan tamu, bukan oleh kalender penyelenggara.

Tamu juga dapat mengubah properti bersama dalam acara tersebut. Namun, perubahan ini hanya diterapkan pada salinannya sendiri dan mungkin akan hilang jika penyelenggara membuat perubahan.

Satu-satunya perubahan peristiwa yang disebarkan dari tamu kembali ke penyelenggara adalah status respons tamu, yang disimpan di properti attendees[].responseStatus.