Cách sử dụng mô-đun Zoom

Mô-đun thu Zoom cho phép làm việc với Zoom API ( https://marketplace.zoom.us/docs/guides/ ).

Cài đặt mô-đun thu phóng

1_zoom_lookNfeel

API Key Secret Key của ứng dụng Zoom của bạn trước tiên cần được truy xuất ( https://marketplace.zoom.us/develop/create?source=devdocs ). Theo liên kết, bạn sẽ thấy một số loại ứng dụng Zoom để lựa chọn.

zoom_type_of_apps

API Key Secret Key của ứng dụng Zoom sẽ được hiển thị sau khi chọn loại ứng dụng.

zoom_creds

Mô hình dữ liệu Meeting và Recurrence

Khi bạn cài đặt mô-đun Zoom , hai mô hình dữ liệu ảo cũng được tạo trong dự án: Meeting và Recurrence lại. Đầu tiên đề cập đến chính đối tượng cuộc gọi điện video và Recurrence lại chịu trách nhiệm về tính thường xuyên (sự lặp lại) của cuộc họp video này. Các BP sau đây là phụ trợ trong việc tạo và sử dụng các mô hình dữ liệu này:

Make Zoom Meeting - tạo một đối tượng của loại mô hình dữ liệu Meeting :
- Join_url [ string ] - liên kết cuộc họp;
- start_time [ datetime ] - thời gian bắt đầu cuộc họp;
- Status [ string ] - trạng thái của cuộc họp;
- Type [ enum ] - loại cuộc họp
  - Cuộc họp Instant - đột xuất, một lần
  - Scheduled - cuộc họp theo lịch trình
  - Recurring with no fixed time - cuộc họp định kỳ không có thời gian cố định
  - Recurring with fixed time - định kỳ với thời gian cố định
- Meeting_id [ integer ] - số nhận dạng cuộc họp;
- Agenda [ string ] - thông tin chương trình cuộc họp;
- Topic [ string ] - chủ đề cuộc họp;
- Recurrence recurrence [ kiểu đối tượng lặp lại] - đối tượng của kiểu mô hình dữ liệu Recurrence lại;
- Password [ string ] - mật khẩu cuộc họp;

2_make_meeting

Expand Zoom Meeting thu phóng - mở rộng một đối tượng thuộc loại mô hình dữ liệu Meeting ;
- Join_url [ string ] - liên kết cuộc họp;
- start_time [ datetime ] - thời gian bắt đầu cuộc họp;
- Status [ string ] - trạng thái của cuộc họp;
- Type [ enum ] - loại cuộc họp
  - Cuộc họp Instant - đột xuất, một lần
  - Scheduled - cuộc họp theo lịch trình
  - Recurring with no fixed time - cuộc họp định kỳ không có thời gian cố định
  - Recurring with fixed time - định kỳ với thời gian cố định
- Meeting_id [ integer ] - số nhận dạng cuộc họp;
- Agenda [ string ] - thông tin chương trình cuộc họp;
- Topic [ string ] - chủ đề cuộc họp;
- Recurrence recurrence [ kiểu đối tượng lặp lại] - đối tượng của kiểu mô hình dữ liệu Recurrence lại;
- Password [ string ] - mật khẩu cuộc họp;

3_expand_meeting

Make Zoom Recurrence - tạo một đối tượng thuộc loại mô hình dữ liệu Recurrence lại;
- Type [ enum ] - loại lặp lại
  - Daily
  - Weekly
  - Monthly
- Ends_time [ integer ] - số lần cuộc họp định kỳ sẽ diễn ra trước khi nó bị hủy, nằm trong khoảng giá trị từ 1 đến 50. Bạn không thể sử dụng khóa này với khóa end_date_time .
- Monthly_day [ integer ] - chỉ bắt buộc đối với các cuộc họp định kỳ hàng tháng. Ngày của tháng diễn ra cuộc họp định kỳ, từ ngày 1 đến ngày 31.
- Weekly_days [ enum ] - chỉ bắt buộc đối với các cuộc họp định kỳ hàng tuần (1 - Thứ Hai, 2 - Thứ Ba, …, 7 - Chủ nhật).
- Repeat_interval [ integer ] - khoảng thời gian lặp lại của cuộc họp. Đối với khoảng thời gian hàng ngày, tối đa là 90 ngày. Đối với khoảng thời gian hàng tuần, tối đa là 12 tuần.
- End_date_time [ datetime ] - ngày và giờ kết thúc cuối cùng của cuộc họp định kỳ trước khi nó bị hủy, ở định dạng UTC. Bạn không thể sử dụng khóa này với khóa end_times .

4_make_recurrence

Expand Zoom Recurrence lại - mở rộng một đối tượng của loại mô hình dữ liệu Recurrence lại;
- Type [ enum ] - loại lặp lại
  - Daily
  - Weekly
  - Monthly
- Ends_time [ integer ] - số lần cuộc họp định kỳ sẽ diễn ra trước khi nó bị hủy, nằm trong khoảng giá trị từ 1 đến 50. Bạn không thể sử dụng khóa này với khóa end_date_time .
- Monthly_day [ integer ] - chỉ bắt buộc đối với các cuộc họp định kỳ hàng tháng. Ngày của tháng diễn ra cuộc họp định kỳ, từ ngày 1 đến ngày 31.
- Weekly_days [ enum ] - chỉ bắt buộc đối với các cuộc họp định kỳ hàng tuần (1 - Thứ Hai, 2 - Thứ Ba, …, 7 - Chủ nhật).
- Repeat_interval [ integer ] - khoảng thời gian lặp lại của cuộc họp. Đối với khoảng thời gian hàng ngày, tối đa là 90 ngày. Đối với khoảng thời gian hàng tuần, tối đa là 12 tuần.
- End_date_time [ datetime ] - ngày và giờ kết thúc cuối cùng của cuộc họp định kỳ trước khi nó bị hủy, ở định dạng UTC. Bạn không thể sử dụng khóa này với khóa end_times .

5_expand_recurrence

Quy trình kinh doanh hoạt động với Zoom Module

Các quy trình kinh doanh của mô-đun Zoom được cài đặt sẵn chỉ khả dụng cho phần phụ trợ của ứng dụng:

Zoom: Get meeting - nhận đối tượng cuộc họp với số nhận dạng đã cho:
- Meeting_id [ integer ] - số nhận dạng cuộc họp;

6_getMeeting

Zoom: Delete meeting - xóa bản ghi cuộc họp khỏi DB với số nhận dạng đã cho;
- Meeting_id [ integer ] (bắt buộc) - số nhận dạng cuộc họp;

7_deleteMeeting

Zoom: Update meeting - cập nhật đối tượng cuộc họp trong DB với mã định danh đã cho:
- Meeting_id [ integer ] (bắt buộc) - số nhận dạng cuộc họp;
- Topic [ string ] - chủ đề cuộc họp;
- Type [ enum ] - loại cuộc họp
  - Cuộc họp Instant - đột xuất, một lần
  - Scheduled - cuộc họp theo lịch trình
  - Recurring with no fixed time - cuộc họp định kỳ không có thời gian cố định
  - Recurring with fixed time - định kỳ với thời gian cố định
- start_time [ datetime ] - thời gian bắt đầu cuộc họp;
- Join_url [ string ] - liên kết cuộc họp;
- Password [ string ] - mật khẩu cuộc họp;
- Agenda [ string ] - thông tin chương trình cuộc họp;
- Recurrence recurrence [ kiểu đối tượng lặp lại] - đối tượng của kiểu mô hình dữ liệu Recurrence lại;

8_updateMeeting

Zoom: Create Meeting - tạo một đối tượng của loại mô hình dữ liệu Meeting :
- Type [ enum ] - loại cuộc họp
  - Cuộc họp Instant - đột xuất, một lần
  - Scheduled - cuộc họp theo lịch trình
  - Recurring with no fixed time - cuộc họp định kỳ không có thời gian cố định
  - Recurring with fixed time - định kỳ với thời gian cố định
- Password [ string ] - mật khẩu cuộc họp;
- Agenda [ string ] - thông tin chương trình cuộc họp;
- Recurrence recurrence [ kiểu đối tượng lặp lại] - đối tượng của kiểu mô hình dữ liệu Recurrence lại;
- User_id [ string ] (bắt buộc) - ID hoặc địa chỉ email của người dùng.

9_createMeeting

Zoom: List meetings - sử dụng API này để liệt kê các cuộc họp đã lên lịch của người dùng (máy chủ cuộc họp). Người dùng được xác định bằng API_KEY của nó;
- Page_size [ integer ] - số lượng bản ghi được trả về trong một lệnh gọi API . Được đặt thành 30 theo mặc định.
- Page_number [ integer ] - số trang của trang hiện tại trong các bản ghi được trả về. Được đặt thành 1 theo mặc định.

10_listMeetings

ví dụ sử dụng

Hãy xem một ví dụ về cách tạo liên kết cuộc họp Zoom khi nhấp vào nút. Để sử dụng các quy trình nghiệp vụ của module trong front-end của ứng dụng, bước đầu tiên là thiết lập Endpoint để tạo liên kết ( Zoom: Create meeting ).

Tạo một nhóm mới trong phần Endpoints .
Khi nhóm được tạo, bạn cần tạo một Endpoint mới. Zoom: Create meeting nên được coi là một loại yêu cầu POST .
Trong quy trình kinh doanh ứng dụng web, điểm cuối mới được tạo có thể được sử dụng như trong ví dụ bên dưới. Tại đây, một liên kết được tạo và cung cấp dưới dạng thuộc tính Label của thành phần Label khi nút được nhấp ( onClick ) .