Google Workspace Marketplace SDK でアプリを構成する

このページでは、Google Workspace Marketplace SDK を使用して、Google Workspace Marketplace でアプリを構成および管理する方法について説明します。

アプリを使用できるようにするには、Google Workspace Marketplace SDK でアプリを設定する必要があります。Google Workspace Marketplace SDK は、Google Workspace Marketplace でアプリを作成して管理できるツールキットです。Google Workspace Marketplace SDK を使用して、次のような Marketplace の設定を管理します。

  • アプリを特定の Google Workspace 組織で利用できるか(限定公開アプリ)、すべての Marketplace ユーザーが利用可能か(公開アプリ)か。
  • アプリをインストールできる Marketplace ユーザーのタイプ
  • アプリが統合される Google Workspace アプリケーション
  • アプリに必要な OAuth スコープ
  • アプリの作成とメンテナンスを誰が行うのかに関する情報

アプリを一般公開するか限定公開するかにかかわらず、Google Workspace Marketplace SDK を使用して Marketplace 上のアプリを管理する必要があります。

Google Workspace Marketplace SDK を有効にする

まだ有効にしていない場合は、Google Cloud プロジェクトで Google Workspace Marketplace SDK を有効にします。

  1. Google Cloud コンソールを開きます。
  2. 上部の [プロジェクトを選択] をクリックします。別の Google Cloud プロジェクトがすでに開いている場合は、Cloud プロジェクト名をクリックして Cloud プロジェクトを切り替えます。
  3. アプリの Cloud プロジェクトを選択し、[開く] をクリックします。
  4. 上部の検索バーに「Google Workspace Marketplace SDK」と入力して Enter キーを押します。
  5. Google Workspace Marketplace SDK のページを開きます。

  6. Google Workspace Marketplace SDK がまだ有効になっていない場合は、[有効にする] をクリックします。

Google Workspace Marketplace SDK でアプリの設定を入力する

  1. Google Workspace Marketplace SDK を開きます。
  2. [アプリの構成] タブに移動します。
  3. 各セクションに、アプリに関する情報を入力します。各設定の詳細については、アプリの構成設定のセクションをご覧ください。
  4. [保存] をクリックします。
  5. (省略可)Google アナリティクスアプリの使用状況に関する分析情報を取得できます。これを行うには、Google Workspace Marketplace SDK で Google アナリティクス ID を追加します。
    1. [分析] タブに移動します。
    2. Google アナリティクス ID を入力します。
    3. [保存] をクリックします。

アプリの構成設定

ここでは、Google Workspace Marketplace SDK の [アプリの構成] ページで利用できる設定について説明します。

アプリの公開設定

Google Workspace アカウント(職場や学校の組織によって作成されたアカウント)を使用している場合は、[アプリの公開] オプションが表示されます。一般ユーザー向けアカウント(末尾が「@gmail.com」のアカウント)を使用している場合、公開できるのは一般公開のみです。

  • 公開: ドメイン外のユーザーにアプリを見つけてインストールできます。一般公開を選択すると、Google がアプリの掲載情報の審査と承認を行ってから公開します。
  • 非公開: ドメイン内のユーザーのみがアプリを見つけてインストールできます。

[限定公開] として公開することを選択した場合、アプリの掲載情報はブラウジングや検索結果に表示されません。ユーザーは直接 URL を使用してアプリのストアページにのみアクセスできます。

アプリを利用できる国や地域を制限したい場合は、ストアの掲載情報を作成する際に [配信] セクションで設定します。

設置の設定

インストール設定によって、ユーザーまたは Workspace 管理者が Google Workspace Marketplace のストアの掲載情報ページからアプリをインストールできるかどうかが決まります。

  • 個別 + 管理者によるインストール(デフォルト): 個々のユーザー、またはドメイン、組織部門、ユーザー グループの管理者がアプリをインストールできます。個々のインストールが有効になっている場合でも、ユーザーのドメイン ポリシーによってアプリをインストールできないことがあります。
  • 管理者のみによるインストール: アプリは、ドメイン、組織部門、またはユーザー グループの管理者のみがインストールできます。アプリは、管理者と Google アカウントにログインしていないユーザーの Google Workspace Marketplace の検索結果にのみ表示されます。アプリがドメインへのインストールを必要とする場合は、このオプションを選択します。

アプリへの組み込み

Google Workspace アドオンや Google Chat アプリなど、アプリまたはアドオンと連携させる Google Workspace サービスを選択します。少なくとも 1 つのオプションを選択する必要があります。アプリの掲載情報に複数のアプリ統合を含めることもできます。アプリ統合を一覧表示するをご覧ください。

選択したアプリ統合によっては、より多くの情報を提供し、Google Cloud プロジェクトで関連する API を有効にする必要があります。次の表に、それぞれに必要な追加設定を示します。

Google Workspace アドオン(Apps Script)

Google Workspace アドオンを公開するには、アドオンのデプロイ ID を指定する必要があります。デプロイ ID を確認する手順は次のとおりです。

  1. Apps Script エディタで Google Workspace アドオンを開きます。
  2. [デプロイ] > [デプロイを管理] をクリックします。
  3. デプロイ ID の下にある [コピー] をクリックします。

Google Workspace アドオン(代替ランタイム)

Google Apps Script 以外のコーディング言語で Google Workspace アドオンを作成した場合は、次の手順に沿って、Google Cloud デプロイ リソースからデプロイ ID を取得します。

  1. [アプリの構成] ページの [Google Workspace アドオン] で、[クラウド デプロイ リソースを使用してデプロイ] > [デプロイを選択] をクリックします。
  2. 公開するデプロイメントを選択します。
  3. [選択] をクリックします。

エディタ アドオン(ドキュメント、スプレッドシート、スライド、フォーム)

エディタ アドオンを公開するには、公開するプロジェクト スクリプト IDバージョンを指定する必要があります。

プロジェクト スクリプト ID を確認する手順は次のとおりです。

  1. Apps Script エディタでアドオンを開きます。
  2. 左側にある [プロジェクト設定] をクリックします。
  3. [ID] でスクリプト ID をコピーします。

バージョンを確認する手順は次のとおりです。

  1. Apps Script エディタでアドオンを開きます。
  2. 右上の [デプロイ] > [デプロイを管理] をクリックします。
  3. バージョン番号は [設定] の下に表示されています。

Google Chat アプリ

Google Chat アプリを公開するには、Google Chat API を構成する必要があります。 アプリの公開をご覧ください。

ドライブ アプリ

ドライブアプリを公開するには、 Drive API を有効にして構成する必要があります。

ウェブアプリ

ウェブアプリを公開するには、ユニバーサル ナビゲーション URL(Google アプリのメニュー からウェブアプリを指す URL)を指定する必要があります。本番環境では、ウェブアプリが完全に機能している必要があります。

ストアの掲載情報ページに記入する際は、追加のアイコンを 96x96 と 48x48 ピクセルのサイズで提供する必要があります。

Apps Script でウェブアプリを作成した場合、ユニバーサル ナビゲーション URL を取得する手順は次のとおりです。

  1. Apps Script エディタで Google Workspace アドオンを開きます。
  2. [デプロイ] > [新しいデプロイ] をクリックします。
  3. [種類を選択] で [ウェブアプリ] をクリックします。
  4. オプションを入力して、[デプロイ] をクリックします。
  5. [コピー] をクリックします。

OAuth スコープ

アプリに必要な OAuth スコープの完全なリストを提供します。ここに入力する OAuth スコープは、OAuth 同意画面に表示されているスコープと一致している必要があります。また、該当する場合は Apps Script マニフェストの場合もあります。

複数のアプリ統合を含める場合は、それぞれのスコープを Google Workspace Marketplace SDK アプリの構成ページと OAuth 同意画面に追加してください。

常に可能な限り狭いスコープを使用してください(たとえば、読み取り専用のスコープのみが必要な場合は、ドライブの完全なスコープを含めないでください)。

Apps Script プロジェクトについて詳しくは、スコープをご覧ください。

開発者向け情報

これらのフィールドは、アプリのストアの掲載情報ページに表示されます。

フィールド
取引業者のステータス

消費者保護法により、欧州経済領域(EEA)の消費者は、Google Workspace Marketplace の販売者がトレーダートレーダー以外かについて通知を受ける必要があります。

  • トレーダー - トレーダーとは、トレーダーの名義で、またはトレーダーの代理として、取引、ビジネス、組合、職業に関連する活動をする人を指します。
  • 取引業者以外 - 取引業者以外(消費者)とは、職業以外の目的で活動する人のことです。

指定しない場合は、アプリのストアの掲載情報ページに「Trader statusspecified(取引業者ステータス未指定)」が表示されます。

デベロッパーの送付先住所

トレーダーの場合は必須です。取引業者以外については収集されません。

ビジネスの所在地。連絡可能な有効な住所を入力してください。

デベロッパー名 アプリの作成者として表示する名前。トレーダーの場合は、商号または正式名を提供します。
デベロッパー ウェブサイトの URL あなた(またはあなたの組織)がデベロッパーであることを説明するウェブサイト。
デベロッパーのメールアドレス

連絡先として使用するメールアドレス。この情報はアプリの掲載情報に含まれていません。このメールアドレスが最新の状態であることを確認してください。以下が使用されています。

  • Google がデベロッパーに連絡する必要がある場合(アプリの審査プロセス中など)。
  • [ストアの掲載情報] ページに [問題の報告] の URL が指定されていない場合に、エディタのアドオンからフィードバックを送信する場合。
アプリケーションのウェブサイトの URL (省略可)アプリについて詳しく説明しているウェブサイト。