ドキュメント・リリースノート - 2024年6月

この記事はhttps://www.pubnub.com/docs/release-notes/2024/juneに掲載されたものです。

こんにちは！今月は新しいアップデートをお届けします。

• データの一貫性を保つための新しい参照整合性フラグを導入しました。
• 管理者ポータルから直接チャンネルグループの上限を設定できるようになりました。
• InsightsからBizOpsにデータをインポートして、その機能を試してみてください。
• さらに、プレゼンス・マネジメントのルック＆フィールが刷新されました。

その他にも、PubNubを使う上で疑問に思っていることを解消できるような、小さいけれども重要な改善をたくさん行いました。

これからもPubNubをよろしくお願いします！

🛠️

FCMペイロードのカスタムフィールド

タイプ改善

FCMモバイルプッシュ通知のペイロードに追加できるPubNubのカスタムパラメータpn_debug、pn_exceptions、pn_dry_runを追加して、Androidモバイルプッシュ通知のドキュメントを修正しました。

これらのパラメータを使用すると、通知をテストまたはデバッグしたり、通知を受信しないように選択したデバイスを除外したりできます。

以下は、カスタムフィールドを含むFCMペイロードのサンプルです：

{
  "pn_fcm": {
    "notification": {
      "title": "My Title",
      "body": "Message sent at"
 },
    "pn_collapse_id": "collapse-id",
    "pn_exceptions": [
      "optional-excluded-device-token1"
 ]
 },
  "pn_debug": true,
  "pn_dry_run": false
}

チャネルグループの制限

タイプ新機能

管理ポータルのStream Controllerに、有料プランのお客様向けにチャンネルグループ制限オプションが追加されました。デフォルトの上限である1,000チャンネルを下げることも、2,000チャンネルまで増やすこともできます。

アプリコンテキストのユーザーメタデータイベント

タイプ改善

User Metadata Eventsオプションを有効にすると、ユーザー・エンティティの変更（設定と 削除）がメンバーシップ関連にイベント通知を送信するため、そのユーザーとそのユーザーがメンバーであるチャネルの両方にイベント通知が送信されることを明確にするため、ドキュメントを改善しました。詳細はドキュメントを参照してください。

アプリコンテキスト設定の依存関係

タイプ改善

App Contextの設定オプションに関するドキュメントを更新し、重要な依存関係についての情報を追加した。

Disallow Get All Channel Metadata」と「Disallow Get All User Metadata」オプションは一見わかりやすいように見えますが、これらのオプションはAccess Managerが有効な場合にのみ機能するという注意点があります。

言い換えると、Access Managerがない場合、これらのアクティブなオプションは、実際にはキーセットのユーザーまたはチャンネルに関するメタデータの取得を無効にしない。同時に、Access Managerを有効にすると、デフォルトでキーセット上のすべてのオブジェクトへのアクセスが制限されるため、細かい権限スキーマを作成しなくても、これらの設定オプションの両方のチェックを外すことで、ユーザーとチャンネルに対するAccess ManagerのGET制限を簡単に回避することができる。

Admin Portal UIにも、この依存関係がまもなく反映される予定です。

App Contextの新しい参照整合性フラグ

タイプ新機能

管理ポータルのアプリのキーセットでApp Contextを有効にすると、デフォルトでオンになる新しいEnforce referential integrity for membershipsオプションを追加した。

このフラグにより、メンバーシップを作成したユーザIDとチャネルIDの両方が存在する場合にのみ、新しいメンバーシップを設定できるようになります。同時に、親ユーザまたはチャネルのメタデータ・エンティティを削除すると、その削除されたエンティティの子メンバーシップ関連付けが自動的に削除されます。こうすることで、キーセット上のメンバーシップ・オブジェクトに不具合や欠落が生じないようにすることができる。

SDK 📦 Pythonドキュメントの改善

Pythonドキュメントの改善

タイプ改善

頂いたフィードバックに従い、メソッドの使用法と実行に関する情報を拡張しました。その結果、Python SDKドキュメントの各Returnsセクションでは、各メソッドが返すデータフィールドについて説明するようになりました。また、同期(.sync())と非同期(.pn_async(callback))リクエストの実行が、各メソッドの戻りデータにどのように影響するかも説明しています。

React SDKは廃止されました。

タイプ非推奨のお知らせ

しばらくReact SDKの開発を積極的に行っていなかったため、最終的に正式に非推奨とし、ドキュメント内のCall For Contributionsセクションに移動することにしました。

React SDKのバグを見つけたり、機能を拡張したい場合は、遠慮なくリポジトリにプルリクエストを作成し、私たちのフィードバックをお待ちください！

機能

イベント＆アクションからファンクションのログをエクスポートする

タイプ新機能

各PubNubファンクションは内部のbocks-output-*チャンネルにログを保存します。bocks-output-NSPiAuYKsWSxJl4yBn30のように、新しいログが上書きされる前に最大250行のログを保存できます。古いログを失いたくない場合は、イベント＆アクションを使用して、これらのログを外部サービスにエクスポートできるようになりました。

インサイト ↪So_1F4CA

REST APIドキュメントのユーザー期間とデバイスメトリクス

タイプ改善

先月、管理ポータルのPubNub InsightsのUser Behaviorダッシュボードにデバイスメトリクスを導入しました。今月は、REST APIドキュメントを更新し、ユーザー期間とデバイスメトリクスの両方を含めるようにしました。これにより、PubNub Insights APIを直接呼び出して、関心のあるメトリクスを取得できます。

BizOpsワークスペース 🏢 🏢 ←クリック

トップ20ユーザー/チャンネル

タイプ新機能

App Contextを使用してユーザーとチャネルを保存および管理しない場合でも、テストデータをインポートすることで、関連するBizOps Workspace機能をテストできます。

PubNub Insightsにアクセスできる場合は、管理者ポータルのBizOps WorkspaceのUser ManagementモジュールとChannel Managementモジュールにアクセスし、[Import from Insights]ボタンをクリックします。

その結果、アプリのキーセットから、直近1日以内に最も多くのメッセージを公開した最大20人のユーザーがインポートされます（昨日メッセージが送信されていない場合、ユーザーは前日のデータに基づいてインポートされます）。

ユーザーと同様に、アプリのキーセットから、直近1日以内に公開されたメッセージ数が最も多いチャンネルを最大20チャンネルまでインポートできます。

このテストデータを使用して、BizOps Workspaceが提供するものを探求してください。

プレゼンス管理UXの刷新

タイプ改善

最近、BizOps Workspaceのプレゼンス管理モジュール全体のデザインを変更し、ルール作成ウィザードを簡素化し、バッジの色をより包括的なものに変更し、キーセットのプレゼンス設定のデフォルトの「すべてのチャンネルでプレゼンスを有効にする」設定を反映する「キャッチオール」パターン設定を追加しました。

新しいルック＆フィールを気に入っていただければ幸いです！