Google Workspace アドオンを作成する

新しい Google Workspace アドオンを構築する場合は、 手順は次のとおりです。

  1. アドオンのプロジェクトを設定してオーナーを選択する 共同で作業できます
  2. アドオンの外観と動作を設計する。
  3. アドオンのプロジェクト マニフェストを構成するか、 Deployment リソースです。
  4. アドオンの外観を定義するコードを記述し、 確認します。
  5. アドオンの OAuth スコープを確認します。
  6. ホスト アプリケーション あります。
  7. アドオンを公開します。

アドオンのプロジェクトを設定し、オーナーと共同編集者を選択する

Apps Script でアドオンを構築する場合は、 Apps Script プロジェクトと Google Cloud プロジェクトの両方を作成します。 Google 以外の言語でアドオンを構築する場合、 Apps Script では、Google Cloud プロジェクトを作成するだけで済みます。

アドオンの開発を始める前に、1 つの プロジェクトを所有し、どのアカウントを できます。プロジェクトのオーナーがプロジェクト ファイルを作成、管理する 共同編集者はコーディングやテストを手伝うことができます。

Apps Script プロジェクト

アドオンの Apps Script をビルドできます プロジェクト ファイルを共有 ドライブ。 1 つのアカウントの所有権が独占的になります。アドオンの配置 編集することで、複数の共同編集者がそれらのファイルに 構成する必要があります。

アドオンを公開すると、1 つのユーザー アカウントが (パブリッシャーとして)公開元のアカウントには、スクリプトの編集権限が必要です オーナーである必要はありません。

Apps Script プロジェクトを作成するには、スクリプト プロジェクトをご覧ください。

Google Cloud プロジェクト

Google Chat で共同編集者を アドオンの Cloud プロジェクト。 これにより、チームのメンバーがいつでもアクセスして アドオンのクラウド設定に移動します。

Google Cloud プロジェクトを作成するには、Google Cloud プロジェクトを作成するをご覧ください。

アドオンの外観と動作を設計する

アドオンの外観と方法を決定します ビルドを開始する前に動作する必要があります。クラウド コンピューティング モデル ソリューションの提供を試みます。開始 シンプルなデザインで作業を開始してから 改良を加えていきます

Google Workspace アドオンのスタイルガイドを参照 設計する方法に関するガイドラインをご覧ください。 体験できます

アドオン プロジェクト マニフェストを構成する

Apps Script プロジェクトでは、プロジェクト マニフェストは特殊な JSON 表示されます。ライブラリなど、プロジェクトに関するさまざまな詳細を指定します。 確認します。Google Workspace アドオンの場合、マニフェストには基本的な ホスト アプリケーションで表示に必要な情報が 確認します。

構成方法の詳細については、マニフェストをご覧ください。 Apps Script でアドオンのマニフェストを指定します。

アドオンにコードや機能を追加する際は、 必要なアドオンを生成するために、必要に応じてマニフェストを 確認します。

アドオンのコーディング

API 呼び出しにはカードベースのインターフェースを実装する必要があります。 できます。Apps Script の カードサービスの場合、または別のコード言語で記述している場合は、 インターフェースがカードとしてレンダリングされるようにします。

また、トリガー 関数を指定します。 追加します。お使いの アドオンが Google 以外のサードパーティのサービスに接続する 使用したい場合は、そのように OAuth を サービスでも確認できます。

カードを作成する

アドオンのユーザー インターフェースを定義するには、 Card 個のオブジェクトを作成し、それらに ウィジェット。トリガー関数 マニフェストでは、terraform plan または terraform apply の Card オブジェクトまたは 以下を表す Card オブジェクト 別の「ページ」クリックします。お客様の 新しいカードの作成や表示もできます 自動的に適用されます。

Apps Script では、 CardBuilder クラス。各 カードには CardHeader が必要 と 1 つ以上 CardSections。すべきこと 各カードセクションには できます。操作 ウィジェットは、 アクションにリンクされて、ユーザーが ユーザーの行動を把握できます

すべてのセクションとウィジェットを CardBuilder は、 CardBuilder.build() 対応する Card オブジェクトを作成します。

他の組み込みの Apps Script を使用して、 などのサービス 取得するには CalendarApp 作成したアドオンカードに表示する情報です。 Google 以外のサービスから取得したデータも使用できます。

Google Workspace アドオンで OAuth を必要とする Google 以外の API にアクセスする必要がある場合は、 そのサービスを構成して接続する必要があります。詳しくは、 Google 以外のサービスのガイド 詳しく見ていきます。

工事指示

カードを作成する際は、上から順に作成する必要があります。つまり、この引数を 作成順序:

  1. ウィジェットを作成します。
  2. カード セクションにウィジェットを追加します。
  3. カード セクションにすべてのウィジェットが表示されるまで、この手順を繰り返します。
  4. カードにカード セクションを追加します。

カードまたはカード セクションにウィジェットを追加すると、 実際にはそのウィジェットのコピーを追加しています。ウィジェットに変更を加えた場合 追加した後にそのオブジェクトは、最後のカードには反映されません。

ユニバーサル アクション

ユニバーサル アクションを使用できます コンテキストに依存しない機能を提供します。ユニバーサル アクションはメニュー項目 どのカードがどのカードを使用しているかにかかわらず 表示されます。定義済みのユニバーサル アクションはすべて、常に カードメニューを開きます

詳しくは、ユニバーサル アクションをご覧ください。 表示されます。

アドオンの OAuth スコープを確認する

スコープは、プロジェクトが実行するアクションを 委任が許可されています。Google スコープを設定することをおすすめします 必要ありません。

アドオン プロジェクトでは、 アドオン このアドオンは、最も制限の少ないスコープのセットを使用します。 考えていますアドオンが使用するスコープは アドオン マニフェストをご覧ください。

詳しくは、スコープをご覧ください。

アドオンをテストする

未公開のアドオンをテストするには、まず 非公開 アドオン。 インストールして承認したら、アドオンを ホスト アプリケーションでの表示や動作のテストもできます。 あります。アドオンが次のように動作することを コンテキストとユーザー アクションに対して期待されます。

詳しくは、Google Workspace アドオンのテストをご覧ください。

アドオンを公開する

アドオンを公開すると、他のユーザーが利用できるようになり、 限定公開か、ドメイン内のユーザーのみにするかを選べます。公開を始める前に パブリケーションの概要を必ず確認してください。パブリケーションは、 完了するまでに時間がかかります。

Google Workspace アドオンは Google Workspace Marketplace で公開されています。一般公開 アドオンは、事前にアプリの審査を完了すること できます。

詳しくは、Google Workspace アドオンの公開をご覧ください。 詳しく見ていきます。