Trang này được dịch bởi Cloud Translation API.

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

Tạo sự kiện

Nếu có quyền ghi đối với Lịch Google của người tổ chức, bạn có thể thêm sự kiện bằng phương thức Events: insert.

Phương thức này thêm trực tiếp sự kiện 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.

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 mà người tổ chức thực hiện đối với sự kiện đều được truyền bá cho người tham dự.

Người tham dự 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 trong 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 của 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, 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 hồi đáp 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ó chế độ cài đặt When I respond in email, 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 hồi đáp 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.

Khô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ác ngoài needsAction. Việc điền trước phản hồi của người tham dự sẽ 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ự trên Lịch Google cho mọi chế độ cài đặt mà người tham dự có thể có, bạn có thể đặt lời hồi đáp của người tham dự hoặc nhập bản sao của sự kiện ngay trong lịch của người tham dự. Đối với cả hai phương thức, bạn cần quyền ghi vào lịch của người tham dự; nếu không, hãy xem xét việ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 lời hồi đáp của người tham dự

Để đặt câu trả lời của người tham dự cho một sự kiện, hãy thực hiện 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 để đặt câu 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ó một 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 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à trước đây họ không biết.

Nhập bản sao của sự kiện trực tiếp 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 người tham dự, hãy thực hiện các bước sau:

Nếu bạn có quyền ghi đối với Lịch Google của người tổ chức, hãy nhập bản sao của sự kiện bằ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 vào lịch của người tham dự bằng cách sử dụ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ự và đảm bảo chỉ định 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 trong 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ị sự kiện ngay trên lịch của họ. Có thể sẽ có một chút chậm trễ để một mục liên hệ mới tạo có hiệu lực.

Hãy 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 đị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 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 người tham dự 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 hiển thị đị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 đó 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.

Cung cấp đường liên kết để người dùng thêm 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 đường liên kết với một sự kiện được điền sẵn để người dùng tự thêm sự kiện. Phương thức này tạo một sự kiện riêng biệt trên lịch của người dùng mà bạn không thể cập nhật trừ phi bạn 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 những 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 dưới dạng tên Cơ sở dữ liệu múi giờ IANA. Đặt múi giờ trong trường stz và etz.
Mô tả sự kiện: Phải được mã hoá URL.
Vị trí sự kiện: Phải được mã hoá URL.
Tiêu đề sự kiện: Phải được mã hoá URL.

Ví dụ:

Hãy xem xét ví dụ về cách tạo 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 lịch hẹn và Lịch Google của doanh nghiệp.

Để có trải nghiệm người dùng tốt nhất, 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 vào lịch của doanh nghiệp (Tạo sự kiện) và mời người đặt lịch hẹn tham gia sự kiện đó (Thêm người tham dự). Để đảm bảo người đặt lịch hẹn nhìn thấy sự kiện trên lịch của họ và được nhắc về sự kiện, hãy thông báo để họ kiểm tra email và hồi đáp là Có sự kiện ngay sau khi đặt lịch hẹn. 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 của họ.

Nếu bạn muốn thêm trực tiếp sự kiện vào lịch của người đặt lịch hẹn, hãy thông báo cho người đặt lịch hẹn thêm vào danh bạ của họ địa chỉ email để nhận lời mời. Ngoài ra, hãy yêu cầu người đặt lịch cấp quyền ghi vào lịch của họ để hồi đáp theo phương thức lập trình thay mặt họ (Thiết lập lời hồi đáp của người tham dự) và gửi cho họ thông báo qua email về yêu cầu đặt chỗ đã 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 lịch hẹn bằng email (Mời người dùng từ địa chỉ email).

Truyền bá sự kiện

Biểu đồ dưới đây giải thích về động 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 CMake và Susan, người phụ trách chế độ cài đặt 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 trên Cello và trên lịch của Susan nếu cô ấy biết Jack, nếu không thì khi cô ấy hồi đáp hoặc cho biết cô biết Jack. Khi Susan phản hồi, nội dung thay đổi về lời hồi đáp sẽ được truyền trở lại cho người tổ chức, đồng thời 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 đối với bản sao sự kiện của người tổ chức và sau đó được phổ biến tới 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. Lịch này sở hữu thông tin sự kiện được chia sẻ, bao gồm mã, 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, nội dung thay đổi sẽ được truyền đến bản sao của người tham dự.

Thuộc tính sự kiện riêng tư

Không phải mọi thông tin đều được chia sẻ giữa mọi bản sao sự kiện. Một số thuộc tính ở chế độ 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. Những cơ sở lưu trú này do chế độ cài đặt của người tham dự kiểm soát chứ không phải do lịch của người tổ chức kiểm soát.

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 riêng của chúng và có thể bị mất nếu người tổ chức thực hiện thay đổi.

Thay đổi sự kiện duy nhất đượ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ự, được lưu trữ trong thuộc tính attendees[].responseStatus.