シェア:
){kind=small}
ベンはセカンドキャリアの開発者で、以前は成人教育、コミュニティ組織化、非営利団体運営の分野で10年を過ごした。彼はVonageの開発者支援者として働いていた。コミュニティ開発とテクノロジーの交差点について定期的に執筆している。南カリフォルニア出身で、長年ニューヨークに住んでいたが、現在はイスラエルのテルアビブ近郊に在住。
Vonage Ruby SDK バージョン7.3.0の発表
Vonage Ruby SDKは最近新しいリリース、v7.3.0を発表しました。この新バージョンではAPIリストメソッドの自動ページネーション機能が導入され、Vonage APIからのデータ収集がより合理的になりました。
その理由と仕組みを探ってみよう。
Vonage APIを使用する際にページネーションについて考える必要がある理由と、自動ページネーションによってどのようにエクスペリエンスが向上するのか？
実例を見るのが一番わかりやすいだろう。
Vonage Voice APIには以下の機能があります。 すべての通話の詳細を取得する.この GETリクエストを行うと、デフォルトでは最初の10件のみが返されます。
10回以上コールした場合はどうなりますか？レコードのページが増えるごとに、APIリクエストを続けなければなりません。つまり、現在のページ、残りのページ数、ページごとのレコード数を追跡し続けることになる。呼び出しのリストが欲しいだけなのに、これは予想以上に認知的な負荷だ。
幸いなことに、Ruby SDKのv7.3.0では、この作業はあなたの責任から抽象化された。
Vonage SDK チームが次のように説明しています。 ブログ投稿私たちのSDKは、主に開発者としてのあなたの生活を楽にし、あなたができるだけ苦労せずに仕事をこなせるようにするものであるべきだと固く信じています。Ruby SDKの自動ページネーションは、その大きな目標に向けたもう一つのステップです。
Ruby SDKに新機能を導入する際、Ruby SDKを定期的に使用して仕事をこなしているすべての人のワークフローに最小限の影響を与えることが極めて重要です。そのため、自動ページネーションでは、その改良を活用するためにほとんど何もする必要がありません。
SDKで使用していたのと同じメソッド呼び出しで、すべての通話記録を要求できるようになりました：
client = Vonage::Client.new
client.applications.listしかし現在では、SDKは自動的にレコードのすべてのページを進行し、あなたに返される呼び出しのコレクションに追加します。以前は、このメソッド呼び出しはAPIのデフォルトのレコード数（この場合は10）しか返さず、残りを収集するにはさらにAPIリクエストを行う必要がありました。
すべてのレコードを返したくない状況もあるでしょう。のメソッド呼び出しに追加の引数を渡すことで、自動ページ送りをオフにすることができる。 auto_advance: false.たとえば、最初の5件だけを返したい場合、メソッドは次のようになります：
client = Vonage::Client.new
client.applications.list(page_size: 5, auto_advance: false)この引数をコードに追加する必要があるのは auto_advance引数を追加するだけでよい。ほとんどのAPIでは、デフォルトの動作は自動前進です。
Ruby SDKについては、さらにエキサイティングな計画が進行中です！私たちはSDKの機能を強化し続け、HTTPリクエストを代行するだけでなく、あなたの作業をより簡単で合理的にするリソースでありたいという私たちの目標との整合性を高めていきます。
私たちは常に地域社会の参加を歓迎しています。お気軽に GitHubおよび Vonage コミュニティ Slack.