新しい Google Workspace アドオンを構築する場合は、 手順は次のとおりです。
- アドオンのプロジェクトを設定してオーナーを選択する 共同で作業できます
- アドオンの外観と動作を設計する。
- アドオンのプロジェクト マニフェストまたはデプロイ リソースを構成します。
- アドオンの外観を定義するコードを記述し、 確認します。
- アドオンの OAuth スコープを確認します。
- ホスト アプリケーション あります。
- アドオンを公開します。
アドオンのプロジェクトを設定し、オーナーと共同編集者を選択する
Apps Script でアドオンを構築する場合は、 Apps Script プロジェクトと Google Cloud プロジェクトの両方を作成します。 Google 以外の言語でアドオンを構築する場合、 Apps Script では、Google Cloud プロジェクトを作成するだけで済みます。
アドオンの開発を始める前に、1 つの プロジェクトを所有し、他のどのアカウントを所有するかを決定できます。 できます。プロジェクトのオーナーは、プロジェクト ファイルと関連する設定を作成して管理します。共同編集者は、コーディングとテストをサポートできます。
Apps Script プロジェクト
アドオンの Apps Script プロジェクト ファイルを共有ドライブにビルドすると、単一のアカウントが単独で所有することはありません。アドオン スクリプト ファイルを共有ドライブに配置すると、複数の共同編集者がスクリプト プロジェクトにアクセスできます。
アドオンを公開すると、1 つのユーザー アカウントが （パブリッシャーとして）公開アカウントにはスクリプト プロジェクトに対する編集アクセス権が必要ですが、オーナーである必要はありません。
Apps Script プロジェクトを作成するには、スクリプト プロジェクトをご覧ください。
Google Cloud プロジェクト
アドオンの Cloud プロジェクトに共同編集者を追加することをおすすめします。これにより、チーム内の誰かがアドオンの Cloud 設定に常にアクセスできるようになります。
Google Cloud プロジェクトを作成するには、Google Cloud プロジェクトを作成するをご覧ください。
アドオンの外観と動作を設計する
アドオンの作成を開始する前に、アドオンの外観と動作を決定します。アドオンで解決しようとするユースケースを検討します。開始 シンプルなデザインで作業を開始してから 改良を加えていきます
アドオンのユーザー エクスペリエンスを設計する方法については、Google Workspace アドオン スタイルガイドをご覧ください。
アドオン プロジェクト マニフェストを構成する
Apps Script プロジェクトでは、プロジェクト マニフェストは特別な JSON ファイルです。ライブラリなど、プロジェクトに関するさまざまな詳細を指定します。 確認します。Google Workspace アドオンの場合、マニフェストには基本的な ホスト アプリケーションで表示に必要な情報が 確認します。
構成方法の詳細については、マニフェストをご覧ください。 Apps Script でアドオンのマニフェストを指定します。
アドオンにコードや機能を追加する際は、 必要なアドオンを生成するために、必要に応じてマニフェストを 確認します。
アドオンのコーディング
API 呼び出しにはカードベースのインターフェースを実装する必要があります。 できます。Apps Script の カードサービスの場合、または別のコード言語で記述している場合は、 インターフェースがカードとしてレンダリングされるようにします。
また、トリガー 関数を指定します。 追加します。アドオンが OAuth を使用して Google 以外のサードパーティ サービスに接続する場合は、そのサービス用に OAuth を構成する必要があります。
カードを作成する
アドオンのユーザー インターフェースを定義するには、Card オブジェクトを作成し、ウィジェットで埋めます。トリガー関数
マニフェストでは、terraform plan または terraform apply の
Card オブジェクトまたは
以下を表す Card オブジェクト
さまざまな「ページ」クリックします。アドオンは、ユーザーの操作に応じて新しいカードを作成して表示することもできます。
Apps Script では、CardBuilder クラスを使用してカードを作成します。各
カードには CardHeader が必要
および 1 つ以上
CardSections。各カード セクションには、アドオン インターフェースを構成する個々のウィジェットを配置する必要があります。通常、インタラクション ウィジェットはアクションにリンクされ、インタラクションの動作が定義されます。
すべてのセクションとウィジェットを
CardBuilder は、
CardBuilder.build()
対応する Card オブジェクトを作成します。
他の組み込みの Apps Script を使用して、
などのサービス
取得するには CalendarApp
作成したアドオンカードに表示する情報です。
Google 以外のサービスから取得したデータを使用できます。
Google 以外の API にアドオンがアクセスする必要がある場合、 そのサービスを構成して接続する必要があります。詳しくは、 Google 以外のサービスへの接続ガイド をご覧ください。
建設注文
カードを作成する際は、チャージから作成する必要があります。つまり、次の順序で作成する必要があります。
- ウィジェットを作成します。
- カード セクションにウィジェットを追加します。
- カード セクションにすべてのウィジェットが表示されるまで、この手順を繰り返します。
- カードにカード セクションを追加します。
カードまたはカード セクションにウィジェットを追加すると、 実際にはそのウィジェットのコピーを追加しています。ウィジェットに変更を加えた場合 追加した後にそのオブジェクトは、最後のカードには反映されません。
ユニバーサル アクション
ユニバーサル アクションを使用できます コンテキストに依存しない機能を提供します。ユニバーサル アクションは、表示されているカードに関係なく、アドオン UI で使用できるメニュー項目です。定義済みのユニバーサル アクションはすべて、常に カードメニューを開きます
詳しくは、ユニバーサル アクションをご覧ください。 表示されます。
アドオンの OAuth スコープを確認する
スコープは、プロジェクトが実行するアクションを 委任が許可されています。アドオンには、機能するために必要なアクションのスコープのみを設定することをおすすめします。
アドオン プロジェクトでは、 アドオン セキュリティ スコープを このアドオンは、最も制限の少ないスコープのセットを使用します。 考えていますアドオンが使用するスコープを アドオン マニフェストをご覧ください。
詳しくは、スコープをご覧ください。
アドオンをテストする
公開前のアドオンをテストするには、まず公開前のアドオンをインストールします。インストールして承認すると、アカウントでアドオンを使用でき、拡張するホスト アプリケーションでその外観と動作をテストできます。コンテキストとユーザー アクションに対して、アドオンが想定どおりに動作することを確認する必要があります。
詳しくは、Google Workspace アドオンのテストをご覧ください。
アドオンを公開する
アドオンを公開すると、一般公開またはドメイン内のユーザーに公開できます。公開を始める前に パブリケーションの概要を必ず確認してください。公開は複雑なプロセスであり、準備と時間が必要です。
Google Workspace アドオンは Google Workspace Marketplace で公開されています。一般公開されるアドオンは、公開前にアプリの審査を完了する必要があります。
詳しくは、Google Workspace アドオンの公開をご覧ください。 詳しく見ていきます