เชิญผู้ใช้เข้าร่วมกิจกรรม

สร้างเหตุการณ์

หากคุณมีสิทธิ์เขียนใน Google ปฏิทินของผู้จัด คุณจะเพิ่มกิจกรรมได้โดยใช้เมธอด Events: insert

วิธีนี้จะเพิ่มกิจกรรมไปยังปฏิทินของผู้จัดโดยตรง โดยไม่ขึ้นอยู่กับการตั้งค่าเพื่อเพิ่มคำเชิญ

เพิ่มผู้เข้าร่วม

วิธีนี้จะทำให้เพิ่มผู้เข้าร่วมในกิจกรรมเดียวกันได้โดยเพิ่มอีเมลของบุคคลเหล่านั้นลงในพร็อพเพอร์ตี้ attendees ของกิจกรรม การเปลี่ยนแปลงใดๆ ที่ผู้จัดกิจกรรมทำในอนาคตจะมีการนำไปเผยแพร่ต่อผู้เข้าร่วม

ผู้เข้าร่วมจะได้รับคําเชิญจากอีเมลของผู้จัด ผู้ใช้ Google ปฏิทินจะได้รับคําเชิญในอีเมลและ/หรือในปฏิทิน ทั้งนี้ขึ้นอยู่กับการตั้งค่ากิจกรรมภายในการตั้งค่า Google ปฏิทิน ดังนี้

• หากผู้ใช้ตั้งค่า From everyone ระบบจะเพิ่มกิจกรรมไปยังปฏิทินของผู้ใช้โดยตรง
• หากผู้ใช้มีการตั้งค่า Only if the sender is known ระบบจะเพิ่มกิจกรรมลงในปฏิทินโดยตรงหากผู้ใช้เคยติดต่อกับผู้จัดแล้ว หากผู้จัดอยู่ในองค์กรเดียวกัน หรือผู้จัดอยู่ในรายชื่อติดต่อ Google หากผู้จัดไม่รู้จักผู้จัด ให้คลิกฉันรู้จักผู้ส่งรายนี้หรือตอบกลับโดยคลิกใช่หรือไม่แน่ในอีเมลคำเชิญ จากนั้นระบบจะเพิ่ม กิจกรรมนั้นในปฏิทิน
• หากผู้ใช้มีการตั้งค่า When I respond in email ระบบจะไม่เพิ่มคำเชิญทั้งหมดลงในปฏิทินจนกว่าผู้ใช้จะตอบกลับโดยคลิกใช่ อาจจะ หรือไม่ในอีเมลคำเชิญ

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีเพิ่มคำเชิญไปยัง Google ปฏิทินได้ที่หัวข้อจัดการคำเชิญในปฏิทิน

อย่ากำหนดคำตอบของผู้เข้าร่วมโดยใช้พร็อพเพอร์ตี้ attendees[].responseStatus เป็นอย่างอื่นที่ไม่ใช่ needsAction การป้อนข้อมูลคำตอบของผู้เข้าร่วมล่วงหน้าจะไม่เป็นการเพิ่มกิจกรรมในปฏิทินของผู้ใช้โดยอัตโนมัติ

แสดงกิจกรรมโดยตรงในปฏิทินของผู้เข้าร่วม

หากต้องการแสดงกิจกรรมในปฏิทินโดยตรงของผู้เข้าร่วมใน Google ปฏิทินสำหรับการตั้งค่าที่ผู้เข้าร่วมอาจมี ให้ตั้งค่าการตอบกลับของผู้เข้าร่วม หรือนำเข้าสำเนาของกิจกรรมในปฏิทินของผู้เข้าร่วมโดยตรง สำหรับทั้ง 2 วิธี คุณต้องมีสิทธิ์เขียนปฏิทินของผู้เข้าร่วม แต่ถ้าไม่มี ให้พิจารณาเพิ่มผู้จัดในรายชื่อติดต่อของผู้เข้าร่วม โดยอาจต้องให้สิทธิ์การเขียนในรายชื่อติดต่อของผู้เข้าร่วม

กำหนดการตอบกลับของผู้เข้าร่วม

หากต้องการกำหนดการตอบกลับของผู้เข้าร่วมกิจกรรม ให้ทำตามขั้นตอนต่อไปนี้

1. สร้างกิจกรรมในปฏิทินของผู้จัด Google ปฏิทินและเพิ่มผู้เข้าร่วม (ดูด้านบน)
2. ใช้เมธอด Events: update เพื่อตั้งค่าการตอบกลับของผู้เข้าร่วมเป็น accepted หรือ tentative คุณต้องมีสิทธิ์การเขียนในปฏิทินของผู้เข้าร่วม อาจมีความล่าช้าเล็กน้อยก่อนที่กิจกรรมจะปรากฏในปฏิทินของผู้เข้าร่วม ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้เมธอด Events: update

วิธีนี้จะเพิ่มกิจกรรมลงในปฏิทินของผู้เข้าร่วม แต่ผู้เข้าร่วมอาจยังเห็นแบนเนอร์ในอีเมลที่ระบุว่าคำเชิญส่งมาจากอีเมลที่ไม่ทราบมาก่อน

นำเข้าสำเนาของกิจกรรมในปฏิทินของผู้เข้าร่วมโดยตรง

หากต้องการนำเข้าสำเนาของกิจกรรมไปยังปฏิทินของผู้เข้าร่วม ให้ทำตามขั้นตอนต่อไปนี้

1. หากคุณมีสิทธิ์เขียนใน Google ปฏิทินของผู้จัด ให้นำเข้าสำเนากิจกรรมโดยใช้เมธอด Events: import
2. นำเข้าสำเนาอื่นของกิจกรรมเดียวกันในปฏิทินของผู้เข้าร่วมโดยใช้ Events: import คุณต้องมีสิทธิ์ในการเขียนปฏิทินของผู้เข้าร่วม ใช้รหัสกิจกรรมเดียวกัน (iCalUID) สำหรับสำเนาของผู้จัดและผู้เข้าร่วม และอย่าลืมระบุผู้จัดในสำเนาของผู้เข้าร่วม

วิธีนี้จะทำให้ผู้เข้าร่วมสามารถดูกิจกรรมในปฏิทินของตนได้ แต่จะไม่ได้รับอีเมลคำเชิญจาก Google ปฏิทิน

เพิ่มผู้จัดลงในรายชื่อติดต่อของผู้เข้าร่วม

หากไม่มีข้อมูลเข้าสู่ระบบของผู้เข้าร่วม คุณสามารถแจ้งให้ผู้เข้าร่วมหรือองค์กรเพิ่มที่อยู่อีเมลของผู้จัดลงในรายชื่อติดต่อ Google ล่วงหน้าเพื่อแสดงกิจกรรมลงในปฏิทินได้โดยตรง อาจมีความล่าช้าเล็กน้อยก่อนที่รายชื่อติดต่อที่สร้างขึ้นใหม่จะมีผล

• ขอให้ผู้ใช้ Google ปฏิทินเพิ่มผู้จัดลงในรายชื่อติดต่อ Google
• หากผู้เข้าร่วมอยู่ในองค์กร คุณขอให้ผู้ดูแลระบบขององค์กรเพิ่มอีเมลในรายชื่อติดต่อของผู้ใช้แบบเป็นโปรแกรมได้ ขอให้ผู้ดูแลระบบเปิดใช้การมอบสิทธิ์ทั่วทั้งโดเมน สวมบทบาทเป็นผู้ใช้ และใช้วิธีการ People: createContact เพื่อสร้างรายชื่อติดต่อสำหรับผู้ใช้แต่ละรายเพื่อให้แน่ใจว่าคำเชิญในอนาคตจากอีเมลเหล่านี้จะปรากฏในปฏิทินของผู้ใช้โดยอัตโนมัติ
• หากคุณมีสิทธิ์เข้าถึงรายชื่อติดต่อของผู้เข้าร่วม คุณจะเพิ่มอีเมลผู้จัดลงในรายชื่อติดต่อของผู้เข้าร่วมได้โดยใช้วิธี People: createContact

เชิญผู้ใช้จากอีเมล

หากคุณไม่มีสิทธิ์เขียนใน Google ปฏิทินของผู้จัดหรือไม่ต้องการเปิดเผยอีเมลของผู้จัด ให้ใช้โปรโตคอล iปฏิทิน (RFC-5545) เพื่อเชิญผู้ใช้ด้วยอีเมลโดยใช้ไฟล์ .ICS

หากผู้เข้าร่วมเป็นผู้ใช้ Google ปฏิทินที่มีการตั้งค่า Only if the sender is known และยังไม่เคยโต้ตอบหรือบันทึกที่อยู่ตามที่ตนเองรู้จักมาก่อน ระบบจะไม่เพิ่มคำเชิญลงในปฏิทินจนกว่าจะคลิกฉันรู้จักผู้ส่งรายนี้หรือตอบกลับกิจกรรม

ระบุลิงก์เพื่อให้ผู้ใช้เพิ่มกิจกรรม

หรือหากต้องการให้ผู้ใช้ Google ปฏิทินเพิ่มกิจกรรมแบบครั้งเดียวได้ง่ายขึ้นโดยไม่ต้องอัปเดต คุณก็ระบุลิงก์ที่มีกิจกรรมที่ป้อนข้อมูลไว้ล่วงหน้าเพื่อให้ผู้ใช้เพิ่มตัวเองได้ วิธีนี้จะสร้างกิจกรรมเฉพาะในปฏิทินของผู้ใช้ ซึ่งคุณจะอัปเดตไม่ได้เว้นแต่จะมีสิทธิ์เข้าถึงปฏิทินของผู้ใช้

ใช้เทมเพลตลิงก์ต่อไปนี้

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

ด้วยการอัปเดตข้อมูลต่อไปนี้

• วันที่และเวลาเริ่มต้นและสิ้นสุด: ใช้รูปแบบ ISO 8601 ในตัวอย่างด้านบน ให้แทนที่ 20230325T224500Z และ 20230326T001500Z
• เขตเวลาเริ่มต้นและสิ้นสุด: จัดรูปแบบเป็นชื่อฐานข้อมูลเขตเวลา IANA วางเขตเวลาในช่อง stz และ etz
• คำอธิบายเหตุการณ์: ต้องเป็น URL ที่เข้ารหัส
• ตำแหน่งเหตุการณ์: ต้องเป็น URL ที่เข้ารหัส
• ชื่อเหตุการณ์: ต้องเป็น URL ที่เข้ารหัส

ตัวอย่าง

ลองมาดูตัวอย่างการสร้างบริการจองการนัดหมายเพื่อช่วยให้ผู้ใช้จองการนัดหมายกับธุรกิจ เมื่อผู้ใช้จองการนัดหมาย คุณ ต้องการให้บริการของคุณเพิ่มกิจกรรมให้กับผู้จองและ Google ปฏิทินของธุรกิจ

เพื่อให้ผู้ใช้ได้รับประสบการณ์ที่ดีที่สุด เราขอแนะนำให้ธุรกิจให้สิทธิ์การเขียนลงในปฏิทินเพื่อให้คุณเพิ่มกิจกรรมนั้นลงในปฏิทินของธุรกิจโดยตรง (สร้างกิจกรรม) และเชิญผู้จองเข้าร่วมกิจกรรมนั้น (เพิ่มผู้เข้าร่วม) เพื่อให้มั่นใจว่าผู้จองจะเห็นกิจกรรมในปฏิทินของตนและได้รับการแจ้งเตือน ให้แจ้งให้ผู้จองตรวจสอบอีเมลและตอบกลับว่าตกลงเข้าร่วมกิจกรรมทันทีหลังจากที่ทำการจอง เมื่อตอบกลับคำเชิญเข้าร่วมกิจกรรมแล้ว ผู้ใช้เหล่านั้นจะได้รับการแจ้งเตือนกิจกรรมจาก Google ปฏิทินตามการตั้งค่าการแจ้งเตือน

หากต้องการเพิ่มกิจกรรมไปยังปฏิทินของผู้จองโดยตรง โปรดแจ้งให้ผู้จองเพิ่มกิจกรรมลงในรายชื่อติดต่อ อีเมลที่จะได้รับคำเชิญ หรือขอให้ผู้จองเข้าถึงปฏิทินของตนเพื่อตอบกลับทางโปรแกรมแทนผู้เข้าร่วม (ตั้งค่าการตอบกลับของผู้เข้าร่วม) และส่งการแจ้งเตือนทางอีเมลเกี่ยวกับการจองที่ได้รับการยืนยันแล้วให้ผู้จอง

หากธุรกิจไม่ต้องการเปิดเผยที่อยู่อีเมลของตน ให้ใช้ที่อยู่อีเมลเฉพาะผู้ใช้เพื่อส่งกิจกรรมไปยังผู้จองโดยใช้อีเมล (เชิญผู้ใช้จากที่อยู่อีเมล)

การเผยแพร่เหตุการณ์

แผนภาพต่อไปนี้จะอธิบายการเปลี่ยนแปลงที่เกิดขึ้น อันดับแรก Jack สร้างกิจกรรมในปฏิทินหลัก ของเขา (และเป็นเจ้าของสำเนาผู้จัดด้วย) จากนั้นก็เชิญปฏิทินรองของกลุ่มบทเรียน Cello และ Susan ซึ่งมีการตั้งค่ากิจกรรม Only if the sender is known ระบบจะสร้างสำเนาผู้เข้าร่วมไว้ในปฏิทินรองของกลุ่มบทเรียน Cello และในปฏิทินของ Susan ถ้าเธอรู้จักกับ Jack มิฉะนั้นเมื่อตอบกลับหรือระบุว่าเธอรู้จัก Jack เมื่อ Susan ตอบกลับ ระบบจะส่งต่อการเปลี่ยนแปลง RSVP กลับไปยังผู้จัด โดยอัปเดตสำเนาของผู้จัดด้วยการตอบกลับของ Susan จากนั้นการเปลี่ยนแปลงที่ดำเนินการกับสำเนาของผู้จัดกิจกรรมจะถูกนำไปเผยแพร่ให้ผู้เข้าร่วมคนอื่นๆ

พร็อพเพอร์ตี้เหตุการณ์ที่แชร์

ปฏิทินที่ใช้สร้างกิจกรรมคือปฏิทินผู้จัด โดยปฏิทินนี้จะเป็นเจ้าของข้อมูลกิจกรรมที่แชร์ ได้แก่ รหัส เวลาเริ่มต้นและสิ้นสุด สรุป และคำอธิบาย เมื่ออัปเดตข้อมูลนี้ในปฏิทินผู้จัด การเปลี่ยนแปลงจะมีผลกับสำเนาของผู้เข้าร่วม

พร็อพเพอร์ตี้ของกิจกรรมส่วนตัว

ข้อมูลบางอย่างจะไม่ถูกแชร์ระหว่างสำเนากิจกรรมทั้งหมด พร็อพเพอร์ตี้บางรายการเป็นแบบส่วนตัว เช่น การช่วยเตือน colorId ความโปร่งใส หรือพร็อพเพอร์ตี้ extendedProperties.private พร็อพเพอร์ตี้เหล่านี้จะควบคุมโดยการตั้งค่าของผู้เข้าร่วม ไม่ใช่ปฏิทินผู้จัด

ผู้เข้าร่วมยังสามารถเปลี่ยนแปลงคุณสมบัติที่แชร์ของกิจกรรมได้ อย่างไรก็ตาม การเปลี่ยนแปลงเหล่านี้จะแสดงในสำเนาของตนเองเท่านั้น และอาจสูญหายหากผู้จัดทำการเปลี่ยนแปลง

การเปลี่ยนแปลงกิจกรรมเพียงอย่างเดียวที่ส่งผลจากผู้เข้าร่วมกลับไปยังผู้จัดคือสถานะการตอบกลับของผู้เข้าร่วมซึ่งจัดเก็บไว้ในพร็อพเพอร์ตี้ attendees[].responseStatus