Mời người dùng tham gia sự kiện

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 một sự kiện bằng phương thức 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, độc lập với chế độ cài đặt thêm lời mời của họ.

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 của họ vào thuộc tính attendees của sự kiện. Mọi thay đổi sau này do người tổ chức thực hiện đối với sự kiện sẽ được thông báo cho 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. Người dùng Lịch Google sẽ nhận được lời mời qua email và/hoặc trong lịch của họ, tuỳ thuộc vào chế độ cài đặt Sự kiện trong phần cài đặt Lịch Google:

  • Nếu họ cài đặt From everyone, sự kiện sẽ được thêm trực tiếp vào lịch của họ
  • Nếu họ có chế độ cài đặt Only if the sender is known, thì 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 tổ chức hoặc nếu người tổ chức có trong Danh bạ Google của họ. Nếu không biết người tổ chức, 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 này sẽ được thêm vào lịch của họ.
  • Nếu người dùng cài đặt When I respond in email, thì mọi lời mời sẽ không được thêm vào lịch của họ 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 thêm lời mời vào Lịch Google, hãy xem phần Quản lý lời mời trong Lịch.

Đừng đặt phản hồi của người tham dự bằng thuộc tính attendees[].responseStatus thành bất kỳ giá trị nào không phải là needsAction. Việc điền trước phản hồi của người tham dự không tự động thêm sự kiện vào lịch của người dùng.

Hiển thị sự kiện ngay trong lịch của người tham dự

Để hiển thị một sự kiện ngay trong lịch của người tham dự Lịch Google đối với mọi chế độ cài đặt mà người tham dự có thể có, 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 đó. Đối với cả hai phương thức, bạn đều cần quyền ghi vào lịch của người tham dự. Nếu không, 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:

  1. 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).
  2. Sử dụng phương thức Events: update để đặt trả lời của người tham dự thành accepted hoặc tentative. Bạn phải có quyền ghi vào lịch của người tham dự. 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ức Events: update.

Phương thức này sẽ 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ể thấy biểu ngữ trong email cho biết lời mời được gửi từ một địa chỉ mà họ không xác định trước đó.

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 một sự kiện vào lịch của một người tham dự, hãy thực hiện các bước sau:

  1. 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 phương thức Events: import.
  2. Nhập một bản sao khác của cùng một sự kiện trong lịch của người tham dự bằng Events: import. Bạn phải có quyền ghi vào lịch của người tham dự. Bạn nên 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 nhớ nêu rõ người tổ chức trong bản sao của người tham dự.

Với phương thức này, người tham dự có thể xem sự kiện trên lịch của họ, nhưng không 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 người tham dự hoặc tổ chức của họ thêm trước đị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ó một chút chậm trễ để một thông tin liên hệ mới tạo 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 một tổ chức, bạn có thể yêu cầu quản trị viên của tổ chức đó thêm địa chỉ email vào danh bạ của người dùng theo phương thức lập trình. Hãy yêu cầu quản trị viên bật tính năng uỷ quyền trên toàn miền, mạo danh người dùng và sử dụng phương thức People: createContact để tạo danh bạ cho từng người dùng, nhằm đảm bảo rằng các lời mời sau này gửi từ các địa chỉ email này sẽ tự động xuất hiện trong lịch của người dùng.
  • 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 vào danh bạ của họ bằ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 giao thức iLịch (RFC-5545) để mời người dùng có email bằng tệp .ICS.

Nếu người tham dự là người dùng Lịch Google có chế độ cài đặt Only if the sender is known và trước đây họ chưa tương tác hoặc ghi lại địa chỉ mà họ biết, thì 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ọ trả lời sự kiện.

Ngoài ra, nếu muốn người dùng Lịch Google dễ dàng thêm một sự kiện dưới dạng sự kiện một lần mà không cần cập nhật sự kiện đó, bạn có thể cung cấp một đường liên kết đến sự kiện được điền sẵn để người dùng tự thêm. Phương thức này sẽ tạo một sự kiện riêng biệt trên lịch của người dùng. Bạn không thể cập nhật sự kiện này trừ phi có 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, hãy 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 để giúp 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 Lịch Google của người đặt và lịch của doanh nghiệp.

Để mang lại 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 của doanh nghiệp (Tạo sự kiện) và mời người đặt lịch hẹn vào sự kiện đó (Thêm người tham dự). Để đảm bảo người đặt vé nhìn thấy sự kiện trong lịch của họ và được nhắc về sự kiện đó, hãy thông báo cho họ kiểm tra email và phản hồi Có cho sự kiện ngay sau khi đặt chỗ. Sau khi hồi đáp sự kiện, họ sẽ nhận được thông báo về sự kiện từ 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 vào lịch của nhà đặt vé, hãy thông báo cho người đặt vé thêm vào danh bạ của họ địa chỉ email mà họ sẽ nhận được lời mời. Ngoài ra, hãy yêu cầu người đặt vé cấp quyền ghi vào lịch của họ để trả lời theo phương thức lập trình thay mặt cho họ (Đặt câu trả lời của người tham dự) và gửi cho họ thông báo qua email 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 dành riêng cho người dùng để gửi sự kiện đến người đặt dịch 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 trên Cell và Susan là người thiết lập sự kiện Only if the sender is known. Bản sao của người tham dự được tạo trên lịch phụ của nhóm bài học Cello và trên lịch của Susan nếu cô biết Jack, ngược lại khi cô trả lời hoặc cho biết cô biết Jack. Khi Susan trả lời, nội dung thay đổi về câu trả lời sẽ được truyền trở lại cho người tổ chức và cập nhật bản sao của người tổ chức bằng phản hồi của Susan. Những thay đổi này được thực hiện cho bản sao sự kiện của người tổ chức sau đó được phổ biến cho những người tham dự khác.

Biểu đồ thể hiện tính linh động của sự kiện/người tham dự

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. Lịch này sở hữu thông tin sự kiện được chia sẻ, bao gồm cả mã nhận dạng, thời gian bắt đầu và kết thúc, bản tóm tắt và nội dung mô tả. Khi thông tin này được cập nhật trên lịch của người tổ chức, 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ố thuộc tính có tính riêng tư, chẳng hạn như lời nhắc, colorId, tính minh bạch hoặc thuộc tính extendedProperties.private. Các thuộc tính này do chế độ cài đặt của người tham dự kiểm soát 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 thay đổi này chỉ được phản ánh trên bản sao của chính chúng và có thể bị mất nếu người tổ chức thực hiện thay đổi.

Thay đổi duy nhất về sự kiện được truyền 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ự. Trạng thái này được lưu trữ trong thuộc tính attendees[].responseStatus.