おすすめの方法

ユーザーのアドオンに関するガイドに沿って操作することで、全体的なエクスペリエンスが向上します。 考えています

一般的なベスト プラクティス

ご利用のすべてのアドオンについて、以下のベスト プラクティスを実践することをおすすめします。 開発します。

開始前にアドオンの所有権を決定する

アドオンは Apps Script プロジェクトによって定義され、特定の Google Cloud リソースが所有する 共有ドライブに配置されている。 アドオンをコーディングする前に、プロジェクトを所有するアカウントを決定し、 パブリッシャーとして動作する アカウントを指定できます実行するアカウントも決定する それらのアカウントがスクリプトにアクセスできることを 関連付けられている Cloud Platform プロジェクト。

Google Workspace を拡張し、複製しない

Chronicle アドオンは、インフラストラクチャに 拡張する Google Workspace アプリケーション、または 自動化できます。Google Cloud 内にすでにある機能を単に複製するだけの 大幅な改善が再現されないアプリケーションや ワークフローがアドオン審査に合格する可能性は あります。

スコープを狭める

スコープを明示的に定義する場合: 常に、最も制限の少ないスコープのセットを選択します。たとえば、 ユーザーのカレンダーへのフルアクセスを付与し、 読み取りのみが必要な場合は https://www.googleapis.com/auth/calendar 個のスコープ できます。読み取り専用アクセスの場合は、 https://www.googleapis.com/auth/calendar.readonly スコープ。

ライブラリに頼りすぎないようにする

Apps Script ライブラリを使用すると、 実行速度が遅くなるアドオンを すべての Apps Script コードが単一のスクリプト プロジェクトに含まれる場合です。 Apps Script ライブラリはアドオンで動作しますが、パフォーマンスの問題が発生する可能性があります。 削減できますモジュールに不要なライブラリを含めないでください。 アドオンへの依存を減らす方法を検討する必要があります。

上記のレイテンシは、使用している Apps Script プロジェクトにのみ適用されます。 サーバーサイド ライブラリとして格納できます。次のようなクライアントサイドの JavaScript ライブラリを使用できます。 jQuery を簡単に実行できます。

Google Workspace アドオンのベスト プラクティス

以下のベスト プラクティスは、 Google Workspace アドオンと カードサービスの機能です。

少数のカードのみを使用する

アドオンが使用するカードが多すぎる場合、ナビゲーション設定 複雑で管理が難しくなります

必要以上のカードを作成する衝動を避ける。

ウィジェット作成関数を使用する

Card を作成するコードを記述する場合 そのコードを独自の関数に配置することを検討してください。 この作成関数は、オブジェクトをビルドして返すだけです。これにより、 UI を更新する必要があるときはいつでも、そのオブジェクトをすばやく再生成できます。覚えておいてください でビルダークラスを使用した後に、build() を呼び出すように カードサービス。

カードをシンプルにする

1 つのカードに含まれるウィジェットが多すぎると、画面全体に表示されてしまい、 有用性が低下します大きなカードセクションは折りたたみ可能な UI 要素としてレンダリングされますが ユーザーに対しては情報が非表示になります。アドオンの合理化と ユーザーのニーズにぴったり合ったものに変えることができます。

エラーカードを使用する

エラー条件のカードを作成します。アドオンでエラーが発生した場合は、 エラー情報と修正方法が記載されたカードが表示される おすすめしますたとえば、Google 以外のネットワークにアドオンが サービスが停止した場合は、これが記載されたカードを表示し、 使用するアカウント情報をユーザーに確認します。

テストとテスト メッセージを作成する

作成したすべてのアドオンを入念にテストする必要があります。次の条件を満たすテスト関数を構築する テストデータを使用してカードやウィジェットを作成し、オブジェクトが 確認します。

アクション コールバック関数を使用する場合は、 通常はレスポンスオブジェクトを構築する必要があります。次のようなステートメントを使用できます。 レスポンスが正しく構成されていることを確認します。

    Logger.log(response.printJson());

作成したテスト関数を Apps Script から直接実行する [Run] メニューからエディタを実行します。実用的なアドオンができたら 非公開バージョンをインストールしてください。 テストします

アドオンが拡張する各ホスト アプリケーションに適したテストデータを使用します。対象 たとえば、アドオンで Gmail を拡張する場合、テストメールをいくつか およびそれらのメッセージ ID を付与することで、アドオンが 異なるメッセージ コンテンツを渡すと予期されます。あるメッセージのメッセージ ID は を使用してメッセージを一覧表示します。 Gmail API の Users.messages.list メソッドを使用するか、Apps Script の Gmail サービス。

カレンダーの会議に関するベスト プラクティス

アドオンでサードパーティの カレンダー会議 オプションを使用するには、次のベスト プラクティスに従ってください。

onCreateFunction のライトを点灯したままにする

各 onCreateFunction マニフェストで定義した関数が同期的に呼び出され、 この種の会議ソリューションを構築しますこれらの関数が 必要最小限の作業しか行いません。これらのケースでは アドオンのユーザー エクスペリエンスが低下することがあります。

会議データに適切な ConferenceData フィールドを使用する

コンテナ イメージを構築するときに、 ConferenceData その会議に関する詳細情報をそのオブジェクトに入力できます（ コード、電話番号、PIN、URI など）が含まれます。必ず対応する EntryPoint フィールド 確認してください。この情報は ConferenceData に配置しないでください 入力できます。

Google カレンダーの予定に会議の詳細を追加しない

作成されたサードパーティに関する情報をアドオンで追加する必要はありません Google カレンダーの予定の説明を追加します。Google カレンダーは 必要に応じて自動的に設定されます。