Gmail やカレンダーを拡張するアドオンをすでに作成、公開している場合は、 Google Workspace のアドオンにアップグレードできますこのページで説明する手順では、 Google Workspace の機能を既存の Gmail またはカレンダーのアドオンに追加して、 アップグレードしたアドオンを公開し、検出してインストールできるようにします。
新しい機能を元の Google Workspace Marketplace のリスティング、インストール、ユーザーを維持できます。 アップグレードすると、Google Workspace の新しいアドオン機能も利用できるようになります たとえばホームページなどです。
ステップ 1: アドオンの Apps Script プロジェクトのコピーを作成する
アップグレードされたアドオンは、公開済みと同じ Google Cloud プロジェクトを使用します ただし、基盤となるアプリのコピーを作成して使用し、 テスト中に既存のユーザーが影響を受けないようにプロジェクトを作成する アップグレードされます。元のスクリプト プロジェクトのコピーのアップグレードも つまり元のコードにいつでもアクセスでき できます。
- 既存の Gmail アドオンまたはカレンダー会議アドオンの Apps Script を開きます。 できます。
- 左側の [概要] をクリックします。 。
- 右側の「コピーを作成」アイコン をクリックします。
- 左側にある [プロジェクト設定] >プロジェクトを変更します。
- [GCP プロジェクト番号] をクリックします。
- 同じ プロジェクト番号 既存の公開済みアドオン Apps Script プロジェクトに関連付けられている。
- [プロジェクトを設定] をクリックします。
ステップ 2: Google Workspace アドオンを統合する
ご希望の Google Workspace アドオン機能を設計して実装する必要があります。 追加します。
- アドオンに表示するコンテンツを計画する ホームページカードについて Gmail、カレンダー、ドライブ、またはこれら 3 つの任意の組み合わせに表示すべきです。 ホストします。ホームページを複数のホストに表示するには、 同じホームページにすることも、ホストごとにカスタム ホームページ カードを使用することもできます。
- コピーしたアドオン Apps Script プロジェクトで、ホームページを作成します。
homepageTriggerが記載されたカード 使用できます。アプリケーションに必要なサポート関数やロジックがあれば、 新しいホームページのインターフェースを制御します。 ページを開くなど、ユーザーの操作によってトリガーされるコンテキスト カードを追加することも Gmail のメッセージ スレッド カレンダーの予定。
イベント オブジェクトへのすべてのアクセス権を更新する （ウィジェットのコールバック関数またはコンテキスト トリガーで） 使用し、更新された イベント オブジェクト構造。 新しい構造体には、以前と同じイベント オブジェクト フィールドが Gmail とカレンダーの会議アドオンを使用していましたが、元のフィールドは 非推奨となり、最終的に削除されます。
ステップ 3: アドオンのマニフェストを更新する
Cloud Storage 内に設定情報が保存される方法は、
マニフェストの構造
Google Workspace アドオンは、Gmail アドオンの構造から大幅に変更
カレンダー会議アドオンで使用したりできますアドオンをアップグレードする際には、アドオンの Apps Script プロジェクトのマニフェスト フィールドを次のように更新する必要があります。
以下の表をご覧ください関連するすべてのサブプロパティを
addOns プロパティ。
マニフェストのモジュールも必ず更新し、
oauthScopes フィールド
必要な権限を反映させる必要があります。
Google Workspace アドオン マニフェストについて詳しくは、 マニフェストをご覧ください。
Gmail アドオン
| 元のマニフェスト フィールド | 必要な対応 |
|---|---|
gmail.composeTrigger |
addOns.gmail.composeTrigger に移動します。 |
gmail.contextualTriggers[] |
リストを addOns.gmail.contextualTriggers[] に移動します。 |
gmail.logoUrl |
addOns.common.logoUrl に移動します。 |
gmail.name |
addOns.common.name に移動します。 |
gmail.openLinkUrlPrefixes[] |
リストを addOns.common.openLinkUrlPrefixes[] に移動します。
|
gmail.primaryColor |
addOns.common.layoutProperties.primaryColor に移動します。 |
gmail.secondaryColor |
addOns.common.layoutProperties.secondaryColor に移動します。
|
gmail.universalActions[] |
リストを addOns.common.universalActions[] に移動します。 |
gmail.universalActions[].text |
各 gmail.universalActions[].text フィールドを
対応する addOns.common.universalActions[].label
表示されます。 |
gmail.useLocalFromApp |
addOns.common.useLocaleFromApp に移動します。 |
カレンダー会議アドオン
| 元のマニフェスト フィールド | 必要な対応 |
|---|---|
calendar.createSettingsUrlFunction |
addOns.calendar.createSettingsUrlFunction に移動します。 |
calendar.conferenceSolution[] |
addOns.calendar.conferenceSolution[] に移動します。 |
calendar.logoUrl |
addOns.common.logoUrl に移動します。 |
calendar.name |
addOns.common.name に移動します。 |
ステップ 4: アップグレードしたアドオンをテストする
アップグレードしたアドオンを公開前にテストするには: Google Workspace アドオンのテストをご覧ください。
ステップ 5: アップグレードしたアドオンの審査をリクエストする
アップグレードされたアドオンか、ゼロから構築されたアドオンかにかかわらず、すべての Google Workspace アドオン、 Google Workspace Marketplace に掲載するには、事前に承認を受ける必要があります。
アドオンを送信して審査を受ける手順は次のとおりです。
アドオンが次の要件をすべて満たしていることを確認してください アドオンの公開要件をご覧ください。
バージョニングされた Deployment を作成する （新しい Apps Script プロジェクトにある）アドオンにインストールするために使用できる 選択しますhead を使用して公開しない 説明します。
アドオンのアップグレード中に新しいスコープを追加した場合、 OAuth 検証をリクエストします。 たとえば、Gmail アドオンで新しいドライブやカレンダーのスコープを それらの新しいスコープを提出して検証する必要があります。 適格性確認が完了するまでに数日かかることがあるため、 早期に行うことです続行する前にアドオンの確認を完了してください 手順 6 に進みます。
ステップ 6: アップグレードしたアドオンを利用できるようにする
Google Workspace Marketplace SDK を開きます。
左側の [設定] をクリックします。このパネルには アドオンに関する情報を入力します
広告の簡単な説明、詳細な説明、スクリーンショットを Google Workspace アドオンの新機能を反映しました。
[Extensions] で [Upgrade to Google Workspace アドオンのボタン。 表示されるテキスト ボックスに、新しいデプロイ ID を入力します。 Google Workspace アドオンをインストールします。デプロイ ID が有効な場合は、 サポートされているホストのリストが表示されます。
Google Workspace アドオンに新しいスコープを追加した場合は、 [Configuration] ページの [OAuth 2.0 scope] セクション。リストされているスコープは スコープと完全に一致する必要があります。 使用します。
フォームに入力した情報が正しいことを確認します。次に、 [変更を保存] をクリックします。
この Google Workspace アドオンのアップグレード中にご不明な点や問題が発生した場合 Google までお問い合わせください。
よくある質問
アドオンのアップグレードに関するよくある質問は次のとおりです。
エディタ アドオンをアップグレードできますか？
ほとんどのエディタ アドオンは Google Workspace アドオンに移行できます。ただし、 Gmail や Google Workspace のアドオンと同じように簡単に Google カレンダー。
エディタ アドオンを Google Workspace アドオンに移行する場合は、以下を行う必要があります。 アドオンの UI を HTML からカードベースの UI に書き換える インターフェースを確認し、JavaScript の カードサービスへの処理。
既存のエディタ アドオンのサービスの一部は、 カードサービス。たとえば、エディタのアドオンにファイル選択ツールが含まれている場合、 カードサービスの Google Workspace アドオンに相当する機能ではありません。
Google Workspace アドオンを別途構築して、既存のアドオンを維持することはできますか？
別のブランド名で追加の Google Workspace アドオンを構築することも、 個別の Gmail またはカレンダーの会議アドオンを Google Workspace アドオンと同じブランド名で使用してください。ご質問がある場合や 例外については、Google までお問い合わせください。
ユーザーはアップグレード後にアドオンを再承認する必要がありますか？
Google Workspace アドオンで基盤となる Cloud Platform（GCP）プロジェクト クライアント ID が関連付けられた場合、ユーザーは認証を再承認する必要がありません。 許可する権限を制限できます。ただし、 アップグレード プロセス中に新しいスコープを追加した場合、そのスコープをユーザーが承認する必要があります。 新しいスコープを設定できます。 確認できます。
Chrome 拡張機能を Google Workspace アドオンにアップグレードしてユーザーを移行できますか？
いいえ。Chrome 拡張機能のユーザー、インストール数、掲載情報を移行することはできません 評価します。新しい Google Workspace アドオンを作成し、Chrome のユーザーを直接誘導する必要があります Google Workspace Marketplace に アクセスすることにしました
Google Workspace アドオンに複数のアドオンをバンドルすることはできますか？
アプリの統合をまとめて一覧表示するをご覧ください。