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

• アプリと通信するためのボタンが説明欄に表示されます。
• アプリ名は A ～ Z（大文字）または 0 ～ 9 で始まります。先頭を記号にすることはできません。

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

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

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

• アプリのアバターが識別可能で鮮明になっている。

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

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

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

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

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

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

カレンダーのアドオン

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

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

カレンダーのアドオン

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

Gmail アドオン

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

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

• アドオンにはホームページがあります。Google Workspace アドオンが変換後の Gmail アドオンの場合は、デフォルトのホームページが適用されます。
• アドオンカードは正しく機能しています。たとえば、カードが重複することはありません。戻るボタン、更新ボタン、更新ボタンは適切に機能します。
• ユーザーがアドオンを承認すると、カスタマイズされたホームページ カードが表示され、ログインボタン（必要な場合）、ロゴ、アドオンの簡単な説明が表示されます。
  • ログインボタンがトリガーされると、サードパーティ ベンダーのカスタマイズされたログインページが表示され、Google Workspace の外部でサードパーティ サービスが動作していることを明確に示しています。
• アドオンの UI は、割り当てられたスペースにぴったり収まります。
  • テキストとラベルが「...」で切れない
  • ユーザーが縦方向にスクロールする必要はあまりありません。
  • コンテンツの幅は 300p を超えないため、水平方向のスクロールバーは表示されません。
• ライブラリによってアドオンのパフォーマンスが低下する可能性があるため、アドオンのコードでライブラリを過度に使用しないでください。

カレンダーのアドオン

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

ドキュメントのアドオン

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

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

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

ドライブのアドオン

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

Gmail アドオン

• 正当な理由なく、アドオンに Chrome ブラウザ拡張機能への言及やリンクは記載されていません。
• その他の操作メニューmore_vert には、正常に動作する一般的な操作が含まれています。たとえば、ログアウト、概要、サポートなどです。

カレンダーのアドオン

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

ドライブのアドオン

• （推奨）制限付きメタデータを受信する場合、アドオンには drive.addons.metadata.readonly スコープが含まれています。

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