バヅクリCTOの合原です。
前回投稿では、zoomAPIを使って、Zoomミーティングを作成するアプリケーションを作ってみました。
いいタイミングでこちらのキャンペーンも開催しているので、今回ももちろん、相乗りさせていただきました 
https://qiita.com/official-campaigns/engineer-festa/2022
上記作成したところ、すぐさま、
「新規作成＆既にできているZoomミーティングのレコーディング設定を自動化したい」、
という要望が挙がり、それならば！と、
前回作成したアプリケーションに、今回は、Zoom Meeting update API を利用して、機能拡張してみました。
前提
- 前回の対応ですでにServer-to-server OAuthを使用したzoomアプリの作成は完了済み（access tokenの取得はできる状態）
調査
何はともあれ、リファレンスをたよりに、まずはAPIについて調査です。
https://api.zoom.us/v2/meetings/{meetingId}
meetingIdをパスパラメーターにして、patchリクエストなんだとか。。。
正直もう、これが全てでした。
あとは、更新したい項目をjson request bodyに設定するのみ。
設計・実装
さて、Railsでどうやるか。まずは設計です。
といっても、こちらも前回拡張しやすいように設計してあったので、基本、必要な部品を追加するのみです。
Zooms::Meetingクラスへメソッド追加
- Zoomミーティング作成時はPOSTリクエストでしたが今回は更新＝PATCHリクエストであること
- リクエストURLも変わる
上記の点から、下記のようにpatch_api_requestを追加。
class Zooms::Meeting < Zooms::Base
private
def headers
{
Authorization: "Bearer #{access_token}",
"Content-Type": "application/json"
}
end
def api_request_url
raise NotImplementedError, "You must implement #{self.class}##{__method__}"
end
:
def patch_api_request # 新規追加
uri = URI.parse(patch_request_url)
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
http.patch(uri.path, request_body.to_json, headers)
end
:
end
Zooms::Meetings::EventUpdatorクラス作成
今回のZoom Meeting Update APIを実行するクラスを作成。
文字通り、このクラスでは「Updateすること」を責務とし、
- 対象のevent
- 更新対象となるパラメータ
を引数として受け取れるようにしました。
class Zooms::Meetings::EventUpdator < ::Zooms::Meeting
class UpdateApiError < StandardError; end
include ActiveModel::Model
include ZoomRequestBodyComposer # update対象項目のjsonペイロードを作成するmodule
ATTRS = %i[
event
].freeze
UPDATE_PARAMS = %i[
auto_recording
].freeze
attr_accessor :event
validates :event, presence: true
validates :auto_recording, inclusion: { in: %w[none cloud], message: "：｢%<value>s」 は無効です" } # 公式のドキュメントに従いRails標準のvalidationを用意
(ATTRS + UPDATE_PARAMS).each do |a|
attr_accessor a
end
validate :ensure_update_params
def update!
return raise ArgumentError, errors.full_messages.join(", ") if invalid?
return raise ArgumentError, "#{self.class.name}: Not found zoom settings" unless event.use_zoom?
response = patch_api_request
raise UpdateApiError, "ERROR RESPONSE: #{response['code']}" unless response.code == "204"
Rails.logger.info "#{self.class.name}: SUCCESS to update event:#{event.id} zoom meeting!"
end
private
def patch_request_url
"https://api.zoom.us/v2/meetings/#{zoom_meeting_id}"
end
def zoom_meeting_id
event.zoom_meeting_id.to_s.gsub(/[[:space:]]/, '')
end
def request_body
# https://marketplace.zoom.us/docs/api-reference/zoom-api/methods/#operation/meetingCreate
composed_body
end
def ensure_update_params
params = UPDATE_PARAMS.map { |a| send(a).present? }
errors.add :base, "Not found UPDATE PARAMS!" unless params.include? true
end
end
update対象項目のjsonペイロードを作成するmodule
上記のクラスで、受け取ったUPDATE_PARAMSを、APIリクエスト用に成形するmoduleを用意します。
module ZoomRequestBodyComposer
extend ActiveSupport::Concern
def composed_body
compose
@body.dup
end
private
def compose
@body = default_body
append_auto_recording if auto_recording.present?
self
end
def append_auto_recording
@body[:settings][:auto_recording] = auto_recording
end
def default_body
{
settings: {
auto_recording: nil
}
}
end
end
composed_body のとこ、もうちょっとシュッとしたかったですが、まぁ、今回はあきらめです 
いずれにしてもこうしておくことで、今後他にも自動で設定したい項目が要望といて上がった際も追加するのが容易になります。
大事なのは然るべき責務に応じて設計すること
API実行をバックグラウンド実行する
ため、Active job作成します。
class Zooms::MeetingUpdateJob < ApplicationJob
queue_as :tasks
def perform(event)
::Zooms::Meetings::EventUpdator.new(event: event, auto_recording: event.membership_request.is_recording_yes? ? "cloud" : "none").update!
end
end
API実行
$ :
$ ::Zooms::MeetingUpdateJob.perform_later(event)
とすることで、サクッと実行が可能になりました。
実際はAPIの使用制限もあるので、 production利用の際は、気をつけてください
やったことまとめ
前回構築した、Zoomsを拡張する形でZoomMeetingのUpdate処理を作成しました
$ tree -L 3 app/models/zooms
app/models/zooms
├── app.rb
├── base.rb
├── meeting.rb
└── meetings
├── event.rb
├── event_updator.rb #こちら新設
所感
ZoomAPIはとても、標準的なREST API設計されているため、使用のハードルが非常に低いなと思います。
操作したいリソースを念頭に、一度APIを利用できる設計、実装するだけ、Railsでの機能拡張も容易でした。
今回利用したAPIでは、Zoomミーティング作成時にレコーディングON/OFFのみ行いましたが、他にも、さまざまなオプションが設定できるので、当社のサービスでのZoom利用ケースで柔軟な設定の自動化が期待できそうです。
今後は、ミーティング作成に限らず、他のAPIやSDKも使いつつ、自動化したり、面白いZoomの使い方をビジネスサイドに提案していきたいと思います 
今回も恒例のやつですが
当社では、バックエンドサーバーとして主にRails、フロントエンドでは、Nextjsを利用しています。
新しい物（コト）好きの当社では、絶賛、エンジニアを募集中です！
気になる方はお気軽にご連絡いただけましたらと思います！
