zoom_rb 0.10.0 → 1.0.2

data/lib/zoom/actions/meeting.rb

@@ -3,87 +3,62 @@
 module Zoom
   module Actions
     module Meeting
+      extend Zoom::Actions
+
       # 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)
-      end
+      get 'meeting_list', '/users/:user_id/meetings',
+        permit: %i[type page_size next_page_token page_number]
 
       # 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)
-      end
+      post 'meeting_create', '/users/:user_id/meetings',
+        permit: %i[
+          topic type start_time duration schedule_for timezone password agenda tracking_fields
+          recurrence settings template_id
+        ]
 
       # 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)
-      end
+      get 'meeting_get', '/meetings/:meeting_id/',
+        permit: %i[occurrence_id show_previous_occurrences]
 
       # 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)
-        # 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)
-      end
+      # 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".
+      patch 'meeting_update', '/meetings/:meeting_id'
 
       # 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)
-      end
+      delete 'meeting_delete', '/meetings/:meeting_id'
 
       # 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)
-      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
+      put 'meeting_update_status', '/meetings/:meeting_id/status',
+        permit: :action
 
-      # Lists the live meetings on Zoom.
-      def meeting_live(*args)
-        options = Utils.extract_options!(args)
-        meeting_list(options.merge(type: 'live'))
-      end
+      # Register for a meeting.
+      post 'meeting_add_registrant', '/meetings/:meeting_id/registrants',
+        require: %i[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
+        ]
 
       # 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)
-      end
+      patch 'meeting_registrant_questions', '/meeting/:meeting_id/registrants/questions'
 
       # 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)
-      end
+      get 'past_meeting_details', '/past_meetings/:meeting_uuid'
 
       # 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)
-      end
+      get 'past_meeting_participants', '/past_meetings/:meeting_uuid/participants'
+
+      patch 'livestream', '/meetings/:meeting_id/livestream',
+        require: %i[stream_url stream_key],
+        permit: :page_url
+
+      # Get a meeting on Zoom via meeting ID, return the meeting info.
+      get 'meeting_invitation', '/meetings/:meeting_id/invitation'
     end
   end
 end

data/lib/zoom/actions/phone.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+#
+module Zoom
+  module Actions
+    module Phone
+      extend Zoom::Actions
+
+      get 'call_logs', '/phone/users/:user_id/call_logs'
+
+      get 'phone_users_list', '/phone/users'
+
+      get 'call_recordings', '/phone/users/:user_id/recordings'
+    end
+  end
+end

data/lib/zoom/actions/recording.rb

@@ -3,31 +3,22 @@
 module Zoom
   module Actions
     module Recording
-      def 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('/recording/list', query: options)
-      end
+      extend Zoom::Actions
 
-      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)
-      end
+      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_get(*args)
-        options = Utils.extract_options!(args)
-        Zoom::Params.new(options).require(:meeting_id)
-        Utils.parse_response self.class.post('/recording/get', query: options)
-      end
+      get 'recording_list', '/users/:user_id/recordings'
 
-      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)
-      end
+      get 'meeting_recording_get', '/meetings/:meeting_id/recordings'
+
+      get 'meeting_recording_settings_get', '/meetings/:meeting_id/recordings/settings'
+
+      patch 'meeting_recording_settings_update', '/meetings/:meeting_id/recordings/settings',
+        permit: RECORDING_SETTINGS_KEYS
+
+      delete 'meeting_recording_file_delete', '/meetings/:meeting_id/recordings/:recording_id'
     end
   end
 end

data/lib/zoom/actions/report.rb

@@ -3,53 +3,18 @@
 module Zoom
   module Actions
     module Report
-      def daily_report(*args)
-        params = Zoom::Params.new(Utils.extract_options!(args))
-        params.permit(:year, :month)
-        Utils.parse_response self.class.get('/report/daily', query: params, headers: request_headers)
-      end
+      extend Zoom::Actions
 
-      def hosts_report(*args)
-        # TODO: implement hosts_report
-      end
+      get 'daily_report', '/report/daily',
+        permit: %i[year month]
 
-      def meetings_report(*args)
-        # TODO: implement meetings_report
-      end
+      get 'meeting_details_report', '/report/meetings/:id'
 
-      def meeting_details_report(*args)
-        # TODO: implement meeting_details_report
-      end
+      get 'meeting_participants_report', '/report/meetings/:id/participants',
+        permit: %i[page_size next_page_token]
 
-      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
-      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
-      end
+      get 'webinar_participants_report', '/report/webinars/:id/participants',
+        permit: %i[page_size next_page_token]
     end
   end
 end

data/lib/zoom/actions/roles.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Zoom
+  module Actions
+    module Roles
+      extend Zoom::Actions
+
+      get 'roles_list', '/roles'
+
+      post 'roles_create', '/roles',
+        require: :name,
+        permit: %i[description privileges]
+
+      get 'roles_members', '/roles/:role_id/members'
+
+      post 'roles_assign', '/roles/:role_id/members',
+        require: :members
+
+      delete 'roles_unassign', '/roles/:role_id/members/:member_id'
+
+      get 'roles_get', '/roles/:role_id'
+    end
+  end
+end

data/lib/zoom/actions/sip_audio.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Zoom
+  module Actions
+    module SipAudio
+      extend Zoom::Actions
+
+      get 'sip_trunks_get', '/accounts/:account_id/sip_trunk/trunks'
+
+      delete 'sip_trunks_delete', '/accounts/:account_id/sip_trunk/trunks/:trunk_id'
+
+      delete 'sip_trunk_numbers_delete', '/accounts/:account_id/sip_trunk/numbers'
+
+      delete 'sip_trunks_internal_numbers_delete',
+        '/accounts/:account_id/sip_trunk/internal_numbers/:number_id'
+
+      delete 'sip_trunks_internal_callout_country_delete',
+        '/accounts/:account_id/sip_trunk/callout_countries/:country_id'
+
+      get 'sip_trunks_internal_numbers_list', '/accounts/:account_id/sip_trunk/internal_numbers',
+        permit: %i[page_size next_page_token]
+
+      get 'sip_trunks_internal_callout_country_list', '/accounts/:account_id/sip_trunk/callout_countries'
+
+      get 'sip_trunks_numbers_list', '/sip_trunk/numbers'
+
+      post 'sip_trunks_internal_numbers_add', '/accounts/:account_id/sip_trunk/internal_numbers'
+
+      post 'sip_trunks_internal_callout_countries_add', '/accounts/:account_id/sip_trunk/callout_countries'
+
+      post 'sip_trunks_numbers_assign', '/accounts/:account_id/sip_trunk/numbers'
+    end
+  end
+end

data/lib/zoom/actions/token.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+#
+module Zoom
+  module Actions
+    module Token
+      extend Zoom::Actions
+
+      post 'access_tokens',
+        '/oauth/token?grant_type=authorization_code&code=:auth_code&redirect_uri=:redirect_uri',
+        oauth: true
+
+      post 'refresh_tokens',
+        '/oauth/token?grant_type=refresh_token&refresh_token=:refresh_token',
+        oauth: true
+
+      post 'data_compliance', '/oauth/data/compliance',
+        oauth: true,
+        require: %i[
+          client_id user_id account_id deauthorization_event_received compliance_completed
+        ]
+
+      post 'revoke_tokens', '/oauth/revoke?token=:access_token',
+        oauth: true
+    end
+  end
+end

data/lib/zoom/actions/user.rb

@@ -3,144 +3,72 @@
 module Zoom
   module Actions
     module User
-      def user_list(*args)
-        params = Zoom::Params.new(Utils.extract_options!(args))
-        params.permit(%i[status page_size page_number])
-        response = self.class.get('/users', query: params, headers: request_headers)
-        Utils.parse_response(response)
-      end
-
-      def user_create(*args)
-        params = Zoom::Params.new(Utils.extract_options!(args))
-        require_param_keys = %i[action email type]
-        require_param_keys.append(:password) if params[:action] == 'autoCreate'
-        params.require(require_param_keys)
-        params.permit_value(:action, Zoom::Constants::USER_CREATE_TYPES.keys)
-        Utils.parse_response self.class.post('/users', body: { action: params[:action], user_info: params.except(:action) }.to_json, headers: request_headers)
-      end
-
-      def user_get(*args)
-        params = Zoom::Params.new(Utils.extract_options!(args))
-        params.require(:id).permit(:login_type)
-        Utils.parse_response self.class.get("/users/#{params[:id]}", query: params.except(:id), headers: request_headers)
-      end
-
-      def user_update(*args)
-        params = Zoom::Params.new(Utils.extract_options!(args))
-        params.require(:id).permit(%i[first_name last_name type pmi timezone dept vanity_name host_key cms_user_id])
-        Utils.parse_response self.class.patch("/users/#{params[:id]}", body: params.except(:id), headers: request_headers)
-      end
-
-      def user_delete(*args)
-        params = Zoom::Params.new(Utils.extract_options!(args))
-        params.require(:id).permit(%i[action transfer_email transfer_meeting transfer_webinar transfer_recording])
-        Utils.parse_response self.class.delete("/users/#{params[:id]}", query: params.except(:id), headers: request_headers)
-      end
-
-      def user_assistants_list(*args)
-        raise Zoom::NotImplemented, 'user_assistants_list is not yet implemented'
-        # TODO: implement user_assistants_list
-        # options = Utils.extract_options!(args)
-        Utils.parse_response self.class.get("/users/#{options.slice!(:id)}/assistants", query: options, headers: request_headers)
-      end
-
-      def user_assistants_create(*args)
-        raise Zoom::NotImplemented, 'user_assistants_create is not yet implemented'
-        # TODO: validate body attributes
-        options = Utils.extract_options!(args)
-        Utils.parse_response self.class.post("/users/#{options.slice!(:id)}/assistants", body: options, headers: request_headers)
-      end
-
-      def user_assistants_delete_all(*args)
-        raise Zoom::NotImplemented, 'user_assistants_delete_all is not yet implemented'
-        # TODO: implement user_assistants_delete_all
-        options = Utils.extract_options!(args)
-        Utils.parse_response self.class.delete("/users/#{options.slice!(:id)}/assistants", body: options, headers: request_headers)
-      end
-
-      def user_assistants_delete(*args)
-        # TODO: implement user_assistants_delete
-        # options = Utils.extract_options!(args)
-        raise Zoom::NotImplemented, 'user_assistants_delete is not yet implemented'
-      end
-
-      def user_schedulers_list(*args)
-        # TODO: implement user_schedulers_list
-        # options = Utils.extract_options!(args)
-        raise Zoom::NotImplemented, 'user_schedulers_list is not yet implemented'
-      end
-
-      def user_schedulers_delete_all(*args)
-        # TODO: implement user_schedulers_delete_all
-        # options = Utils.extract_options!(args)
-        raise Zoom::NotImplemented, 'user_schedulers_delete_all is not yet implemented'
-      end
-
-      def user_schedulers_delete(*args)
-        # TODO: implement user_schedulers_delete
-        # options = Utils.extract_options!(args)
-        raise Zoom::NotImplemented, 'user_schedulers_delete is not yet implemented'
-      end
-
-      def user_upload_picture(*args)
-        # TODO: implement user_upload_picture
-        # options = Utils.extract_options!(args)
-        raise Zoom::NotImplemented, 'user_upload_picture is not yet implemented'
-      end
-
-      def user_settings_get(*args)
-        params = Zoom::Params.new(Utils.extract_options!(args))
-        params.require(:id).permit(:login_type)
-        Utils.parse_response self.class.get("/users/#{params[:id]}/settings", query: params.except(:id), headers: request_headers)
-      end
-
-      def user_settings_update(*args)
-        # TODO: implement user_settings_update
-        # options = Utils.extract_options!(args)
-        raise Zoom::NotImplemented, 'user_settings_update is not yet implemented'
-      end
-
-      def user_status_update(*args)
-        # TODO: implement user_status_update
-        # options = Utils.extract_options!(args)
-        raise Zoom::NotImplemented, 'user_status_update is not yet implemented'
-      end
-
-      def user_password_update(*args)
-        # TODO: implement user_password_update
-        # options = Utils.extract_options!(args)
-        raise Zoom::NotImplemented, 'user_password_update is not yet implemented'
-      end
-
-      def user_permissions_get(*args)
-        # TODO: implement user_permissions_get
-        # options = Utils.extract_options!(args)
-        raise Zoom::NotImplemented, 'user_permissions_get is not yet implemented'
-      end
-
-      def user_token_get(*args)
-        # TODO: implement user_token_get
-        # options = Utils.extract_options!(args)
-        raise Zoom::NotImplemented, 'user_token_get is not yet implemented'
-      end
-
-      def user_token_delete(*args)
-        # TODO: implement user_token_delete
-        # options = Utils.extract_options!(args)
-        raise Zoom::NotImplemented, 'user_token_delete is not yet implemented'
-      end
-
-      def user_email_check(*args)
-        # TODO: implement user_email_check
-        # options = Utils.extract_options!(args)
-        raise Zoom::NotImplemented, 'user_email_check is not yet implemented'
-      end
-
-      def user_vanity_name_check(*args)
-        # TODO: implement user_vanity_name_check
-        # options = Utils.extract_options!(args)
-        raise Zoom::NotImplemented, 'user_vanity_name_check is not yet implemented'
-      end
+      extend Zoom::Actions
+
+      get 'user_list', '/users',
+        permit: %i[status page_size role_id page_number include_fields next_page_token]
+
+      post 'user_create', '/users',
+        require: [
+          :action,
+          user_info: %i[email type]
+        ],
+        permit: {
+          user_info: %i[first_name last_name password]
+        }
+
+      get 'user_get', '/users/:id',
+        permit: :login_type
+
+      patch 'user_update', '/users/:id',
+        permit: %i[first_name last_name type pmi timezone dept vanity_name host_key cms_user_id]
+
+      delete 'user_delete', '/users/:id',
+        permit: %i[action transfer_email transfer_meeting transfer_webinar transfer_recording]
+
+      get 'user_assistants_list', '/users/:user_id/assistants'
+
+      post 'user_assistants_create', '/users/:user_id/assistants',
+        permit: :assistants
+
+      delete 'user_assistants_delete_all', '/users/:user_id/assistants'
+
+      delete 'user_assistants_delete', '/users/:user_id/assistants/:assistant_id'
+
+      get 'user_schedulers_list', '/users/:user_id/schedulers'
+
+      delete 'user_schedulers_delete_all', '/users/:user_id/schedulers'
+
+      delete 'user_schedulers_delete', '/users/:user_id/schedulers/:scheduler_id'
+
+      get 'user_settings_get', '/users/:id/settings',
+        permit: [:login_type, :option, :custom_query_fields]
+
+      patch 'user_settings_update', '/users/:id/settings',
+        permit: %i[schedule_meeting in_meeting email_notification recording telephony feature tsp]
+
+      get 'user_email_check', '/users/email',
+        require: :email
+
+      get 'user_recordings_list', '/users/:id/recordings',
+        permit: %i[page_size next_page_token mc trash from to trash_type]
+
+      get 'user_token', '/users/:user_id/token',
+        permit: %i[type ttl]
+
+      get 'user_permissions', '/users/:user_id/permissions'
+
+      get 'user_vanity_name', '/users/vanity_name',
+        require: :vanity_name
+
+      patch 'user_password_update', '/users/:id/password',
+        permit: :password
+
+      patch 'user_email_update', '/users/:id/email',
+        permit: :email
+
+      patch 'user_status_update', '/users/:id/status',
+        permit: :status
     end
   end
 end