Sambungkan Google Calendar

Panduan ini menunjukkan cara menyambungkan Google Calendar ke ruang kerja. Sifatnya bagi setiap ruang kerja: ia menyegerakkan acara ruang kerja itu ke Control Center, baca sahaja. Lihat Kalendar dan penjadualan untuk gambaran penuh.

Sambungkan akaun

Buka Kalendar dalam bar sisi.
Klik Tambah akaun kalendar dalam bar sisi kalendar. (Bahagian yang sama juga terletak di Tetapan → Ruang kerja → Profil & identiti, di bawah Google Calendar.)
Pilih cara untuk memberi kebenaran:
- Gunakan apl Google Control Center — tiada apa yang perlu disediakan. Ini lalai apabila binaan anda menyertakannya.
- Gunakan klien Google Cloud saya sendiri — tampal id klien dan rahsia daripada projek anda sendiri (lihat Bawa klien Google anda sendiri).
Klik Sambung Google Calendar. Dialog menunjukkan kod pendek dan pautan ke halaman peranti Google.
Buka halaman itu pada mana-mana peranti, masukkan kod itu dan luluskan akses yang diminta. Dialog itu tertutup sendiri dan acara anda mula disegerakkan.

Pelayan, bukan peranti anda, yang menjalankan pertukaran ini dan menyimpan token penyegaran yang terhasil — itulah sebabnya kod itu diluluskan pada “mana-mana peranti” dan bukan dalam apl ini secara khusus.

Akaun itu disambungkan hanya pada ruang kerja aktif. Tukar ruang kerja dan anda akan melihat kalendar ruang kerja itu sebaliknya.

Aliran sambungan meminta calendar.readonly serta e-mel anda — skop yang sama untuk apl terbina dalam dan untuk klien yang anda tampal. Control Center membaca acara; ia tidak mencipta, menyunting, memadam atau menjawab jemputan pada Google.

Bagaimana penyegerakan berfungsi

Pelayan yang memiliki jadual itu: ia menyapu akaun bersambung setiap ruang kerja setiap dua minit dan menulis acara itu ke dalam pangkalan data ruang kerja. Klien tidak pernah bercakap dengan Google — klien membaca apa yang ditulis oleh pelayan.

Sapuan itu bersifat inkremental. Lintasan pertama bagi setiap kalendar mengambil tetingkap bergolek (60 hari ke belakang, 90 hari ke hadapan) dan menangkap token segerak Google; lintasan seterusnya membentangkan token itu dan hanya menerima apa yang berubah, dan itulah yang menjadikan irama dua minit ini berpatutan. Tetingkap itu ditambat semula dengan penyegerakan penuh setiap 24 jam dan setiap kali Google membatalkan token itu.

Token penyegaran hidup di sisi pelayan dalam secrets.json di bawah direktori data pelayan, ditulis untuk pemilik sahaja (0600) — bukan dalam keychain OS dan tidak pernah pada peranti klien.

Sambungkan berbilang akaun

Satu ruang kerja boleh menyambungkan beberapa akaun Google (contohnya kerja dan peribadi). Ulangi langkah sambungan untuk setiap satu; acara mereka digabungkan ke dalam paparan bulan / minggu / agenda yang sama. Setiap akaun menyegerak dan menyegar secara berasingan dan setiap satu boleh diputuskan sendiri.

Sambung semula akaun yang luput

Jika Google membatalkan token sesuatu akaun secara kekal (sesi yang ditarik balik atau lama luput), penyegerakan berhenti dan Control Center memaparkan banner Sambung semula pada kalendar, serta pemberitahuan desktop. Klik Sambung semula dan luluskan kod baharu; banner itu hilang pada penyegerakan berjaya yang seterusnya.

Putuskan akaun

Dari bar sisi kalendar (atau Tetapan → Ruang kerja → Profil & identiti), klik Putuskan pada akaun itu. Ini memadamkan acara yang disegerakkannya dan membersihkan token tersimpannya pada pelayan.

Sambung dari pelayan tanpa kepala

Pelayan tanpa GUI yang dipasang menyambungkan akaun yang sama dari terminalnya sendiri:

GOOGLE_OAUTH_CLIENT_ID=<id> GOOGLE_OAUTH_CLIENT_SECRET=<secret> \
  cc_server calendar connect --data-dir <dir> --workspace <workspace-id>

Ia mencetak kod dan URL, menunggu kelulusan, kemudian menyimpan token dan menyegerak pada sapuan seterusnya.

Binaan daripada sumber tidak menyertakan klien Google, jadi id dan rahsia itu diperlukan — tetapkan GOOGLE_OAUTH_CLIENT_ID dan GOOGLE_OAUTH_CLIENT_SECRET. Tiada bendera --google-client-id (bendera yang tidak dikenali diabaikan). Tanpa pasangan persekitaran itu, arahan ini keluar dengan ralat klien tiada.

Bawa klien Google anda sendiri (fork dan self-hosting)

Binaan keluaran menyertakan klien Google, jadi kebanyakan orang tidak pernah menyentuh perkara ini. Bawa klien anda sendiri jika anda membina daripada sumber, menjalankan pelayan sendiri atau mahu skrin persetujuan menamakan projek anda sendiri.

Dalam Google Cloud Console, dayakan Google Calendar API dan konfigurasikan skrin persetujuan OAuth, sambil menambah skop calendar.readonly, openid dan email. Selagi apl belum disahkan, tambah diri anda sebagai pengguna ujian. Menambah calendar.events pada skrin persetujuan tidak mendayakan RSVP — Control Center tidak pernah meminta skop itu.
Cipta ID klien OAuth dengan jenis aplikasi TVs and limited input devices dan salin kedua-dua id klien dan rahsia klien.
Bekalkan kedua-duanya sama ada bagi setiap sambungan (pilih Gunakan klien Google Cloud saya sendiri dalam dialog) atau untuk seluruh pelayan dengan GOOGLE_OAUTH_CLIENT_ID dan GOOGLE_OAUTH_CLIENT_SECRET.

Pasangan untuk seluruh pelayan menggantikan pasangan terbina dalam di semua tempat, termasuk di sebalik pilihan “gunakan apl Google Control Center” — jadi pada pelayan anda sendiri, pilihan itu ialah apl anda.

Rahsia klien tidak pernah meninggalkan pelayan: tiada respons RPC yang membawanya dan akaun yang disambungkan melalui klien pelayan itu sendiri menyimpan penanda dan bukan salinan pasangan itu, jadi memutarkannya hanyalah soal memulakan semula dengan nilai baharu.

Penyelesaian masalah

Gejala	Punca kemungkinan
Dialog tidak menawarkan pilihan terbina dalam	Binaan ini tidak menyertakan klien Google (binaan sumber), atau pelayan dimulakan dengan hanya separuh daripada pasangan itu. Kedua-dua id dan rahsia diperlukan
`invalid_scope` semasa memulakan aliran	Calendar tidak dibenarkan untuk klien kod peranti dalam projek Cloud itu. Gunakan projek klien loopback atau web sebaliknya
`invalid_client` daripada Google	Klien itu bukan klien TVs and limited input devices, atau id dan rahsia itu daripada klien yang berbeza
Kelulusan berjaya tetapi penyegerakan kosong	Akaun anda bukan pengguna ujian pada skrin persetujuan, atau `calendar.readonly` tidak diberikan
Kod luput sebelum anda meluluskannya	Kod peranti berumur pendek. Mulakan sambungan semula untuk mendapatkan kod baharu
“Tidak dapat mengemas kini jawapan anda” pada RSVP	Dijangka: aliran sambungan tidak pernah meminta `calendar.events`
Penyegerakan berhenti dengan amaran penyegaran dalam log pelayan	Akaun itu disambungkan dengan klien yang tidak lagi dikonfigurasikan. Sambung semula akaun itu, atau pulihkan id dan rahsia klien itu

Panduan berkaitan

Rakam dan ringkaskan mesyuarat: tukar acara menjadi rakaman
Jalankan pelayan tanpa kepala: tempat token dan jadual penyegerakan berada
Sediakan integrasi GitHub

Konsep berkaitan

Kalendar dan penjadualan