วิธีใช้โมดูลซูม

โมดูล Zoom อนุญาตให้ทำงานกับ Zoom API ( https://marketplace.zoom.us/docs/guides/ )

การติดตั้งโมดูลซูม

1_zoom_lookNfeel

ต้องดึง API Key และ Secret Key ของแอปพลิเคชัน Zoom ก่อน ( https://marketplace.zoom.us/develop/create?source=devdocs ) ตามลิงค์นี้คุณจะเห็นแอพ Zoom หลายประเภทให้เลือก

zoom_type_of_apps

รหัส API Key ของแอป Zoom และ Secret Key จะแสดงหลังจากเลือกประเภทแอป

zoom_creds

โมเดลข้อมูลการ Meeting และการ Recurrence

เมื่อคุณติดตั้งโมดูล Zoom จะมีการสร้างโมเดลข้อมูลเสมือนสองโมเดลในโปรเจ็กต์ด้วย: Meeting และ การ Recurrence รายการแรกอ้างถึงวัตถุแฮงเอาท์วิดีโอ และการ Recurrence มีหน้าที่รับผิดชอบความสม่ำเสมอ (การเกิดซ้ำ) ของการประชุมทางวิดีโอนี้ BP ต่อไปนี้เป็นตัวช่วยในการสร้างและใช้งานโมเดลข้อมูลเหล่านี้:

Make Zoom Meeting - สร้างวัตถุประเภทโมเดลข้อมูล Meeting :
- Join_url [ string ] - ลิงค์การประชุม;
- start_time [ datetime ] - เวลาเริ่มต้นการประชุม;
- Status [ string ] - สถานะของการประชุม;
- Type [ enum ] - ประเภทการประชุม
  - Instant - การประชุมครั้งเดียวที่ไม่ได้หมายกำหนดการ
  - Scheduled - การประชุมตามกำหนดเวลา
  - Recurring with no fixed time - การประชุมที่เกิดซ้ำโดยไม่มีกำหนดเวลา
  - Recurring with fixed time - เกิดซ้ำตามเวลาที่กำหนด
- Meeting_id [ integer ] - ตัวระบุการประชุม;
- Agenda [ string ] - ข้อมูลวาระการประชุม;
- Topic [ string ] - หัวข้อการประชุม;
- การ Recurrence [ ประเภทของวัตถุที่ recurrence ] - วัตถุของประเภทแบบจำลองข้อมูลการ Recurrence
- Password [ string ] - รหัสผ่านการประชุม;

2_make_meeting

Expand Zoom Meeting - ขยายอ็อบเจกต์ของประเภทโมเดลข้อมูล Meeting
- Join_url [ string ] - ลิงค์การประชุม;
- start_time [ datetime ] - เวลาเริ่มต้นการประชุม;
- Status [ string ] - สถานะของการประชุม;
- Type [ enum ] - ประเภทการประชุม
  - Instant - การประชุมครั้งเดียวที่ไม่ได้หมายกำหนดการ
  - Scheduled - การประชุมตามกำหนดเวลา
  - Recurring with no fixed time - การประชุมที่เกิดซ้ำโดยไม่มีกำหนดเวลา
  - Recurring with fixed time - เกิดซ้ำตามเวลาที่กำหนด
- Meeting_id [ integer ] - ตัวระบุการประชุม;
- Agenda [ string ] - ข้อมูลวาระการประชุม;
- Topic [ string ] - หัวข้อการประชุม;
- การ Recurrence [ ประเภทของวัตถุที่ recurrence ] - วัตถุของประเภทแบบจำลองข้อมูลการ Recurrence
- Password [ string ] - รหัสผ่านการประชุม;

3_expand_meeting

Make Zoom Recurrence - สร้างวัตถุประเภทโมเดลข้อมูลการ Recurrence
- Type [ enum ] - ประเภทของการเกิดซ้ำ
  - Daily
  - Weekly
  - Monthly
- Ends_time [ integer ] - จำนวนครั้งที่การประชุมที่เกิดซ้ำจะเกิดขึ้นก่อนที่จะถูกยกเลิก ระหว่างค่า 1 ถึง 50 คุณไม่สามารถใช้คีย์นี้กับคีย์ end_date_time
- Monthly_day [ integer ] - จำเป็นสำหรับการประชุมที่เกิดซ้ำทุกเดือนเท่านั้น วันของเดือนที่มีการประชุมที่เกิดซ้ำระหว่าง 1 ถึง 31
- Weekly_days [ enum ] - จำเป็นสำหรับการประชุมที่เกิดซ้ำทุกสัปดาห์เท่านั้น (1 - วันจันทร์, 2 - วันอังคาร, … , 7 - วันอาทิตย์)
- Repeat_interval [ integer ] - ช่วงเวลาการประชุมซ้ำ สำหรับช่วงเวลารายวัน สูงสุด 90 วัน สำหรับช่วงเวลารายสัปดาห์ สูงสุด 12 สัปดาห์
- End_date_time [ datetime ] - วันที่และเวลาสุดท้ายของการประชุมที่เกิดซ้ำก่อนที่จะถูกยกเลิก ในรูปแบบ UTC คุณไม่สามารถใช้คีย์นี้กับคีย์ end_times

4_make_recurrence

Expand Zoom Recurrence - ขยายออบเจกต์ประเภทโมเดลข้อมูลการ Recurrence
- Type [ enum ] - ประเภทของการเกิดซ้ำ
  - Daily
  - Weekly
  - Monthly
- Ends_time [ integer ] - จำนวนครั้งที่การประชุมที่เกิดซ้ำจะเกิดขึ้นก่อนที่จะถูกยกเลิก ระหว่างค่า 1 ถึง 50 คุณไม่สามารถใช้คีย์นี้กับคีย์ end_date_time
- Monthly_day [ integer ] - จำเป็นสำหรับการประชุมที่เกิดซ้ำทุกเดือนเท่านั้น วันของเดือนที่มีการประชุมที่เกิดซ้ำระหว่างวันที่ 1 ถึง 31
- Weekly_days [ enum ] - จำเป็นสำหรับการประชุมที่เกิดซ้ำทุกสัปดาห์เท่านั้น (1 - วันจันทร์, 2 - วันอังคาร, … , 7 - วันอาทิตย์)
- Repeat_interval [ integer ] - ช่วงเวลาการประชุมซ้ำ สำหรับช่วงเวลารายวัน สูงสุด 90 วัน สำหรับช่วงเวลารายสัปดาห์ สูงสุด 12 สัปดาห์
- End_date_time [ datetime ] - วันที่และเวลาสุดท้ายของการประชุมที่เกิดซ้ำก่อนที่จะถูกยกเลิก ในรูปแบบ UTC คุณไม่สามารถใช้คีย์นี้กับคีย์ end_times

5_expand_recurrence

กระบวนการทางธุรกิจที่ทำงานร่วมกับ Zoom Module

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

Zoom: Get meeting - รับวัตถุการประชุมด้วยตัวระบุที่กำหนด:
- Meeting_id [ integer ] - ตัวระบุการประชุม;

6_getMeeting

Zoom: Delete meeting - ลบบันทึกการประชุมจาก DB ด้วยตัวระบุที่กำหนด
- Meeting_id [ integer ] (จำเป็น) - ตัวระบุการประชุม;

7_deleteMeeting

Zoom: Update meeting - อัปเดตวัตถุการประชุมใน DB ด้วยตัวระบุที่กำหนด:
- Meeting_id [ integer ] (จำเป็น) - ตัวระบุการประชุม;
- Topic [ string ] - หัวข้อการประชุม;
- Type [ enum ] - ประเภทการประชุม
  - Instant - การประชุมครั้งเดียวที่ไม่ได้หมายกำหนดการ
  - Scheduled - การประชุมตามกำหนดเวลา
  - Recurring with no fixed time - การประชุมที่เกิดซ้ำโดยไม่มีกำหนดเวลา
  - Recurring with fixed time - เกิดซ้ำตามเวลาที่กำหนด
- start_time [ datetime ] - เวลาเริ่มต้นการประชุม;
- Join_url [ string ] - ลิงค์การประชุม;
- Password [ string ] - รหัสผ่านการประชุม;
- Agenda [ string ] - ข้อมูลวาระการประชุม;
- การ Recurrence [ ประเภทของวัตถุที่ recurrence ] - วัตถุของประเภทแบบจำลองข้อมูลการ Recurrence

8_updateMeeting

Zoom: Create Meeting - สร้างวัตถุประเภทโมเดลข้อมูล Meeting :
- Type [ enum ] - ประเภทการประชุม
  - Instant - การประชุมครั้งเดียวที่ไม่ได้หมายกำหนดการ
  - Scheduled - การประชุมตามกำหนดเวลา
  - Recurring with no fixed time - การประชุมที่เกิดซ้ำโดยไม่มีกำหนดเวลา
  - Recurring with fixed time - เกิดซ้ำตามเวลาที่กำหนด
- Password [ string ] - รหัสผ่านการประชุม;
- Agenda [ string ] - ข้อมูลวาระการประชุม;
- การ Recurrence [ ประเภทของวัตถุที่ recurrence ] - วัตถุของประเภทแบบจำลองข้อมูลการ Recurrence
- User_id [ string ] (จำเป็น) - ID ผู้ใช้หรือที่อยู่อีเมล

9_createMeeting

Zoom: List meetings - ใช้ API นี้เพื่อแสดงรายการการประชุมตามกำหนดการของผู้ใช้ (โฮสต์การประชุม) ผู้ใช้ถูกกำหนดด้วย API_KEY ;
- Page_size [ integer ] - จำนวนระเบียนที่ส่งคืนภายในการเรียก API ครั้งเดียว ถูกกำหนดเป็น 30 โดยค่าเริ่มต้น
- Page_number [ integer ] - หมายเลขหน้าของหน้าปัจจุบันในบันทึกที่ส่งคืน ตั้งค่าเป็น 1 โดยค่าเริ่มต้น

10_listMeetings

ตัวอย่างการใช้งาน

มาดูตัวอย่างการสร้างลิงก์การประชุม Zoom เมื่อคลิกปุ่ม หากต้องการใช้กระบวนการทางธุรกิจของโมดูลในส่วนหน้าของแอปพลิเคชัน ขั้นตอนแรกคือการตั้งค่าจุด Endpoint เพื่อสร้างการสร้างลิงก์ ( Zoom: Create meeting )

สร้างกลุ่มใหม่ในส่วน Endpoints
เมื่อสร้างกลุ่มแล้ว คุณต้องสร้างจุด Endpoint ใหม่ Zoom: Create meeting ควรถือเป็นคำขอประเภท POST
ในกระบวนการทางธุรกิจของเว็บแอปพลิเคชัน จุดสิ้นสุดที่สร้างขึ้นใหม่สามารถใช้ได้ตามตัวอย่างด้านล่าง ที่นี่ ลิงก์ถูกสร้างขึ้นและระบุเป็นคุณสมบัติ Label ของส่วนประกอบ Label เมื่อคลิกปุ่ม ( onClick )