このページでは、Google Workspace Marketplace SDK を使用して Google Workspace Marketplace でアプリを構成および管理する方法について説明します。
アプリを利用できるようにするには、Marketplace SDK でアプリを設定する必要があります。Marketplace SDK は、Marketplace でアプリを作成して制御できるツールキットです。Marketplace SDK を使用して、次のような Marketplace の設定を管理します。
- アプリが特定の Google Workspace 組織（非公開アプリ）で利用可能か、すべての Marketplace ユーザー（公開アプリ）で利用可能か
- アプリをインストールできる Marketplace ユーザーの種類
- アプリが統合されている Google Workspace アプリケーション
- アプリに必要な OAuth スコープ
- アプリの構築と保守を行うユーザーに関する情報
アプリを限定公開するか一般公開するかに関係なく、Marketplace SDK を使用して Marketplace でアプリを管理する必要があります。
Marketplace SDK を有効にする
Google Cloud プロジェクトで、 Marketplace SDK をまだ有効にしていない場合は有効にします。
Google Cloud コンソールでクラウド プロジェクトを開く
まだ開いていない場合は、このサンプルで使用するクラウド プロジェクトを開きます。
- Google Cloud コンソールで、[プロジェクトを選択] ページに移動します。
- 使用する Google Cloud プロジェクトを選択します。または、[プロジェクトを作成] をクリックし、画面上の手順に沿って操作します。Google Cloud プロジェクトを作成する場合は、プロジェクトの課金を有効にする必要がある場合があります。
Marketplace SDK を有効にする
Google API を使用する前に、Google Cloud プロジェクトで API を有効にする必要があります。1 つの Google Cloud プロジェクトで 1 つ以上の API を有効にできます。Google Cloud コンソールで、Google Workspace Marketplace SDK を有効にします。
アプリの構成設定を決定する
次のリファレンスでは、Marketplace SDK の [アプリの構成] ページで使用できる設定について説明します。
アプリを閲覧してインストールできるユーザーを選択する
アプリを構成する際に、次の設定を使用してアプリにアクセスできるユーザーを指定します。
- アプリの公開設定: Google Workspace 組織内でアプリを公開する場合、アプリの掲載情報を非公開にするか、組織内のすべてのユーザーに公開するか、Google Workspace を使用するすべてのユーザーに公開するかを指定します。
- インストール設定: アプリをインストールできるのは Google Workspace 管理者のみかどうか。
アプリの掲載情報で指定した設定に関係なく、Google Workspace 組織に属するユーザーは、管理者が設定した内容によっては、アプリを見つけたり、インストールしたり、使用したりできない場合があります。管理者は、アプリの利用可否に次のような影響を与える可能性があります。
- ユーザーが Marketplace でアプリを表示できるかどうか、およびユーザーに代わってアプリをインストールできるかどうかを制御します。
- 許可リストを使用して、組織のアプリを管理、キュレートします。許可リストを使用する組織向けのアプリを開発している場合は、アプリを許可リストに追加する方法について管理者にお問い合わせください。
- Google Chat、Google Chat アプリ、またはその両方へのアクセス権を削除するなど、特定の Google Workspace アプリケーションを無効にします。このような場合、ユーザーは Marketplace からアプリをインストールできません。
管理者が Marketplace へのアクセスを管理する方法については、 Marketplace 管理者向けヘルプのドキュメントをご覧ください。
アプリの公開設定
Google Workspace アカウント（職場や学校の組織によって作成されたアカウント）を使用している場合は、[アプリの公開設定] オプションが表示されます。個人用アカウント（末尾が「@gmail.com」のアカウント）を使用している場合は、公開のみが可能です。
- 一般公開: ドメイン外のユーザーがアプリを見つけてインストールできます。公開設定を選択すると、アプリの掲載情報は公開前に Google の審査を受け、承認されます。
- 非公開: ドメイン内のユーザーのみがアプリを検索してインストールできます。
[限定公開] として公開することを選択した場合、アプリの掲載情報はブラウジングや検索結果に表示されません。ユーザーは、直接 URL を使用してのみアプリのストアページにアクセスできます。
アプリを利用できる国や地域を制限する場合は、ストアの掲載情報を作成する際に [配信] セクションで設定します。
アプリのインストール設定
[インストール設定] オプションでは、ユーザーまたは Google Workspace 管理者が Marketplace のストア掲載情報ページからアプリをインストールできるかどうかを指定します。
- 個別インストールと管理者によるインストール（デフォルト）: 個々のユーザーがアプリをインストールすることも、管理者がドメイン、組織部門、ユーザー グループに対してアプリをインストールすることもできます。個別のインストールが有効になっていても、ユーザーのドメイン ポリシーによってアプリのインストールが禁止されている場合があります。
- 管理者のみによるインストール: アプリは、ドメイン、組織部門、ユーザー グループの管理者のみがインストールできます。アプリは、Google Workspace Marketplace の検索結果に、管理者と Google アカウントにログインしていないユーザーに対してのみ表示されます。アプリでドメインのインストールが必要な場合は、このオプションを選択します。
一般的なインストールと公開設定
次の表に、インストールと可視性に関する一般的なアプリ構成オプションの一部を示します。
| アプリの対象ユーザー | アプリの公開設定 | アプリのインストール設定 | アプリをインストールできるのは誰ですか？ | アプリの対象ユーザー | |
|---|---|---|---|---|---|
| Google Workspace 組織向けに構築されたアプリの場合 | |||||
| 組織内の特定のユーザー | 非公開と限定公開 | 個別インストールと管理者によるインストール | 許可されている場合、アプリの掲載情報の URL を知っている組織内のすべてのユーザー。 | 許可されている場合、アプリの掲載情報の URL を知っている組織内のすべてのユーザー。 | |
| あなたの組織 | プライベート | 個別インストールと管理者によるインストール | 許可されている場合は、組織内のすべてのユーザー。 | 許可されている場合は、組織内のすべてのユーザー。 | |
| あなたの組織 | プライベート | 管理者のみ | 管理者 | 管理者がアプリをインストールしたユーザー。 | |
| 特定の Google Workspace 組織外のユーザーが利用できるアプリの場合 | |||||
| Google Workspace 組織のユーザー | 公開 | 管理者のみ | 管理者 | 管理者がアプリをインストールしたユーザー。 | |
| すべての Google Workspace ユーザー | 公開 | 個別インストールと管理者によるインストール |
|
|
|
アプリが Google Workspace アプリケーションとどのように統合されるかを特定する
[アプリの統合] オプションでは、アプリまたはアドオンが連携するように設計されている Google Workspace サービス（Google Workspace アドオンや Google Chat 用アプリなど）を選択できます。少なくとも 1 つのオプションを選択する必要があります。場合によっては、アプリの掲載情報に複数のアプリ統合を含めることができます。アプリの統合をまとめて一覧表示するをご覧ください。
各 Google Workspace アドオンについて、サポートされている各ホストプロダクトの公開ステータスがページに表示されます。これにより、ユーザーが利用できる統合を把握できます。アプリの統合ステータスには次のものがあります。
Unsaved: インテグレーションを追加または変更したが、[アプリの構成] タブで変更を保存していない。Draft: 変更内容は保存されていますが、公開されていません。Under review: 更新したアプリ統合を審査のために送信しました。Published: アプリの統合が Marketplace のリスティングに含まれています。
選択するアプリ統合によっては、追加情報の提供や、Google Cloud プロジェクトでの関連する API の有効化が必要になる場合があります。次の表に、それぞれに必要な追加設定を示します。
Google Workspace アドオン
Google Workspace アドオンを公開するには、アドオンのデプロイ ID を指定する必要があります。
Apps Script でデプロイ ID を確認する手順は次のとおりです。
- Apps Script エディタで Google Workspace アドオンを開きます。
- [Deploy > Manage deployments] をクリックします。
- デプロイ ID の下にある [コピー] をクリックします。
HTTP アドオンのデプロイ ID を確認する手順は次のとおりです。
- [アプリの構成] ページの [Google Workspace アドオン] で、[HTTP またはその他のデプロイ> デプロイを選択] をクリックします。
- 公開するデプロイを選択します。
- [選択] をクリックします。
エディタ アドオン（ドキュメント、スプレッドシート、スライド、フォーム）
エディタ用アドオンを公開するには、公開するプロジェクト スクリプト ID とバージョンを指定する必要があります。
プロジェクト スクリプト ID を確認する手順は次のとおりです。
- Apps Script エディタでアドオンを開きます。
- 左側の [プロジェクト設定] をクリックします。
- [ID] で、スクリプト ID をコピーします。
バージョンを確認する手順は次のとおりです。
- Apps Script エディタでアドオンを開きます。
- 右上にある [デプロイ > デプロイを管理] をクリックします。
- バージョン番号は [Configuration]（設定）に表示されています。
Google Chat 用アプリ
インタラクティブな Google Chat アプリを公開するには、次のドキュメントをご覧ください。
- Chat API で Chat 用アプリを構成するには、Chat API を構成するをご覧ください。
- Google Workspace アドオンではない Chat 用アプリを構築した場合は、Chat API でインタラクション イベントの設定を構成する必要があります。手順については、ユーザー インタラクションを受け取って応答するをご覧ください。
- AppSheet の自動構成を使用して Chat 用アプリを構築した場合は、AppSheet のドキュメントの自動構成を使用して Chat 用アプリを共有するで説明されている手順に沿って、Chat 用アプリを公開します。
ドライブアプリ
ドライブアプリを公開するには、 Google Drive API を有効にして構成する必要があります。
ウェブアプリ
ウェブアプリを公開するには、ユニバーサル ナビゲーション URL（Google アプリ メニュー からウェブアプリを指す URL）を指定する必要があります。ウェブアプリは本番環境で完全に機能している必要があります。
ストアの掲載情報ページに記入する際は、96x96 ピクセルと 48x48 ピクセルのサイズの追加アイコンも用意する必要があります。
Apps Script でウェブアプリを構築した場合は、次の手順でユニバーサル ナビゲーションの URL を取得します。
- Apps Script エディタで Google Workspace アドオンを開きます。
- [Deploy] > [New deployment] をクリックします。
- [タイプを選択] で [ウェブアプリ] をクリックします。
- オプションを入力して、[デプロイ] をクリックします。
- [コピー] をクリックします。
アプリに必要なアクセス権限のレベルを指定する
[OAuth スコープ] で、アプリに必要な OAuth 2.0 スコープの完全なリストを指定します。ここで入力する OAuth スコープは、OAuth 同意画面に表示されるスコープと一致している必要があります。該当する場合は、Apps Script マニフェストとも一致している必要があります。
複数のアプリ統合を含める場合は、各アプリ統合のスコープを Marketplace SDK の [アプリの構成] ページと OAuth 同意画面に追加してください。
常に可能な限り最小限のスコープを使用してください（たとえば、読み取り専用スコープのみが必要な場合は、完全なドライブ スコープを含めないでください）。
Apps Script プロジェクトについては、認証スコープをご覧ください。
アプリ デベロッパーに関する情報を提供する
[デベロッパー情報] で、連絡先情報などの詳細を入力します。これらのフィールドは、アプリのストアの掲載情報ページに表示されます。
| フィールド | |
|---|---|
| 取引業者ステータス |
消費者保護法により、この Marketplace の販売者が取引業者であるか、非取引業者かを、欧州経済領域（EEA）の消費者に通知する必要があります。
指定しない場合、アプリのストアの掲載情報ページに「取引業者のステータスが未設定です」と表示されます。 |
| デベロッパー名 | アプリの作成者として表示する名前。取引業者の場合は、商号または戸籍上の姓名を記入してください。 |
| デベロッパーの送付先住所 |
トレーダーには必須です。非取引業者については収集されません。 ビジネスの所在地。連絡可能な有効な住所を入力してください。 |
| デベロッパー ウェブサイトの URL | デベロッパーとしてお客様（またはお客様の組織）を紹介しているウェブサイト。 |
| デベロッパーのメールアドレス |
連絡先として使用するメールアドレス。アプリの掲載情報には含まれません。このメールアドレスは、次の用途で使用されるため、常に最新の状態に保つ必要があります。
|
| アプリケーション ウェブサイトの URL | 省略可。アプリについて詳しく説明しているウェブサイト。 |
Marketplace SDK でアプリの構成設定を保存する
前のセクションの情報を使用して、Marketplace SDK でアプリの構成を保存します。
Google Cloud コンソールで、Marketplace SDK の [アプリの構成] ページに移動します。
前のセクションで特定した内容に基づいて、各セクションに入力します。
[下書きを保存] をクリックします。
（省略可）Google アナリティクスでアプリの使用状況に関する分析情報を取得できます。そのためには、Marketplace SDK で Google アナリティクス ID を追加します。
- [アナリティクス] タブに移動します。
- Google アナリティクス ID を入力します。
- [保存] をクリックします。
トラブルシューティング
このセクションでは、発生する可能性のある一般的な問題について説明します。
Marketplace にアプリを公開する際に必要な権限がない
Marketplace SDK の [アプリの構成] ページでアプリケーションを構成しようとすると、次のエラー メッセージが表示され、Marketplace でアプリを公開できません。
You are missing at least one of the following required permissions: Project workspacemarketplace.appconfiguration.view / workspacemarketplace.appconfiguration.update
このエラーは、Marketplace SDK API が有効になっていて、Editor または Owner 以外の IAM ロールを使用している場合に発生します。
このエラーを解決するには、次のいずれかの解決策を実装します。
不足している権限を持つアカウントに
roles/appmetadata.workspaceMarketplaceAppConfigurationAdminロールを割り当て、Marketplace SDK でアプリを構成して管理できるようにするよう、プロジェクト オーナーに依頼してください。Google Cloud コンソールの [IAM と管理] > [ロール] ページで、カスタムロールに不足している権限を追加するようプロジェクト オーナーに依頼します。次に、権限が不足しているアカウントにカスタムロールを割り当てます。
アプリの公開には、プリミティブ
roles/editorまたはroles/ownerを使用できます。ただし、IAM を安全に使用するドキュメントでは、プロジェクト内の他のリソースへの編集アクセスを簡単に制限できないため、この方法は推奨されていません。