Google Meet アドオンの設計に関する次のガイドに従って、ユーザー エクスペリエンス全体を改善します。
認可に関するベスト プラクティス
認証または認可を必要とする Google Meet アドオンには、次のベスト プラクティスを使用することをおすすめします。
Google ログインを使用する
Google Workspace アドオンの多くのユーザーは、会議に参加する前にすでに Google にログインしています。そのため、 Google ワンタップをオプションとして利用できるようにすると、ログイン フローでユーザーがクリックする回数を減らすことができます。詳しくは、アドオンのログイン方法を管理するをご覧ください。
サードパーティのログインページを新しいウィンドウで開く
Google ログインに加えて、アプリで他のログイン メカニズムを提供することもできます。その場合は、ログインページを新しいタブで開くのではなく、ダイアログ ウィンドウを使用します。これにより、ユーザーは Meet 通話を引き続き表示して戻ることができ、全体的なクリック数を減らすことができます。
Google API のスコープを適切にリクエストする
Meet アドオンが Google API を呼び出す場合は、 アドオンに必要な OAuth スコープの完全なリストを指定する必要があります。 これは、Google Workspace Marketplace の [アプリの構成] ページで行います。これらのスコープを追加すると、ユーザーが Meet アドオンをインストールしたときに、アプリがアクセスできるデータの種類を知らせるプロンプトが表示されます。
アドオンを公開する前に、 OAuth 同意 画面を設定する必要があります。 これには、Google Workspace Marketplace の [アプリの構成] からまったく同じ認可スコープを追加する必要があります。 OAuth 同意画面を構成するには、スコープがリクエストされたときに表示されるブランド情報、プライバシー ポリシー、利用規約も設定する必要があります。一般公開するには、この情報をすべて送信して 確認を受ける必要があります。
Google Workspace API を呼び出すコードを作成する場合は、JavaScript クイックスタート に従うのが最も簡単な方法です。このアプローチは、Google ログインとダイアログ ウィンドウを使用するためのベスト プラクティスに準拠しています。JavaScript でトークン クライアントを初期化する には、アプリが 実行時に実際に使用するスコープを別途リクエストする必要があります。最適なユーザー エクスペリエンスを提供するには、リクエストされたスコープが Google Workspace Marketplace の [アプリの構成] ページのものと一致している必要があります。この冗長性により、ユーザーがスコープを取り消した場合のフォールバックが提供されます。
メンテナンスに関するベスト プラクティス
次のベスト プラクティスは、保守可能なウェブアプリを作成するためのものですが、Meet アドオンを作成する場合は特に重要です。
Google Meet アドオン SDK の最新バージョンを使用する
Meet アドオン SDK は定期的に更新されます。SDK は セマンティック バージョニングに準拠しています。最新バージョンを確認するには:
- gstatic を使用する場合: 最新の SDK バージョンは、SDK の使用手順に記載されている gstatic URL に含まれています。
- npm を使用する場合: Meet アドオンをホストするウェブサイトの
package.jsonを含むディレクトリ内でnpm update @googleworkspace/meet-add-onsを実行します。
ステージング用の Google Cloud プロジェクトを作成する
Google Meet アドオンが Google Workspace Marketplace で公開されると、Google Meet アドオンの新しいデプロイは Meet ユーザーがすぐに利用できるようになります。ユーザーは、キャッシュを空にするか、キャッシュの有効期限が切れるとすぐにこれらの更新を確認できます。そのため、変更が十分にテストされるまで、変更を本番環境サイトにプッシュしないことをおすすめします。
本番環境に直接デプロイしないように、別の Google Cloud プロジェクトを組織に限定公開することをおすすめします。このクラウド プロジェクトには、Meet アドオンのステージング環境と開発環境の両方がホストされます。このクラウド プロジェクトへのアクセスは、アドオンの開発に直接取り組んでいる小規模なチームに限定する必要があります。
アドオンの代替環境を作成するには、まず、アドオンを含むウェブ アプリケーションの代替環境を、所有しているドメインでホストする必要があります。その後、 ステージング用の Google Cloud プロジェクトに追加の デプロイ を追加して、Meet アドオンの代替環境を作成できます。これらの新しいデプロイには、ウェブ アプリケーションの代替環境を指すマニフェストが必要です。次に、各アドオン環境を次のようにインストールすることをおすすめします。
- ステージング: ステージング バージョンを限定公開して 組織内のすべてのユーザーがテストに参加できるようにします。
- 開発: [インストール] を [アクション] 列の下でクリックして、 Meet アドオンの開発バージョンを自分のアカウントにのみインストールします。
テストを作成する
Meet アドオンを開発環境にデプロイする前に、単体テストを作成することをおすすめします。単体テストには次のものを含める必要があります。
- Meet アドオン SDK をモックアウトし、Meet アドオンが SDK 関数を想定どおりに呼び出すことを確認します。
- 任意のウェブテスト フレームワークを使用して、アドオンの SDK 関連以外のすべての機能を単体テストします。
ユーザー エクスペリエンスのベスト プラクティス
次のベスト プラクティスは、Meet アドオンをより直感的で洗練されたものにするのに役立ちます。
サイドパネルですべての開始状態を管理する
サイドパネルで行われた
ユーザー アクションに基づいてアドオンを設定することを強くおすすめします。
これは、JavaScript でアクティビティの開始
状態を設定
することで行います。
ActivityStartingState
に入力されるすべてのデータは、サイドパネル内でアドオンの開始者（通常は
会議の主催者）によって設定される必要があります。サイドパネルの最初のビューは、アドオンの設定を制御するフォームと考えることができます。
使用していないときはサイドパネルを閉じる
startActivity()
メソッドを呼び出してアクティビティを開始したら、Google Meet アドオンのユーザー エクスペリエンスに不可欠な場合にのみ、サイド
パネルを開いたままにする必要があります。メインステージが開いたら、
unloadSidePanel()
メソッドを呼び出してサイドパネルを閉じることができます。
画面共有で Meet アドオンを宣伝する
Meet アドオンは、画面共有よりも豊富なエクスペリエンスを提供します。 ただし、多くのユーザーは Meet の画面共有機能の使用に慣れています。ユーザーが Meet アドオンをホストするウェブサイトを表示するタブを共有すると、対応する Meet アドオンをインストールまたは使用するように促すバナーをすべての通話参加者に表示するように Meet を構成できます。詳しくは、 画面共有でアドオンを宣伝する をご覧ください。
ロゴのデザインに関するガイドライン
Meet 固有のロゴをデザインする際は、次のガイドラインに従って、現在と将来にわたって最適な外観になるようにしてください。
256 ピクセル x 256 ピクセルの PNG ファイル形式を使用します。
透明度を使用します。
Meet アドオンのデベロッパー ツールを使用して、ダークモードのロゴがダークモードで適切に表示されることを確認します。
Web Accessibility In Mind（WebAIM）の Contrast Checker などのコントラスト チェッカーを使用して、ロゴ（および 画像および映像）が高コントラスト モードで適切に表示されることを確認します。
特定のアプリ統合のグラフィック要件を遵守します。
画像にパディングを含めないでください。代わりに、画像をファイルの境界まで拡張します。