Google Workspace Marketplace のアプリ審査プロセスと要件

• アプリと通信するためのボタンは、説明から利用できます。
• アプリ名は A ～ Z（大文字）または 0 ～ 9 で始まります。記号で始めることはできません。

• ユーザーがダイレクト メッセージを開始するたび、またはアプリがスペースに追加されるたびに、アプリからプロンプトなしでウェルカム メッセージが送信されます。ウェルカム メッセージは「ヘルプ」コマンドとは異なります。詳細については、 Google Chat アプリのホームページを作成するをご覧ください。
• 「Help」コマンドをサポートし、ユーザーがアプリを使用できるようにします。詳細については、 スラッシュ コマンドに応答するをご覧ください。
• スペースやダイレクト Chat で話しかけると、アプリが常に応答します。
• メッセージのスペル、大文字 / 小文字の区別、句読点、文法が正しい。メッセージに悪意のある、冒とく的な、または虐待的なコンテンツが含まれていない。
• メッセージでは、Google の要件に従って、テキストやカードに明確で簡潔で一貫した書式を使用します。
• レスポンスに 2 秒以上かかる場合、アプリは遅延を説明するメッセージを送信します。
• 通知を送信するアプリでは、ユーザーが通知をオフにできるようにします。
• ユーザーは名前リンクを使用してスペースにアプリを追加できます。
• スペースからアプリを削除するには、[メンバーを表示] メニューを使用します。
• アプリは、アプリとやり取りするために必要なものをすべてユーザーに示します。
• アプリで使用しているカード形式が Google の要件を満たしている。 インタラクティブなカードを作成するをご覧ください。
• このアプリは、Chat メニューの [アプリを探す] オプションから利用できます。
• アプリがやり取りする外部 URL がステージング環境や開発環境に属していない。
• スペース内のアプリ宛のメッセージには、必ず名前リンクを含める必要があります。 この方法は、アプリが応答が必要であると認識する唯一の方法です。
• Chat アプリでサードパーティのドメインのリンクがプレビューされる場合:
  • リンク プレビューは、ユーザーのメッセージに関連する補足情報を提供します。たとえば、営業案件へのリンクをプレビューすると、アカウント、金額、ステージなどの情報が追加されます。
  • デベロッパーがプレビュー対象のドメインに属していること。

  詳細については、プレビュー リンクをご覧ください。

• （推奨）Workspace 管理者が組織内のユーザーに代わってアプリをインストールできるようにするには、アプリがダイレクト メッセージを受信および送信できる必要があります。

• アプリに、認識しやすい明確なアバターがある。

• ドライブの HTML を直接操作して機能を提供する目的で Chrome ブラウザの拡張機能は使用されていません。
• アプリで機密性の高いスコープまたは制限付きスコープを使用する場合は、OAuth の検証を受ける必要があります。検証のために送信するにはどうすればよいですか？をご覧ください。
• アプリで制限付きスコープを使用している場合は、セキュリティ評価も受けなければなりません。セキュリティ評価が必要な理由をご覧ください。

• アプリがドライブにファイルを保存する場合は、ユーザーがフォルダを選択できます。また、アプリ固有のフォルダを作成して再利用することもできます。構成データは App Data フォルダに保存できます。ユーザーのマイドライブ フォルダにファイルはダンプされません。
• アプリは、アプリのドキュメント化された機能に関連するファイルのみをドライブに保存します。

• アドオンには、想定されるアクションと必須アクションが含まれており、ワークフローを完了するために必要なすべてのツールが用意されています。以下に例を示します。
  • アドオンがドキュメント全体にスタイルを適用する場合は、選択したテキストにのみスタイルを適用するオプションが用意されています。
  • アドオンがスプレッドシートのデータをウェブサービス フィードにアップロードする場合は、そのフィードへのリンクが用意されているため、簡単に移動できます。
  • アドオンでユーザーにアカウントを要求する場合は、ユーザーがアカウントを持っていない場合に簡単にアカウントを作成できるように、リンクまたは情報を提供します。
• このアドオンの [アドオン] タブの下にメニュー項目があります。
• アドオンがカスタム関数のみであっても、適切なドキュメントが含まれています。
• アドオンは、onInstall() と onOpen() を正しく使用してメニューに項目を追加します。メニュー項目は、アドオンが初めてインストールされたときと、別のファイルが開かれたときに表示されます。 エディタのアドオン認証をご覧ください。
• 認可モードが正しく設定されている。 認可モードをご覧ください。
• アドオンは、Apps Script の V8 ランタイムで実装する必要があります。詳細については、V8 ランタイムの概要をご覧ください。

• アドオンは、プロダクトとその使用方法の基本的な理解に必要なすべての情報を提供します。
• ライブラリはアドオンのパフォーマンス低下を引き起こす可能性があるため、アドオン コードでライブラリを過度に使用していない。
• エラーは可能な限り回避し、回避できない場合は適切に管理します。
  • エラー メッセージは、JavaScript アラートやデフォルトの赤いバーではなく、ダイアログ ウィンドウに表示されます。問題を伝え、その問題を解決するためにユーザーが行う必要があることを簡単な言葉で説明します。
  • 可能であれば、ユーザーが間違った操作をしている場合は、問題を解決するボタンが表示されます。
  • 詳しくは、 アドオンのスタイルガイドをご覧ください。
• 外部ページへのリンクは新しいウィンドウで開き、正しいものです。
• このアドオンは直感的で、デザインも優れています。つまり、次のようになります。
  • 何をすべきか、どのようにすべきかが常に明確である。
  • アドオンはアクセスしやすく、わかりやすいものです。専門用語や専門用語は使わないようにします。
  • ワークフローは明確で、可能な限り円滑に進めます。
  • ユーザーとそのコンテンツをできる限り安全に保つ。
• アドオンは、 エディタ アドオンの UI スタイルガイドに準拠し、 エディタ アドオンの CSS パッケージを使用します。
• このアドオンでは、ディスプレイごとに 1 つの青色のプライマリ アクションのみが使用されます。
• アドオンは、一度に 1 つのダイアログを表示します。重複したり、複数のダイアログを一度に開いたりしない。
• アドオンの UI は、割り当てられたスペースにきちんと収まります。
  • テキストとラベルが「...」で切り捨てられない
  • ユーザーが縦方向にスクロールする頻度が少ない。
  • コンテンツの幅が 300p 以下であるため、水平スクロールバーはありません。
• アドオンによる確認が必要なか、すべての機密情報に関する操作に対して警告が表示される。たとえば、アドオンがスプレッドシート内のすべてのコンテンツを上書きしようとしている場合、ユーザーに警告が表示され、アクションが実行される前に確認を求められます。

  この要件は、設計変更によって回避できます。 たとえば、データをインポートする Google スプレッドシート アドオンを使用すると、既存のコンテンツが上書きされるリスクがあります。デフォルトのアクションとしてデータのシートを作成すると、このリスクを回避できます。

• アクションの読み込み中に、ユーザーがアクションを複数回トリガーすることはできません。たとえば、アクションの読み込み中にボタンがオフになる、または非表示になるなどです。

カレンダー アドオン

• アドオンが calendar.name または common.name を使用する場合、マニフェスト内での名前は、アプリの掲載情報内で指定されている名前と同じになります。
• アドオンが calendar.conferenceSolution を使用している場合、会議ソリューション名に「Google カレンダー」は含まれません。
• （推奨）アドオンが calendar.conferenceSolution を使用する場合、会議ソリューションの名前は 30 文字を超えないようにします。

• アドインは、目的の機能に適した ウィジェット（または Meet アドインの iframe 化された UI）を使用します。たとえば、スイッチを使用してブール値を選択します。

カレンダーのアドオン

• 予備カレンダーと委任はサポートされています。サポートされていない場合は、適切に管理されます。たとえば、予定の作成時に編集権限がある別のカレンダーを選択しても、会議の作成は失敗しません。
• 定期的な予定は適切に機能します。
• アドオンが calendar.conferenceSolution を使用する場合、少なくとも 1 つの会議ソリューションが提供されます。
• アドオンで会議ソリューションが提供される場合は、適切な会議データ フィールドが使用されます。たとえば、ビデオ会議のリンク、電話番号、SIP リンク、アクセスコードなど、サポートされている属性は構造化データ フィールドを使用するため、メモ フィールドには記載されません。
• アドオンが会議ソリューションを提供する場合、会議の詳細のみを編集し、他の予定フィールドは編集しません。
• アドオンが会議ソリューションを提供している場合、会議の作成に 5 秒未満かかります。

Gmail アドオン

アドオンが UrlFetchApp または OpenLinkUrl を使用する場合:

• URL は有効です。
• URL は HTTP ではなく HTTPS を使用しています。
• ドメイン全体を指定します。
• パスが空でないこと。たとえば、https://altostrat/ は使用できますが、https://altostrat は使用できません。
• UrlFetchApp ではワイルドカードを使用できません。

Meet アドオン

• サードパーティ Cookie が無効になっている場合でも、アドオンのログインとユーザー ジャーニーが機能している必要があります。
• アドオンは、会議の運用または会議への参加に関連する機能を提供する必要があります。
• ブラウザの更新など、ユーザーが会議を離れる原因となる動作は、アドオンで行ってはなりません。
• マルチプレーヤー エクスペリエンスを使用する場合は、権限が事前に設定されていなくても、すべての参加者がコンテンツを共同編集できるようにする必要があります。権限の調整は、共同編集アドオン セッション中に行う必要があります。
• アドオンは、アクティビティの開始フローのキャンセルを処理し、ユーザーがアプリからアクティビティの開始を再開できるようにする必要があります。
• アドオンには、アクティビティ エクスペリエンスのログインと設定用のサイドパネルが必要です。
• アドオンで bot を招待する機能や、会議における bot の存在に依存する機能は許可されません

• アドオンにホームページがあります。Google Workspace アドオンが変換された Gmail アドオンの場合は、デフォルトのホームページが適用されます。
• アドオンカード（または Meet アドオンでは iframe 付きの UI）が適切に機能する。たとえば、重複するアイテムはなく、[戻る]、[更新]、[更新] ボタンが適切に機能します。
• ユーザーがアドオンを承認すると、カスタマイズされたホームページ カード（Meet アドオンのウェブページ）が表示され、ログイン ボタン（必要に応じて）、ロゴ、アドオンの簡単な説明とともにユーザーを迎えます。
  • ログインボタンがトリガーされると、サードパーティ ベンダーのカスタマイズされたログインページが表示されます。このページには、Google Workspace の外部で動作するサードパーティ サービスがあることが明記されています。
• アドオンの UI は、割り当てられたスペースにきちんと収まります。
  • テキストとラベルが「...」で切り捨てられない
  • ユーザーが縦方向にスクロールする回数を減らせる。
  • コンテンツの幅が 300 ピクセルを超えないようにして、横方向のスクロールバーが表示されないようにします。
• ライブラリはアドオンのパフォーマンス低下を引き起こす可能性があるため、アドオンのコードではライブラリを過度に使用しない。

カレンダーのアドオン

• アドオンが会議システムを提供している場合、作成された会議は有効であり、サードパーティ製会議システムのウェブサイトに正しく表示されます。

ドキュメント アドオン

アドオンがサードパーティのドメインのリンクをプレビューする場合（スマートチップ）:

• リンク プレビューは、ユーザーに関連性の高い補足情報を提供します。 たとえば、販売取引へのリンクをプレビューすると、アカウント、金額、ステージなどの情報が追加されます。
• デベロッパーがプレビュー対象のドメインに関連付けられている。

詳細については、スマートチップを使用してリンクをプレビューするをご覧ください。

ドライブのアドオン

• アプリがドライブにファイルを保存する場合は、ユーザーがフォルダを選択できます。また、アプリ固有のフォルダを作成して再利用することもできます。構成データは、アプリデータ フォルダに保存できます。アプリは、ユーザーのマイドライブ フォルダにファイルをダンプしません。
• アドオンは、アドオンの文書化された機能に関連付けられているファイルのみをドライブに保存します。

Gmail アドオン

• 正当な理由なしに、Chrome ブラウザの拡張機能について言及したり、リンクしたりしていません。
• [その他の操作] メニュー more_vert には、適切に機能するユニバーサル アクションが含まれています。たとえば、[ログアウト]、[概要]、[サポート] などです。

Meet アドオン

• アドオンにライセンスまたは定期購入が必要な場合: ユーザーにライセンスがない場合は、ユーザー フレンドリーなメッセージを表示する必要があります。
• ライセンスの問題が原因でユーザーがアドオンを使用できない場合は、エラー メッセージにアドオンを使用できない理由を明記し、ユーザーに状況を是正するための対処方法を提示する必要があります。
• アドオンの Google Workspace Marketplace の掲載情報には、アドオンの使用に必要となるライセンスとサブスクリプションの要件について詳しく記載する必要があります。アドオンに有料の階層がある場合は、Marketplace リスティングに、料金や営業担当者への連絡方法に関する詳細情報を提供するウェブページへのリンクを記載する必要があります。
• ユーザーがまだログインしていない場合、アドオンは [Google One Tap を表示] で指定したワンタップ ログイン プロンプトと、[認証] で指定した「Google でログイン」の代替手段を表示する必要があります。「Google でログイン」メカニズム以外にも、他のログイン オプションが提供される場合があります。
• アドオンには、コンテンツをさまざまなサイズに適応させることができるレスポンシブ デザインが必要です。
• サードパーティ Cookie が無効になっている場合でも、アドオンのユーザー ジャーニーが機能している必要があります。
• アドオンで iframe 内に水平スクロールを使用することはできません。
• アドオンでメイン画面を使用する場合は、マルチプレーヤー エクスペリエンス用に設計し、複数の参加者が同時にコンテンツを操作できるようにする必要があります。シングル プレーヤー エクスペリエンスの場合は、サイドパネルを使用する必要があります。
• （推奨）アドオンには、ログインしているユーザーが表示されます。
• （推奨）ローカライズの選択: ブラウザが設定したローカル設定に基づいて言語がカスタマイズされるものにします（可能な場合）。
• （推奨）コンテンツの選択は、最近アクセスしたコンテンツを表示するコンテンツ ブラウジング インターフェースから行う必要があります。
• （推奨）アドオンは、メインステージを起動した後に、サイドパネルが不要になった場合にサイドパネルを閉じる必要があります。

カレンダー アドオン

• 会議ソリューションのロゴは公開 URL です。 会議ソリューションのロゴを提供するをご覧ください。
• アドオンで calendar.conferenceSolution を使用する場合、会議ソリューションのロゴは calendar.logoUrl の要件に準拠しています。 カレンダー マニフェスト リソースをご覧ください。
• アドオンで calendar.logoUrl または common.logoUrl を使用する場合、ロゴはアプリの掲載情報に表示されるアイコンと同じになります。
• アドオンで calendar.logoUrl または common.logoUrl を使用している場合、ロゴの URL は https://lh3.googleusercontent.com/ で始まります。

Meet アドオン

• アドオンのブランドロゴは、Meet のサイドパネルで識別できるサイズとスタイルにする必要があります。
• 適切なダークモードのロゴの URL をアドオンのmanifestで指定する必要があります。

ドライブのアドオン

• （推奨）制限付きのメタデータを受け取る場合、アドオンに drive.addons.metadata.readonly スコープを含めます。

• ユニバーサル ナビゲーション URL はウェブアプリを指します。機能のない単純なウェブページは、ウェブアプリとは見なされません。