Vonage Python SDK

Vonage/vonage-python-sdk

4.0.0

14 2024年11月

SDKを全面的に書き直しました。 主な変更点

  • モノレポ構造で、各APIは別々のパッケージ下にある
  • Python 3.9以上をサポート
  • v3との機能パリティ
  • 新しいネットワークAPIのサポートを追加する。 Vonage Simスワップ・ネットワークAPI そして Vonage番号確認ネットワークAPI
  • データモデルの使用
  • 多くの新しいカスタムエラー、エラーデータモデルとエラーメッセージの改善
  • SDK全体にわたるメソッドとデータモデルのDocstringsにより、開発者のQuality-of-Lifeを向上させ、In-IDE開発を容易にする。
  • 正しいタイピングを強制するためのPydanticの使用
  • すべてのサポート ビデオAPI 特徴
  • 追加 http_client プロパティを、HTTPクライアントを持つ各モジュール（例：Voice、Sms、Verify）に追加する。
  • 追加 last_request そして last_response プロパティをHTTPクライアントに追加することで、デバッグが容易になります。
  • Vonage JWTパッケージをmonorepoに移行。
  • 名称変更 Verify -> Verify Legacy そして Verify v2 -> Verify

3.17.4

2024年10月30日

  • Python 3.8のサポートを終了、3.13のサポートを追加

3.17.3

2024年10月30日

  • JWTジェネレーターのバグを修正

3.17.2

2024年10月30日

  • 更新 vonage-jwt JWTタイムアウト問題を修正した依存バージョン

3.17.1

2024年8月20日

  • Messages APIに "WhatsAppメッセージを既読にする "オプションを追加

3.17.0

2024年8月19日

  • Messages APIにRCSメッセージタイプオプションを追加
  • RCSメッセージを取り消す」オプションを追加

3.16.1

2024年8月6日

  • ビデオクライアントのトークンオプションを修正
  • READMEの誤字を修正
  • 脆弱性が修正された依存関係の最小バージョンを上げる

3.16.0

7 2024年6月

3.15.0

3 2024年6月

3.14.0

13 2024年5月

  • 有効な Video API クライアント トークンの役割として公開専用を追加する

3.13.1

2024年4月30日

  • コンテント・タイプのシリアライズの誤りを修正

3.13.0

2023年12月22日

  • Pydantic V2を依存関係として使用するための移行

3.12.0

11 2023年12月

3.11.1

2023.11.29

  • サイレント認証ワークフローのオプション・パラメータのチェックを追加 redirect_url そして sandbox

3.11.0

2023年10月19日

  • Voice API ウェブフックの JWT シグネチャをチェックするメソッドを追加しました： vonage.Voice.verify_signature

3.10.0

4 2023年10月

  • Python 3.12のサポートを示す

3.9.1

2023年8月30日

  • Meetings API URLの更新 /v1 エンドポイント

3.9.0

2023年8月21日

  • Python 3.7はサポートが終了し、セキュリティ・アップデートも受けられなくなった。

3.8.0

14 2023年8月

3.7.1

6 2023年7月

  • Pydanticのバージョン範囲を1.xに固定し、変更を壊さないようにする。

3.7.0

2023年6月22日

  • のサポートを追加した。 Vonage Meetings API
  • を部分的にサポートする。 Vonage Proactive Connect API - に関するAPIメソッドをサポートしている。 lists, items そして events
  • に無効な値が指定された場合、より説明的な（内部的でない）エラーメッセージを返す。 application_id または private_key Vonage クライアントオブジェクトをインスタンス化するとき

3.6.0

14 2023年6月

3.5.2

6 2023年6月

  • を使用している。 Vonage JWTジェネレータ の代わりに PyJWT JWTを生成する。
  • その他の内部リファクタリングと機能強化

3.5.1

2023年5月23日

  • の内部使用を更新する。 fraud_check Vonage Verify V2 API のパラメータ。

3.5.0

2023年5月16日

  • Vonage Verify API の V2 サポートの追加
    • 複数の認証チャンネルに対応(SMS、音声、Eメール、WhatsApp、WhatsAppインタラクティブメッセージ、サイレント認証)
    • 検証方法が失敗した場合にフォールバック・チャンネルを使用できるようになりました。
    • 送信される認証コードをカスタマイズしたり、独自のカスタムコードを指定したりできるようになりました。
  • 追加 advancedMachineDetection Vonage Voice API用NCCOビルダーへの機能追加

3.4.0

14 2023年4月

  • 内部リファクタリングの変更
  • Numbers APIでヘッダー認証を使用する

3.3.0

3 2023年3月

  • Messages APIを更新しました：
    • Viberサービスメッセージ(video, file)
    • 新しいWhatsAppを追加 sticker メッセージチャネル
    • 増加 client_ref 最大100文字
  • 非推奨 pay Vonageによって削除されるため、NCCOビルダーでアクションを起こします。

3.2.2

2023年1月19日

  • Windowsのバグ修正

3.2.1

2023年1月16日

  • インポートのバグを修正

3.2.0

2023年1月14日

  • Voice API使用時にNCCOを扱いやすくするNCCO Builderの追加
  • 個々のNCCOアクションは、Pydanticモデルとして作成することができ、以下の方法でNCCOに組み込むことができる。 Ncco.build_ncco 方法

4.0.0b0

2022.12.2

  • v3.2.0b0からの機能変更はありません。メジャーバージョン番号を使用することで、リリースの時系列と数値の同期を保つことができます。
  • でインストールできるベータ版です。 pip install --pre vonage

3.2.0b0

11 11月 2022

  • セッション、シグナリング、モデレーション、アーカイブのためのVonage Video APIサポートを含むベータリリース
  • このブランチは、今のところメインのコードベースとは別に管理され、以下の方法でインストールできる。 pip install --pre vonage

3.1.0

26 10月 2022

  • Python 3.11のサポート
  • いくつかの古い依存関係をアップグレードする

3.0.2

25 10月 2022

  • のバグ修正 messages.py 認証方法が正しくチェックされず、header authを使用したときにエラーを投げていました。

3.0.1

4 2022年10月

  • JWTがグローバルに作成され、期限切れになるバグを修正。リクエストが行われたときに新しいJWTが生成されるようになりました。
  • タイムアウトがセッション・オブジェクトに渡されないバグを修正。

3.0.0

2022.07.27

変化への対応

  • から非推奨のメソッドを削除した。 client.py Vonageの各APIに関連する特定のモジュールで利用できるようになりました。例えば、Number Insight APIを呼び出すには、このようにメソッドを呼び出します： client.number_insight.get_basic_number_insight(...)または NumberInsight クラスを直接使用する： ni = vonage.NumberInsight(client), ni.get_basic_number_insight(...) その他
  • をインスタンス化する際のクライアントの自動作成を削除した。 sms, voice または verify オブジェクトが追加されました。これらのAPIは、作成したクライアント・インスタンス（例えば client.sms.send_message()を作成するためにAPIクラスにクライアントを渡すか（例えば sms = vonage.Sms(client))、SDKのv2.7.0以降の場合と同様です。
  • Vonageによって廃止されたMessages Search APIを呼び出すメソッドを削除しました。
  • から非推奨のボイスおよびナンバー・インサイト・メソッドを削除した。 voice.py (initiate_call, initiate_tts_call and initiate_tts_prompt_callそして number_insight.py (request_number_insight).
  • に改名した。 Account.delete_secret() メソッドを使用します。 revoke_secret() 私たちのドキュメントに記載されているものと一致させるためです。

非推奨：

  • を非推奨とした。 ApplicationV2 クラスを作成し、同じメソッドを持つApplicationsクラスを作成しました。これは、クライアント・オブジェクトから client.application.create_application(...) などと直接、あるいは application = vonage.Application(client), application.create_application(...) その他
  • 非推奨の古いPricing APIメソッド get_sms_pricing そして get_voice_pricing.
  • SDKでサポートされていない開発プレビュー製品であり、後のリリースで削除されるため、Redactクラスは非推奨。

強化された：

  • 追加 get_all_countries_pricing メソッドを使用します。 Account オブジェクトがある。
  • を追加した。 type パラメータを使用します。 sms または voice 価格設定が可能になった。
  • 追加 max_retries, timeout, pool_connections そして pool_maxsize オプションのキーワード引数を Client クラスのインスタンス化時に指定し、クライアントとのAPIコールで使用できるようになった。

2.8.0

2022 年 6 月 30 日

  • Messages API v1.0のサポートを追加しました。Messages API を使用するために client.messages.send_message() メソッドを使用する。

2.7.0

2022年5月26日

  • いくつかのクライアント・メソッドを独自のクラスに移動： account.py, application.py, message_search.py, number_insight.py, numbers.py, short_codes.py, ussd.py
  • 対応するクライアント・メソッドを非推奨とした。これらは近々リリースされるメジャーリリースで削除される予定です。
  • Clientは、各APIが作成されるときに、各APIのクラス・オブジェクトをインスタンス化するようになった。 vonage.Client(key="mykey", secret="mysecret") のインスタンスをインスタンス化する。 Account, Sms, NumberInsight など。これらのインスタンスは Client.

2.6.4

27 4月 2022

  • Python3.6以下のサポート終了
  • 現在サポートされているPythonの安定版、すなわちPython 3.7-3.10をサポートします。
  • 内部リファクタリングと機能強化
  • デフォルトの追加 max_retries オプションを BasicAuthenticationServer コンストラクタで、オプションのパラメータを指定する。

2.5.5

5 2021年1月

  • PyJWT >1.8 の問題を修正した (TypeError: str を bytes に連結できない)
  • このパッチにより、PyJWTのすべてのバージョンがサポートされるようになります。

2.5.3

14 2020年9月

  • Vonageネームスペースの変更を反映したマイナーパッチ

2.5.2

27 Aug 2020

  • 独立したSMS、Voice、Verify APIを、現在のクライアントメソッドと同様にテスト付きでサポート。
  • カスタム属性を抽出/書き換えるゲッター/セッター
  • PSD2検証サポート
  • Python 2.7のサポート終了
  • より良いエラー処理へのロードマップ
  • Python 3.8対応