ユーザーの全体的なエクスペリエンスに関する これらのガイドに沿って Google Meet アドオンのデザイン。
認可のベスト プラクティス
以下のベスト プラクティスを 認証または認可が必要な Google Meet アドオン。
Google ログインを使用する
Google Workspace アドオンの多くのユーザーは、以前にすでに Google にログインしたことがある 役立ちます。そのため、Google ログインは オプションとして選択可能なオプションを使用すると、 ログインします。
サードパーティのログインページを新しいウィンドウで開く
Google ログインの他にも、アプリケーションによっては、 メカニズムです。ログイン ページは、 新しいタブで開きます。こうすることで、ユーザーはこれまでと同じように 全体のクリック数が少なくなります。
Google API のスコープを適切にリクエストする
Meet アドオンが Google API を呼び出す場合: OAuth 2.0 の完全なリストを提供しなければ スコープ 確認できます。これは Google Workspace Marketplace アプリの構成ページ。これらを追加すると、 ユーザーがアプリをインストールするときに、 ユーザーがどのような種類のデータであるかをユーザーに知らせる Meet アドオン アクセスを許可します。
アドオンを公開する前に OAuth 同意ステータスも設定する必要があります 画面をご覧ください。 そのためには、Google Cloud コンソールから Google Workspace Marketplace アプリの構成。OAuth を構成する 同意画面には、ブランディング情報、プライバシー ポリシー 利用規約が表示されます。公開する 公開する場合、この情報はすべて 確認します。
Google Workspace API を呼び出すコードを記述する際は、JavaScript クイックスタート が最も簡単です。このアプローチは、Google Workspace の Google ログインとダイアログ ウィンドウを使用します。なお、トークンの初期化は クライアント アプリケーションが必要とするスコープを別個にリクエストする必要があります。 実行時に実際に使用する数です。最適なユーザー エクスペリエンスを実現するため、 [Google Workspace Marketplace アプリの設定] に記載されているものと一致するはずです。 できます。この冗長性により、次のような状況に対応するためのフォールバックが ユーザーが スコープ。
メンテナンスのベスト プラクティス
次のベスト プラクティスは、 アプリケーションを構築する場合に特に重要ですが、 Meet アドオン。
Google Meet アドオン SDK の最新バージョンを使用する
Meet アドオン SDK は定期的に更新されます。SDK は セマンティック バージョニング。最新バージョンを確認するには:
- gstatic を使用する場合: 最新の SDK バージョンは gstatic SDK の使用手順に記載されている URL。
- npm を使用する場合: 内部から
npm update @googleworkspace/meet-add-onsを実行します。package.jsonを含むディレクトリ Meet アドオンをホストするウェブサイトのアドレスです。
ステージング用の Google Cloud プロジェクトを作成する
Google Meet アドオンを Google Workspace Marketplace Google Meet アドオンを新しくデプロイしても Meet ユーザーが使用できます。これらの更新は、 キャッシュを空にするか、キャッシュが期限切れになります。そのため、 変更を徹底的にテストするまで、本番環境サイトに変更を push します。
本番環境に直接デプロイしないように、別の VM を作成することをおすすめします。 限定公開の Google Cloud プロジェクト 組織に提供します。この Cloud プロジェクトでは、ステージング環境と 開発環境を整えることができます。アクセス権 ロールを割り当てられている少人数のチームのみに 直接開発できます。
アドオンの代替環境を作成するには、次の操作を行います。 まず、ウェブ アプリケーションの代替環境をホストし、 所有しているドメイン上のアドオンが含まれます。その後、 環境ごとに別の環境を作成できます。 Meet アドオンに を追加します デプロイ Google Cloud プロジェクトに追加します新しいデプロイでは ウェブ アプリケーションの代替環境を指すマニフェスト。 その後、各アドオンをインストールし、 構成します。
- ステージング: ステージング バージョンを非公開で公開します。 これにより、組織内の誰もがテストを支援できるようになります。
- Development: [Actions] 列で [Install] をクリックして、 Meet アドオン開発バージョンは、お使いのアカウントのみで利用できます。
テストを作成する
Meet アドオンを開発環境にデプロイする前に 単体テストを作成することをおすすめします。単体テストには以下を含める必要があります。
- Meet アドオン SDK をモックアウトし、 Meet アドオンが SDK の関数を想定どおりに呼び出します。
- SDK に関連しないすべての機能の単体テスト 任意のウェブテスト フレームワークでアドオンを作成します。
ユーザー エクスペリエンスのベスト プラクティス
以下のベスト プラクティスは Meet アドオンの作成に役立ちます。 直感的に洗練させることができます
サイドパネルですべての開始状態を管理する
以下に基づいてアドオンを設定することを強くおすすめします。
サイドパネルで行われたユーザー操作。
これを行うには、まず最初に
状態を
使用できます。エクスポートされるすべてのデータは
CollaborationStartingState
アドオンのイニシエータが設定する必要があります（通常は
クリックします。最初のビューは
サイドパネルをフォームとして機能し、
できます。
使用しないときにサイドパネルを閉じる
呼び出してアクティビティを開始した後
startCollaboration
サイドパネルのみを残して、
自社のユーザーエクスペリエンスに
不可欠な場合はオープンにします
Google Meet アドオン。メイン ウィンドウが開いたらサイドパネルを閉じることができます。
ステージは
unloadSidePanel。
画面共有を通じて Meet アドオンを宣伝する
Meet アドオンは、画面共有よりも豊富な機能を提供します。 ただし、多くのユーザーは Meet の画面共有に慣れている 説明します。ウェブ サイトをホストしているウェブサイトが表示されているタブをユーザーが共有した場合、 Meet はアドオンとして構成できます。 通話の参加者全員に、 対応する Meet アドオンのアドオンを使ってみましょう。詳細については、次をご覧ください: 画面を通じてアドオンをプロモート 共有をご覧ください。