zoom_rb 0.10.0 → 0.11.0

data/lib/zoom/actions/groups.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Zoom
+  module Actions
+    module Groups
+      def groups_list(*_args)
+        Utils.parse_response self.class.get('/groups', headers: request_headers)
+      end
+
+      def groups_get(*args)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(:group_id)
+        Utils.parse_response self.class.get("/groups/#{params[:group_id]}", headers: request_headers)
+      end
+    end
+  end
+end

data/lib/zoom/actions/im/chat.rb

@@ -4,12 +4,24 @@ module Zoom
   module Actions
     module IM
       module Chat
+        def get_chat_channels(*args)
+          params = Zoom::Params.new(Utils.extract_options!(args))
+          params.require(:channel_id)
+          Utils.parse_response self.class.get("/chat/channels/#{params[:channel_id]}", headers: request_headers)
+        end
+
+        def get_chat_user_channels(*args)
+          params = Zoom::Params.new(Utils.extract_options!(args))
+          params.require(:user_id).permit(%i[next_page_token page_size])
+          Utils.parse_response self.class.get("/chat/users/#{params[:user_id]}/channels", query: params.except(:user_id), headers: request_headers)
+        end
+
         # Get chat messages for a specified period.
         def chat_get(*args)
           options = Utils.extract_options!(args)
           Zoom::Params.new(options).require(:access_token, :session_id, :from, :to)
-          # TODO handle date format for `from` and `to` params
-          # TODO implement `next_page_token`, will be returned whenever the set of available chat history list exceeds 100. The expiration period is 30 minutes.
+          # TODO: handle date format for `from` and `to` params
+          # TODO: implement `next_page_token`, will be returned whenever the set of available chat history list exceeds 100. The expiration period is 30 minutes.
           Utils.parse_response self.class.post('/chat/get', query: options)
         end
 
@@ -17,8 +29,8 @@ module Zoom
         def chat_list(*args)
           options = Utils.extract_options!(args)
           Zoom::Params.new(options).require(:access_token, :from, :to)
-          # TODO handle date format for `from` and `to` params
-          # TODO implement `next_page_token`, will be returned whenever the set of available chat history list exceeds 100. The expiration period is 30 minutes.
+          # TODO: handle date format for `from` and `to` params
+          # TODO: implement `next_page_token`, will be returned whenever the set of available chat history list exceeds 100. The expiration period is 30 minutes.
           Utils.parse_response self.class.post('/chat/list', query: options)
         end
       end

data/lib/zoom/actions/meeting.rb

@@ -5,84 +5,92 @@ module Zoom
     module Meeting
       # List all the scheduled meetings on Zoom.
       def meeting_list(*args)
-        options = Zoom::Params.new(Utils.extract_options!(args))
-        options.require(%i[user_id])
-        Utils.parse_response self.class.get("/users/#{options[:user_id]}/meetings", query: options.except(:user_id), headers: request_headers)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(:user_id).permit(%i[type page_size next_page_token page_number])
+        Utils.parse_response self.class.get("/users/#{params[:user_id]}/meetings", query: params.except(:user_id), headers: request_headers)
       end
 
       # Create a meeting on Zoom, return the created meeting URL
       def meeting_create(*args)
-        options = Zoom::Params.new(Utils.extract_options!(args))
-        options.require(%i[user_id])
-        Utils.process_datetime_params!(:start_time, options)
-        Utils.parse_response self.class.post("/users/#{options[:user_id]}/meetings", body: options.except(:user_id).to_json, headers: request_headers)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(:user_id).permit(%i[topic type start_time duration schedule_for timezone password agenda tracking_fields recurrence settings])
+        Utils.process_datetime_params!(:start_time, params)
+        Utils.parse_response self.class.post("/users/#{params[:user_id]}/meetings", body: params.except(:user_id).to_json, headers: request_headers)
       end
 
       # Get a meeting on Zoom via meeting ID, return the meeting info.
       def meeting_get(*args)
-        options = Zoom::Params.new(Utils.extract_options!(args))
-        options.require(%i[meeting_id])
-        Utils.parse_response self.class.get("/meetings/#{options[:meeting_id]}", headers: request_headers)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(:meeting_id).permit(%i[occurrence_id show_previous_occurrences])
+        Utils.parse_response self.class.get("/meetings/#{params[:meeting_id]}", query: params.except(:meeting_id), headers: request_headers)
       end
 
       # Update meeting info on Zoom via meeting ID.
       def meeting_update(*args)
-        options = Zoom::Params.new(Utils.extract_options!(args))
-        options.require(%i[meeting_id])
-        Utils.process_datetime_params!(:start_time, options)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(:meeting_id)
+        Utils.process_datetime_params!(:start_time, params)
         # TODO Handle `topic` attr, Max of 300 characters.
         # TODO Handle `timezone` attr, refer to the id value in timezone list JSON file. like "America/Los_Angeles"
         # TODO Verify `password` attr, may only contain the following characters: a-z A-Z 0-9 @ - _
         # TODO Handle `option_audio` attr, Can be "both", "telephony", "voip".
         # TODO Handle `option_auto_record_type`, Can be "local", “cloud” or "none".
-        Utils.parse_response self.class.patch("/meetings/#{options[:meeting_id]}", body: options.except(:meeting_id).to_json, headers: request_headers)
+        Utils.parse_response self.class.patch("/meetings/#{params[:meeting_id]}", body: params.except(:meeting_id).to_json, headers: request_headers)
       end
 
       # Delete a meeting on Zoom, return the deleted meeting ID.
       def meeting_delete(*args)
-        options = Zoom::Params.new(Utils.extract_options!(args))
-        options.require(%i[meeting_id])
-        Utils.parse_response self.class.delete("/meetings/#{options[:meeting_id]}", query: options.except(:meeting_id), headers: request_headers)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(:meeting_id)
+        Utils.parse_response self.class.delete("/meetings/#{params[:meeting_id]}", query: params.except(:meeting_id), headers: request_headers)
       end
 
       # Update a meeting's status
       def meeting_update_status(*args)
-        options = Zoom::Params.new(Utils.extract_options!(args))
-        options.require(%i[meeting_id])
-        Utils.parse_response self.class.put("/meetings/#{options[:meeting_id]}/status", body: options.except(:meeting_id).to_json, headers: request_headers)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(:meeting_id).permit(:action)
+        Utils.parse_response self.class.put("/meetings/#{params[:meeting_id]}/status", body: params.except(:meeting_id).to_json, headers: request_headers)
       end
 
-      # End a meeting on Zoom, return the deleted meeting ID.
-      def meeting_end(*args)
-        options = Utils.extract_options!(args)
-        meeting_update_status(options.merge(action: 'end'))
-      end
-
-      # Lists the live meetings on Zoom.
-      def meeting_live(*args)
-        options = Utils.extract_options!(args)
-        meeting_list(options.merge(type: 'live'))
+      # Register for a meeting.
+      def meeting_add_registrant(*args)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(%i[meeting_id email first_name]).permit(%i[last_name address city country zip state phone industry org job_title purchasing_time_frame role_in_purchase_process no_of_employees comments custom_questions language occurrence_ids])
+        Utils.parse_response self.class.post("/meetings/#{params[:meeting_id]}/registrants", query: params.slice(:occurrence_ids), body: params.except(:meeting_id).to_json, headers: request_headers)
       end
 
       # Register for a meeting.
-      def meeting_register(*args)
-        options = Zoom::Params.new(Utils.extract_options!(args))
-        options.require(%i[meeting_id email first_name last_name])
-        Utils.parse_response self.class.post("/meetings/#{options[:meeting_id]}/registrants", body: options.except(:meeting_id).to_json, headers: request_headers)
+      def meeting_registrant_questions(*args)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(:meeting_id)
+        Utils.parse_response self.class.patch("/meetings/#{params[:meeting_id]}/registrants/questions", body: params.except(:meeting_id).to_json, headers: request_headers)
       end
 
       # Retrieve ended meeting details
       def past_meeting_details(*args)
-        options = Zoom::Params.new(Utils.extract_options!(args))
-        options.require(%i[meeting_uuid])
-        Utils.parse_response self.class.get("/past_meetings/#{options[:meeting_uuid]}", headers: request_headers)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(:meeting_uuid)
+        Utils.parse_response self.class.get("/past_meetings/#{params[:meeting_uuid]}", headers: request_headers)
       end
 
       # Retrieve ended meeting participants
       def past_meeting_participants(*args)
-        options = Zoom::Params.new(Utils.extract_options!(args))
-        options.require(%i[meeting_uuid])
-        Utils.parse_response self.class.get("/past_meetings/#{options[:meeting_uuid]}/participants", headers: request_headers)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(:meeting_uuid)
+        Utils.parse_response self.class.get("/past_meetings/#{params[:meeting_uuid]}/participants", headers: request_headers)
+      end
+
+      def livestream(*args)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(%i[meeting_id stream_url stream_key]).permit(:page_url)
+        Utils.parse_response self.class.patch("/meetings/#{params[:meeting_id]}/livestream", body: params.except(:meeting_id).to_json, headers: request_headers)
+      end
+
+      # Get a meeting on Zoom via meeting ID, return the meeting info.
+      def meeting_invitation(*args)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(:meeting_id)
+        Utils.parse_response self.class.get("/meetings/#{params[:meeting_id]}/invitation", headers: request_headers)
       end
     end
   end

data/lib/zoom/actions/phone.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+#
+module Zoom
+  module Actions
+    module Phone
+      def call_logs(*args)
+        options = Zoom::Params.new(Utils.extract_options!(args))
+        options.require(%i[user_id])
+        response = self.class.get("/phone/users/#{options[:user_id]}/call_logs", query: options.except(:user_id), headers: request_headers)
+        Utils.parse_response(response)
+      end
+
+      def phone_users_list(*args)
+        options = Zoom::Params.new(Utils.extract_options!(args))
+        response = self.class.get("/phone/users", query: options, headers: request_headers)
+        Utils.parse_response(response)
+      end
+
+      def call_recordings(*args)
+        options = Zoom::Params.new(Utils.extract_options!(args))
+        options.require(%i[user_id])
+        response = self.class.get("/phone/users/#{options[:user_id]}/recordings", query: options.except(:user_id), headers: request_headers)
+        Utils.parse_response(response)
+      end
+    end
+  end
+end

data/lib/zoom/actions/recording.rb

@@ -3,30 +3,39 @@
 module Zoom
   module Actions
     module Recording
+      RECORDING_SETTINGS_KEYS = %i[share_recording recording_authentication
+                                   authentication_option authentication_domains viewer_download password
+                                   on_demand approval_type send_email_to_host show_social_share_buttons].freeze
+
       def recording_list(*args)
-        options = Utils.extract_options!(args)
-        Zoom::Params.new(options).require(:host_id)
+        options = Zoom::Params.new(Utils.extract_options!(args))
+        options.require(:user_id)
         Utils.process_datetime_params!(%i[from to], options)
-        Utils.parse_response self.class.post('/recording/list', query: options)
+        Utils.parse_response self.class.get("/users/#{options[:user_id]}/recordings", query: options.except(:user_id), headers: request_headers)
       end
 
-      def mc_recording_list(*args)
-        options = Utils.extract_options!(args)
-        Zoom::Params.new(options).require(:host_id)
-        Utils.process_datetime_params!(%i[from to], options)
-        Utils.parse_response self.class.post('/mc/recording/list', query: options)
+      def meeting_recording_get(*args)
+        options = Zoom::Params.new(Utils.extract_options!(args))
+        options.require(:meeting_id)
+        Utils.parse_response self.class.get("/meetings/#{options[:meeting_id]}/recordings/settings", query: options.except(:meeting_id), headers: request_headers)
+      end
+
+      def meeting_recording_settings_get(*args)
+        options = Zoom::Params.new(Utils.extract_options!(args))
+        options.require(:meeting_id)
+        Utils.parse_response self.class.get("/meetings/#{options[:meeting_id]}/recordings/settings", query: options.except(:meeting_id), headers: request_headers)
       end
 
-      def recording_get(*args)
-        options = Utils.extract_options!(args)
-        Zoom::Params.new(options).require(:meeting_id)
-        Utils.parse_response self.class.post('/recording/get', query: options)
+      def meeting_recording_settings_update(*args)
+        options = Zoom::Params.new(Utils.extract_options!(args))
+        options.require(:meeting_id).permit(RECORDING_SETTINGS_KEYS)
+        Utils.parse_response self.class.patch("/meetings/#{options[:meeting_id]}/recordings/settings", body: options.except(:meeting_id).to_json, headers: request_headers)
       end
 
-      def recording_delete(*args)
-        options = Utils.extract_options!(args)
-        Zoom::Params.new(options).require(:meeting_id)
-        Utils.parse_response self.class.post('/recording/delete', query: options)
+      def meeting_recording_file_delete(*args)
+        options = Zoom::Params.new(Utils.extract_options!(args))
+        options.require(%i[meeting_id recording_id])
+        Utils.parse_response self.class.delete("/meetings/#{options[:meeting_id]}/recordings/#{options[:recording_id]}",  query: options.except(:meeting_id, :recording_id), headers: request_headers)
       end
     end
   end

data/lib/zoom/actions/report.rb

@@ -5,50 +5,25 @@ module Zoom
     module Report
       def daily_report(*args)
         params = Zoom::Params.new(Utils.extract_options!(args))
-        params.permit(:year, :month)
+        params.permit(%i[year month])
         Utils.parse_response self.class.get('/report/daily', query: params, headers: request_headers)
       end
-
-      def hosts_report(*args)
-        # TODO: implement hosts_report
-      end
-
-      def meetings_report(*args)
-        # TODO: implement meetings_report
-      end
-
       def meeting_details_report(*args)
-        # TODO: implement meeting_details_report
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(:id)
+        Utils.parse_response self.class.get("/report/meetings/#{params[:id]}", query: params.except(:id), headers: request_headers)
       end
 
       def meeting_participants_report(*args)
-        # TODO: implement meeting_participants_report
-      end
-
-      def meeting_polls_report(*args)
-        # TODO: implement meeting_polls_report
-      end
-
-      def webinar_details_report(*args)
-        # TODO: implement webinar_details_report
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(:id).permit(%i[page_size next_page_token])
+        Utils.parse_response self.class.get("/report/meetings/#{params[:id]}/participants", query: params.except(:id), headers: request_headers)
       end
 
       def webinar_participants_report(*args)
         params = Zoom::Params.new(Utils.extract_options!(args))
-        params.require(:id).permit(:page_size, :next_page_token)
-        Utils.parse_response self.class.get("/report/webinars/#{params[:id]}/participants", query: params.except(:id).merge(access_token: access_token))
-      end
-
-      def webinar_polls_report(*args)
-        # TODO: implement report_hosts
-      end
-
-      def webinar_qa_report(*args)
-        # TODO: implement report_hosts
-      end
-
-      def telephone_report(*args)
-        # TODO: implement report_hosts
+        params.require(:id).permit(%i[page_size next_page_token])
+        Utils.parse_response self.class.get("/report/webinars/#{params[:id]}/participants", query: params.except(:id), headers: request_headers)
       end
     end
   end

data/lib/zoom/actions/roles.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Zoom
+  module Actions
+    module Roles
+      def roles_list(*_args)
+        Utils.parse_response self.class.get("/roles", headers: request_headers)
+      end
+
+      def roles_create(*args)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(:name).permit(%i[description privileges])
+        Utils.parse_response self.class.post("/roles", body: params.to_json, headers: request_headers)
+      end
+
+      def roles_members(*args)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(:role_id)
+        Utils.parse_response self.class.get("/roles/#{params[:role_id]}/members", headers: request_headers)
+      end
+
+      def roles_assign(*args)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(%i[role_id members])
+        Utils.parse_response self.class.post("/roles/#{params[:role_id]}/members", body: params.except(:role_id).to_json, headers: request_headers)
+      end
+
+      def roles_unassign(*args)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(%i[role_id member_id])
+        Utils.parse_response self.class.delete("/roles/#{params[:role_id]}/members/#{params[:member_id]}", headers: request_headers)
+      end
+
+      def roles_get(*args)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(:role_id)
+        Utils.parse_response self.class.get("/roles/#{params[:role_id]}", headers: request_headers)
+      end
+    end
+  end
+end

data/lib/zoom/actions/sip_audio.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module Zoom
+  module Actions
+    module SipAudio
+      def sip_trunks_get(*args)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(:account_id)
+        Utils.parse_response self.class.get("/accounts/#{params[:account_id]}/sip_trunk/trunks", headers: request_headers)
+      end
+
+      def sip_trunks_delete(*args)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(:account_id, :trunk_id)
+        Utils.parse_response self.class.delete("/accounts/#{params[:account_id]}/sip_trunk/trunks/#{params[:trunk_id]}", headers: request_headers)
+      end
+
+      def sip_trunk_numbers_delete(*args)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(:account_id)
+        Utils.parse_response self.class.delete("/accounts/#{params[:account_id]}/sip_trunk/numbers", headers: request_headers)
+      end
+
+      def sip_trunks_internal_numbers_delete(*args)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(%i[account_id number_id])
+        Utils.parse_response self.class.delete("/accounts/#{params[:account_id]}/sip_trunk/internal_numbers/#{params[:number_id]}", headers: request_headers)
+      end
+
+      def sip_trunks_internal_callout_country_delete(*args)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(%i[account_id country_id])
+        Utils.parse_response self.class.delete("/accounts/#{params[:account_id]}/sip_trunk/callout_countries/#{params[:country_id]}", headers: request_headers)
+      end
+
+      def sip_trunks_internal_numbers_list(*args)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(:account_id).permit(%i[page_size next_page_token])
+        response = self.class.get("/accounts/#{params[:account_id]}/sip_trunk/internal_numbers", query: params, headers: request_headers)
+        Utils.parse_response(response)
+      end
+
+      def sip_trunks_internal_callout_country_list(*args)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(:account_id)
+        response = self.class.get("/accounts/#{params[:account_id]}/sip_trunk/callout_countries", headers: request_headers)
+        Utils.parse_response(response)
+      end
+
+      def sip_trunks_numbers_list(*args)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        response = self.class.get("/sip_trunk/numbers", headers: request_headers)
+        Utils.parse_response(response)
+      end
+
+      def sip_trunks_internal_numbers_add(*args)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(:account_id)
+        Utils.parse_response self.class.post("/accounts/#{params[:account_id]}/sip_trunk/internal_numbers", headers: request_headers)
+      end
+
+      def sip_trunks_internal_callout_countries_add(*args)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(:account_id)
+        Utils.parse_response self.class.post("/accounts/#{params[:account_id]}/sip_trunk/callout_countries", headers: request_headers)
+      end
+
+      def sip_trunks_numbers_assign(*args)
+        params = Zoom::Params.new(Utils.extract_options!(args))
+        params.require(:account_id)
+        Utils.parse_response self.class.post("/accounts/#{params[:account_id]}/sip_trunk/numbers", headers: request_headers)
+      end
+    end
+  end
+end