Tạo sự kiện
Nếu có quyền ghi vào Lịch Google của người tổ chức, bạn có thể thêm
bằng cách sử dụng Events: insert
.
Phương thức này sẽ thêm sự kiện trực tiếp vào lịch của người tổ chức một cách độc lập cài đặt để thêm lời mời.
Thêm người tham dự
Với phương thức này, bạn cũng có thể thêm người tham dự vào cùng một sự kiện bằng cách thêm
địa chỉ email đến attendees
thuộc tính của sự kiện. Mọi thay đổi sau này người tổ chức sự kiện sẽ thực hiện
được truyền tải đến người tham dự.
Người tham dự sẽ nhận được thư mời từ địa chỉ email của người tổ chức. Điều khoản Người dùng lịch sẽ nhận được lời mời trong email và/hoặc trong lịch của họ, tuỳ theo chế độ cài đặt Sự kiện trong phần cài đặt của Lịch Google:
- Nếu người dùng thiết lập
From everyone
, thì sự kiện sẽ được thêm trực tiếp vào lịch của họ - Nếu người dùng thiết lập
Only if the sender is known
, sự kiện sẽ được thêm trực tiếp vào lịch của họ nếu trước đó họ đã tương tác với người tổ chức, nếu người tổ chức thuộc cùng một tổ chức hoặc nếu người tổ chức nằm trong danh bạ Google của họ. Nếu người tổ chức mà họ không biết, họ có thể nhấp vào Tôi biết người gửi này hoặc trả lời bằng cách nhấp vào Có hoặc Có thể trong email gửi lời mời. Sau đó, sự kiện là vào lịch của họ. - Nếu người dùng đã cài đặt
When I respond in email
thì tất cả lời mời sẽ không truy cập được thêm vào lịch của mình cho đến khi người dùng trả lời bằng cách nhấp vào Có, Có thể, hoặc Không trong email gửi lời mời.
Để biết thêm thông tin về cách lời mời được thêm vào Lịch Google, hãy xem Quản lý lời mời trong Lịch.
Không đặt phản hồi của người tham dự bằng
attendees[].responseStatus
thành bất kỳ thứ gì khác ngoài needsAction
. Đang điền sẵn thông tin của người tham dự
Phản hồi không tự động thêm sự kiện vào danh sách người dùng lịch.
Hiển thị sự kiện ngay trong thẻ của người tham dự lịch
Để hiển thị một sự kiện ngay trong thẻ Người tham dự trên Lịch Google lịch cho cài đặt nhóm người tham dự, bạn có thể đặt câu trả lời của người tham dự hoặc nhập bản sao của sự kiện ngay vào lịch của người tham dự. Đối với cả hai phương pháp, bạn cần quyền ghi vào quyền truy cập của người tham dự calendars; nếu không có, hãy cân nhắc thêm người tổ chức vào danh bạ của người tham dự. Việc này có thể yêu cầu quyền ghi vào danh bạ của người tham dự.
Đặt hồi đáp của người tham dự
Để đặt câu trả lời của một người tham dự cho một sự kiện, hãy làm theo các bước sau:
- Tạo sự kiện trong lịch của người tổ chức Lịch Google và thêm người tham dự (xem ở trên).
- Sử dụng phương thức
Events: update
để thiết lập Câu trả lời của người tham dự đếnaccepted
hoặctentative
. Bạn phải có quyền ghi vào lịch. Có thể có chút chậm trễ trước khi sự kiện xuất hiện trên lịch của người tham dự. Tìm hiểu thêm về cách sử dụng phương thứcEvents: update
.
Phương thức này thêm sự kiện vào lịch của người tham dự, nhưng người tham dự vẫn có thể vẫn thấy biểu ngữ trong email cho biết lời mời được gửi từ một địa chỉ mà họ chưa biết trước đây.
Nhập trực tiếp bản sao của sự kiện vào lịch của người tham dự
Để nhập bản sao của sự kiện vào lịch của một người tham dự, hãy làm như sau các bước:
- Nếu bạn có quyền ghi vào Lịch Google của người tổ chức, hãy nhập một bản sao
của sự kiện bằng cách sử dụng
Phương thức
Events: import
. - Nhập một bản sao khác của cùng một sự kiện trong tệp của người tham dự
lịch bằng
Events: import
. Bạn phải có quyền ghi vào lịch của người tham dự. Hãy sử dụng cùng một mã sự kiện (iCalUID
) cho bản sao của người tổ chức và người tham dự, đồng thời đảm bảo nêu rõ người tổ chức trong bản sao của người tham dự.
Với phương pháp này, người tham dự có thể thấy sự kiện trong lịch của họ, nhưng không thấy nhận được email mời từ Lịch Google.
Thêm người tổ chức vào danh bạ của người tham dự
Nếu không có thông tin đăng nhập của người tham dự, bạn có thể hướng dẫn họ hoặc tổ chức của họ để thêm địa chỉ email của người tổ chức vào danh bạ Google của họ để hiển thị một sự kiện ngay trong lịch của họ. Có thể có Việc cập nhật thông tin liên hệ mới tạo sẽ chậm trễ một chút để thông tin đó có hiệu lực.
- Yêu cầu người dùng Lịch Google thêm người tổ chức vào Danh bạ Google của họ.
- Nếu người tham dự thuộc về một tổ chức, bạn có thể hỏi
quản trị viên để thêm địa chỉ email vào danh sách người dùng theo cách lập trình
người liên hệ. Yêu cầu quản trị viên bật
uỷ quyền trên toàn miền,
mạo danh người dùng và sử dụng
People: createContact
để tạo địa chỉ liên hệ cho từng người dùng, nhằm đảm bảo rằng các lời mời trong tương lai từ các địa chỉ email này sẽ tự động xuất hiện trong lịch. - Nếu có quyền truy cập vào danh bạ của người tham dự, bạn cũng có thể thêm
địa chỉ email của người tổ chức cho danh bạ của người tham dự bằng cách sử dụng
Phương thức
People: createContact
.
Mời người dùng từ địa chỉ email
Nếu bạn không có quyền ghi vào Lịch Google của người tổ chức, hoặc nếu bạn không muốn tiết lộ địa chỉ email của người tổ chức, hãy sử dụng iLịch giao thức (RFC-5545) để mời người dùng có email bằng tệp .ICS.
Nếu người tham dự là một người dùng Lịch Google có chế độ cài đặt Only if the sender
is known
và chưa từng tương tác hoặc ghi lại địa chỉ này là
mà họ biết, lời mời sẽ không được thêm vào lịch của họ cho đến khi họ nhấp vào Tôi
biết người gửi này hoặc họ hồi đáp tham gia sự kiện.
Cung cấp đường liên kết để người dùng thêm sự kiện
Ngoài ra, nếu bạn muốn giúp người dùng Lịch Google dễ dàng thêm dưới dạng sự kiện một lần mà không cần cập nhật, bạn có thể cung cấp một đường liên kết kèm sự kiện được điền trước để người dùng tự thêm chính họ. Phương pháp này tạo ra một sự kiện trên lịch của người dùng mà bạn không thể cập nhật trừ phi bạn quyền truy cập vào lịch của người dùng.
Hãy sử dụng mẫu đường liên kết sau:
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
bằng cách cập nhật thông tin sau:
- Ngày và giờ bắt đầu và kết thúc: Sử dụng định dạng ISO 8601. Trong ví dụ trên,
thay thế
20230325T224500Z
và20230326T001500Z
. - Múi giờ bắt đầu và kết thúc: Định dạng thành tên của Cơ sở dữ liệu múi giờ IANA.
Đặt múi giờ trong trường
stz
vàetz
. - Nội dung mô tả sự kiện: Phải được mã hoá URL.
- Địa điểm diễn ra sự kiện: Phải là URL đã mã hoá.
- Tiêu đề sự kiện: Phải được mã hoá URL.
Ví dụ:
Hãy xem xét ví dụ về cách xây dựng dịch vụ đặt lịch hẹn để hỗ trợ bạn người dùng đặt lịch hẹn với một doanh nghiệp. Khi người dùng đặt lịch hẹn, bạn muốn dịch vụ của mình thêm một sự kiện vào trang web của người đặt vé và doanh nghiệp Lịch.
Để mang đến trải nghiệm tốt nhất cho người dùng, doanh nghiệp nên cấp quyền ghi vào lịch của họ để bạn có thể thêm trực tiếp sự kiện này vào lịch (Tạo sự kiện) và mời nhà đăng ký tham gia sự kiện đó (Thêm người tham dự). Để đảm bảo nhà sách thấy sự kiện trong lịch của họ và nhận được lời nhắc, hãy thông báo để họ kiểm tra email và Hãy hồi đáp Có tham dự sự kiện ngay sau khi đặt chỗ. Sau khi họ hồi đáp sự kiện, chúng sẽ được gửi thông báo về sự kiện trên Lịch Google theo chế độ cài đặt thông báo.
Nếu bạn muốn thêm trực tiếp sự kiện này vào lịch của nhà đặt vé, hãy thông báo cho những nhà đặt vé để thêm vào danh bạ của họ địa chỉ email mà họ sẽ nhận thư mời. Ngoài ra, yêu cầu người đặt lịch cấp quyền ghi vào lịch của họ để trả lời theo phương thức lập trình trên (Đặt câu trả lời của người tham dự) và gửi email cho họ thông báo về lượt đặt vé đã xác nhận.
Nếu doanh nghiệp không muốn tiết lộ địa chỉ email của họ, hãy sử dụng địa chỉ email để gửi sự kiện đến nhà đặt vé bằng cách sử dụng email (Mời người dùng từ địa chỉ email).
Quảng bá sự kiện
Biểu đồ dưới đây giải thích các động lực học. Trước tiên, Jack tạo một sự kiện trên
lịch chính của mình (và do đó sở hữu bản sao của người tổ chức). Sau đó, anh mời
Lịch phụ của nhóm bài học Cello và Susan, người phụ trách việc thiết lập sự kiện
Only if the sender is known
. Dành cho người tham dự các bản sao được tạo trên bài học về Cello
của nhóm, và trên lịch của Susan nếu cô ấy biết Jack, nếu không
khi cô trả lời hoặc cho biết rằng cô biết Jack. Khi Susan trả lời, nội dung hồi đáp sẽ thay đổi
được phổ biến trở lại người tổ chức, cập nhật bản sao của người tổ chức bằng
Phản hồi của Susan. Sau đó, những thay đổi này đối với bản sao sự kiện của người tổ chức
được tuyên truyền đến những người tham dự khác.
Thuộc tính sự kiện được chia sẻ
Lịch nơi sự kiện được tạo là lịch của người tổ chức. Chiến dịch này lịch sở hữu thông tin sự kiện được chia sẻ, bao gồm ID, thời gian bắt đầu và kết thúc, phần tóm tắt và mô tả. Khi thông tin này được cập nhật trên trình tổ chức lịch của bạn, các thay đổi sẽ được phổ biến đến các bản sao của người tham dự.
Thuộc tính sự kiện riêng tư
Không phải thông tin nào cũng được chia sẻ giữa tất cả các bản sao sự kiện. Một số cơ sở lưu trú
riêng tư, chẳng hạn như lời nhắc, colorId
, độ trong suốt hoặc
Thuộc tính extendedProperties.private
. Những tài sản này chịu sự kiểm soát của
cài đặt của người tham dự chứ không phải lịch của người tổ chức.
Người tham dự cũng có thể thay đổi các thuộc tính dùng chung của sự kiện. Tuy nhiên, những các thay đổi chỉ được phản ánh trên bản sao của chính họ và có thể bị mất nếu người tổ chức tạo nên thay đổi.
Thay đổi duy nhất đối với sự kiện được áp dụng từ người tham dự trở lại người tổ chức là
trạng thái phản hồi của người tham dự, được lưu trữ trong
attendees[].responseStatus
thuộc tính này.