このページは機械翻訳です。原文は英語版で、内容に相違がある場合は英語版が優先されます。

管理者ガイド: Ascripto と Google Workspace

最終確認日: 2026年11月9日

何かを許可するよう依頼された Google Workspace の管理者または特権管理者と、Ascripto が何にアクセスするのかを評価する方のためのガイドです。まず仕組みを、Google 自身の用語で説明します。

Ascripto が求める権限と、その付与者

権限付与者場所許可される内容
ログインAscripto を使う各ユーザーGoogle のログインopenid、email、profile。ID は、Google アカウントの不変の識別子 (subject) とホスト ドメインに基づき、メール アドレスには基づきません
ディレクトリ (読み取り専用)Google Workspace の管理者Ascripto から進む OAuth の同意 (「Ascripto へようこそ」ページまたは [設定] > [接続])admin.directory.user.readonly と admin.directory.domain.readonly: ユーザーとその氏名、役職、部署、電話番号、組織部門、カスタム属性、および組織の確認済みのドメイン。グループは読み取られません
署名特権管理者管理コンソール > [セキュリティ] > [アクセスとデータ管理] > [API の制御] > [ドメイン全体の委任を管理]Ascripto のサービス アカウントに対する www.googleapis.com/auth/gmail.settings.basic。クライアント ID はページに表示されます。users.settings.sendAs にのみ使用します

Ascripto がメールを読み取ったり、送信したり、削除したりすることはありません。Google のデータの使用は、Google API サービスのユーザーデータに関するポリシー (Google API Services User Data Policy) と、その使用制限 (Limited Use) の要件に従います。この表明は、ascripto.com/ja/privacy/ のプライバシー ポリシーにあります。

Marketplace からのインストールではなくドメイン全体の委任を使う理由

理由は 2 つあり、どちらも Marketplace に掲載された後も変わりません:

  1. 呼び出し元以外のメールボックスのエイリアス (send-as) の署名を読み書きできるのは、ドメイン全体の権限を持つサービス アカウントのクライアントだけです。ユーザーごとの同意ではできません。
  2. Google には gmail.settings.basic の読み取り専用版がありません。監査は読み取るだけですが、この権限では必然的に書き込みも許可されます。

Google は 2026年10月17日に Ascripto の OAuth アプリ (ブランディングと機密性の高いスコープ) を確認したため、ディレクトリの権限の同意画面に “未確認のアプリ” の警告は表示されません。署名用の委任のエントリは、引き続き管理コンソールで手作業で作成します。スコープは上の表のとおりです。

頻度と仕組み

処理頻度仕組み
ディレクトリの変更発生のたび: Google が変更ごとに Ascripto に通知し、そのユーザーをその時点、1 分後、5 分後に読み取りますAdmin SDK Directory API の users.watch。変更の種類 (追加、変更、削除、復元) ごとに 1 つのチャネルを使い、2 日ごとに更新し、channels.stop で停止します。ユーザーの読み取りは users.get
ディレクトリの読み取り1 時間ごと。通知チャネルが欠けている間は 15 分ごと。[今すぐ読み取る] の操作時にもAdmin SDK Directory API の users.list、domains.list
監査1 日 1 回と、[再確認] の操作時ユーザーごとに sendAs.list。メインのアドレスの署名をディレクトリの登録内容と比較します
配布確認を経た配布の実行時。その後は、入社した人と変更された登録内容に対して自動的にユーザーごとに sendAs.patch、1 秒あたり約 20 件の書き込み。[最新の署名も書き換える] がオンでない限り、各メールボックスは最初に読み取られ、異なる場合にのみ書き込まれます
インポート要求時選択したユーザーに sendAs.get。値をそのユーザーのディレクトリの登録内容と照合します

sendAs.update ではなく sendAs.patch を使うため、配布によってユーザーの表示名、返信先、エイリアスのフラグが消去されることはありません。書き込まれるのは新規メールの署名だけです。Gmail API には返信・転送用の選択を表すフィールドがないため、署名の返信用のバージョンは Gmail には配布されません。

監査で比較する内容

ユーザーごとに、Gmail が新規メールに使う署名をディレクトリの登録内容と比較します。指摘事項は次のとおりです:

指摘事項判定条件
署名なし署名が空である
氏名なしユーザーの氏名が本文にない
役職なしディレクトリの役職が本文にない
勤務先電話番号なしディレクトリの勤務先電話番号が本文にない
ロゴなし署名にロゴ画像がない
読み取り不可Google がメールボックスへのアクセスを拒否した。別に集計され、準拠にも非準拠にも含まれません

確認の対象外で、数値の横にもその旨が表示されるもの: ユーザーが返信・転送用に選択できる別の署名 (Gmail は Web の設定に保持し、どれが使われているかを公開する API はありません)、Gmail アプリ内で設定された [モバイル署名] (デバイス内にのみ存在し、どの API からも見えません)、フォント、サイズ、色、そして配布した内容にユーザーが追加したもの。

配布で書き込む内容

そのユーザー向けにレンダリングした HTML と、それに対応するテキスト形式です。Gmail の署名は HTML 文字列で、画像を埋め込めないため、画像は img.ascripto.com の下の、ワークスペース専用の名前でホストされます。Gmail は Web と Gmail アプリでこの署名を適用します。配布では、ディレクトリで停止中のユーザー、アドレスが組織のドメイン外のユーザー、どの署名の対象にもならないユーザーをスキップします。

退職者

ディレクトリから削除されたユーザーは Ascripto のごみ箱に移動し (既定では 7 日間、[設定] > [接続] で 1 年まで設定可能)、管理の対象から外れます。Ascripto がそのメールボックスに書き込むことは二度となく、すでにある署名を消去することもありません。停止中のユーザーには、停止中は書き込みません。

署名の二重表示

管理コンソールでフッターを追加 (Append footer) が有効になっている場合 ([アプリ] > [Google Workspace] > [Gmail] > [コンプライアンス])、Google はすべてのユーザー自身の署名の下にフッターを追加します。Ascripto が書き込む署名も例外ではありません。法的な文言を Ascripto の署名に入れたら、フッターが設定されているすべての組織部門でフッターをオフにしてください。

障害時の動作と、製品での表示

発生した事象Ascripto の表示対処
委任のエントリがない、または削除された“Google がメールボックスを開くことを拒否しました。Google 管理コンソールで署名へのアクセスが取り消された可能性があります。” 監査または配布は停止し、集計はそこまでの分が残りますクライアント ID とスコープを再度追加します。トークン エンドポイントで検出される (unauthorized_client) ため、その間にメールボックスへのアクセスは発生しません
ディレクトリの同意が取り消された、または同意した管理者がロールを失った[設定] > [接続]: “接続が取り消されました。ディレクトリを再度読み取るには、再接続してください。”現在の管理者として [再接続] します
Google 側で新しい委任の反映に時間がかかる“まだ許可されていません” と表示され、20 秒ごとに再確認します待ちます。Google のドキュメントでは最長 24 時間ですが、通常は数分です
確認または読み取りが Ascripto 側で失敗したその旨が表示され、再試行されます不要

Ascripto の権限の取り消し

  1. 署名: 管理コンソール > [セキュリティ] > [アクセスとデータ管理] > [API の制御] > [ドメイン全体の委任を管理] > Ascripto のクライアント > [削除する]。監査と配布はただちに停止します。
  2. ディレクトリ: 同意した管理者が、自分の Google アカウント > [リンク済みアプリ] (myaccount.google.com/linkedapps) で Ascripto を削除します (または、Google が次の読み取りを拒否した時点で、[設定] > [接続] の接続が取り消し済みと表示されます)。
  3. すでに書き込まれた署名はユーザーの Gmail に残ります。Ascripto が消去することはありません。

データの取り扱い

課金対象のユーザー

Google Workspace での課金対象のユーザーとは、その月のいずれかの時点で、Gmail に現在の署名が入っていたユーザーです。配布で書き込まれた場合と、配布または監査でまだ入っていることが確認された場合が該当します。その月を通して停止中または削除済みだったユーザーは数えません。その月のこれまでの人数は [設定] > [お支払い] にあります。

出典