組織の Google アプリ
組織の Google アプリとは何か、そのアプリによって、メンバーの Gmail、Google カレンダー、Google ドライブの接続でできるようになること、そして組織にアプリがある場合にメンバーに表示される内容を説明します。
組織の Google アプリとは
Gmail、Google カレンダー、Google ドライブに接続するとき、ハルノは Google アプリ(ハルノ内蔵のもの、または組織独自のもの)を通じて Google に許可を求めます。組織独自のアプリがある場合は、メンバーの新しいサインインがそのアプリを通って行われ、Google の許可画面にもそのアプリの名前が表示されます。これによって変わるのは、チャットとスケジュールタスクでハルノにできることです。月次決算がこれらのサービスを読み取ることはありません。
- 組織が管理する Google Cloud プロジェクト内の、[デスクトップ アプリ]のクライアントです。組織に設定できるのは 1 つだけです。Mac アプリにも Windows アプリにも、この設定項目はありません。
- クライアント シークレットは、ハルノが暗号化して保管し、サインイン中のメンバーが使うハルノのアプリにだけ渡します。ハルノのどの画面にも表示されません。
- このアプリを登録しても、管理者や組織が誰かのメールボックス、カレンダー、Google ドライブにアクセスできるようになるわけではありません。メンバーはそれぞれ自分の Google アカウントでサインインし、そのサインインはメンバー自身のコンピュータに残ります。
- 既存の接続がこのアプリに移るのは、メンバーがそのコネクタに再度サインインしたときだけです。Windows では、メンバーが[マイドライブ]を選んだ場合にだけ、Google ドライブがこのアプリを使います。
財務チームが使う理由
ハルノに会社からのメールを探させ、そのエクスポートの添付ファイルを保存させたい場合や、ご自身の Google ドライブにすでにあるフォルダを使わせたい場合は、組織の Google アプリが必要です。メールの読み取りと、Drive 全体へのアクセスは、Google が制限している権限です。ハルノ内蔵のアプリはこれらを要求しませんが、組織が所有するアプリなら要求できます。
| ハルノにできること | 内蔵アプリ | 組織のアプリ |
|---|---|---|
| 添付ファイル付きメールの送信、Gmail ラベルの作成と名前変更 | はい | はい |
| メールの検索と読み取り、添付ファイルの保存、スレッド内での返信、メールのゴミ箱への移動 | いいえ | はい |
| Google ドライブへのアクセス | ハルノが作成するフォルダのみ | メンバー自身のマイドライブにあるフォルダ(メンバーが Drive へのフルアクセスを許可したままにしている場合) |
組織のアプリがあれば、メンバーはチャットでハルノに、会社から届いたメールを探してエクスポートの添付ファイルを保存するよう、たとえば次のように依頼できます。
Acme Corp から今週届いた、弥生会計のエクスポートが添付されたメールを探し、添付ファイルを保存して、保存先を教えてください。別のフォルダを指定しない限り、ハルノは添付ファイルを、チャットが作業しているフォルダ(別のフォルダを開いていない限り、ハルノ自身の Workspace フォルダ)の中の非表示フォルダに保存します。保存先のパスは、ハルノに尋ねてください。どちらの Google アプリも、会社の帳簿には何も追加しません。ファイルはご自身で追加してください。マッピングができるまでは「データを追加」を、その後は[帳簿]▸[エクスポートを読み込む…]を使います(「マッピングの下書き後にファイルを追加する」をご覧ください)。保存された添付ファイルの場所に移動するには、[会社のファイルをアップロード]ウィンドウで ⇧⌘G を押し、パスを貼り付けます。送信はどちらのアプリでも行えるため、会社にエクスポートをメールで依頼するだけなら、組織のアプリは不要です。
必要なもの
メンバーに必要なのは、組織内のハルノのアカウントだけです。そのアカウントでハルノにサインインし、いつもどおり Google のサービスを接続してください(「メンバーの接続方法」)。1 人が所属できる組織は 1 つだけです(「組織」)。
[内部]か[外部]か
メンバー全員が自社の Google Workspace のアカウントで接続する場合は[内部]を、それ以外の Google アカウントで接続する場合は[外部]を選びます。
| [対象](Audience) | 接続できるアカウント | メンバーに起こること |
|---|---|---|
| [内部] | 自社の Google Workspace のアカウントのみ | 毎週のサインインも、未確認アプリの警告もありません。 |
| [外部]、「テスト」中 | 追加したテストユーザーのみ | Google が、アプリを確認していないという警告を表示することがあります。サインインの有効期間は約 7 日間です。テストユーザーの一覧と、[データアクセス](Data Access)の権限は、お客様が管理します。 |
| [外部]、「テスト」を終えた後 | テストユーザー以外のアカウントも | 毎週のサインインはありませんが、Google がアプリを確認するまで、メンバーに未確認アプリの警告が表示されることがあります。機密性の高いスコープや制限付きスコープについては、Google が確認を求める場合があります。メールの読み取りと Drive へのフルアクセスは、制限付きスコープです。 |
Mac では、毎週のサインインの期限が切れる前に、ハルノが警告することはありません。次にハルノがそのコネクタを使うと、その行に「資格情報が拒否されました。再度サインインして再接続してください。」と表示され、チャットには、たとえば「Gmail は保存済みのサインインを拒否しました。コネクタで再接続してください。それまでツールは無効です。」という通知が出ます。新しいチャットには、最長 1 日間、またはメンバーが再度サインインするまで、そのコネクタが含まれません。Google の警告には「このアプリは Google で確認されていません」(Google hasn't verified this app)と表示されます。メンバーには組織のアプリの名前を伝え、この警告を越えて進むのは、そのアプリの場合だけにしてもらってください。
アプリを設定する
組織の Google アプリの登録、置き換え、削除は、現時点ではアカウントダッシュボードでは行えません。設定や変更を依頼するには、お問い合わせフォーム[相談する]からご連絡いただくか、info@inferara.com 宛にメールをお送りください。組織がすでに保存したアプリは、引き続き使えます。
メンバーの接続方法
メンバーが設定することは何もありません。いつもどおり接続すれば、Google の許可画面に組織のアプリの名前が表示されます。
Mac の場合
- 組織のアカウントでハルノにサインインします。
サイドバー下部のアカウント行を確認し、必要に応じてサインインしてください。ハルノからサインアウトしている間は、Google へのサインインがハルノ内蔵のアプリを通るため、メールを読み取れません。
- アカウント行をクリックし、[コネクタ…]を選びます。
アプリが変更されたときにこのウィンドウがすでに開いていた場合は、いったん閉じて開き直してください。
- Gmail または Google カレンダーの行で[サインイン]をクリックし、Google の画面ではすべての権限を選択したままにして、アクセスを許可します。
すると、行に「組織の Google アプリで接続しています」と表示されます。その下にある確認のスイッチは、初期状態でオンです(「コネクタの確認スイッチ」)。Google ドライブについては、「Google ドライブに接続する」をご覧ください。
組織のアプリができる前にメンバーが接続していた場合
接続はそのまま使えます。行には、たとえば「Gmail は現在も Haruno 内蔵の Google アプリで接続されています。組織の Google アプリに切り替えるには、再度サインインしてください。」と表示されます。行の ⋯ メニューで[再度サインイン]を選びます。Google ドライブの場合は[編集…]、[Google Drive に進む]、[保存]の順にクリックします。Drive へのフルアクセスに切り替えると、Drive のフォルダの選択が解除されます。[フォルダを選択…]でもう一度選んでください。
Windows の場合
Windows では、Google のコネクタ([設定]▸[コネクタ]、[連携]カード)は同じ組織のアプリを使います。メンバーがハルノにサインインしている間は、Gmail と Google カレンダーの新しい接続はすべてそのアプリを使います。Google ドライブでは、先にアクセス方法の選択を求められます。[Haruno 接続フォルダー]を選ぶと内蔵アプリを使い、ハルノがそこに作成したファイルにだけアクセスします。[マイドライブ]を選ぶと組織のアプリを使い、Drive へのフルアクセスで接続します。この場合は、アプリが保存されていて、メンバーがサインインしている必要があります。
| Windows でメンバーに表示される内容 | 対処 |
|---|---|
| 「Sign in to Haruno before connecting My Drive.」([マイドライブ]に接続する前に、ハルノにサインインしてください。) | ハルノにサインインしてから、接続します。 |
| 「My Drive requires a Google app configured by your organization. …」([マイドライブ]には、組織が設定した Google アプリが必要です。…) | アプリについて当社にご相談ください(「アプリを設定する」をご覧ください)。または、[Haruno 接続フォルダー]を選びます。 |
| 「Your organization's Google app could not be checked, so this sign-in was stopped. …」(組織の Google アプリを確認できなかったため、このサインインを中止しました。…) | ハルノが組織のアプリを取得できませんでした。もう一度お試しください。 |
| 「Update this integration before connecting it with your organization's Google app.」(組織の Google アプリで接続する前に、この連携を更新してください。) | コネクタを更新してから、接続します。 |
| 「These Gmail permissions require an organization Google app. …」(これらの Gmail の権限には、組織の Google アプリが必要です。…) | 組織のアプリが使われませんでした。アプリについて当社にご相談いただいてから、Gmail を再接続します。 |
| 「Choose either the Haruno connection folder or My Drive before connecting Google Drive.」(Google ドライブに接続する前に、[Haruno 接続フォルダー]か[マイドライブ]のどちらかを選んでください。) | [Google ドライブへのアクセス]欄でどちらかを選びます。 |
それぞれの権限でできること
メンバーは、Google の許可画面で項目のチェックを外せます。Gmail には送信の権限が、Google ドライブには少なくとも 1 つの Drive の権限が必要です。それ以外の項目のチェックを外した場合は、より少ない権限で接続されます。
| スコープ | 要求するアプリ | 許可される内容 |
|---|---|---|
| openid, userinfo.email | 組織のアプリ | どの Google アカウントが接続したかを確認できます。 |
| gmail.send(「Send email on your behalf」/「ユーザーに代わってメールを送信」) | 両方のアプリ | 添付ファイル付きのメールを送信します。必須です。 |
| gmail.labels | 内蔵アプリのみ | ラベルを作成し、名前を変更します(組織のアプリでは gmail.modify を使います)。 |
| gmail.modify | 組織のアプリ | メールの検索、読み取り、返信、添付ファイルの保存、ラベルの管理、メールのゴミ箱への移動ができます。 |
| calendar.events | 両方のアプリ | カレンダーを読み取り、予定を作成、変更、キャンセルします。 |
| drive.file | 内蔵アプリ、および Mac の組織のアプリ | ハルノが専用のフォルダに作成したファイルにだけアクセスできます。 |
| drive | 組織のアプリ | メンバー自身のマイドライブにアクセスできます。Mac では、メンバーが選んだフォルダだけです。 |
メンバーが権限のチェックを外した場合
Mac で次の項目を外した場合:
- 「Send email on your behalf」(ユーザーに代わってメールを送信):Gmail は接続されません。「Google did not grant permission to send email, so Gmail was not connected. …」(Google からメール送信の権限が付与されなかったため、Gmail は接続されませんでした。…)と表示されます。
- メールの読み取り(gmail.modify):Gmail は送信しかできず、行の説明文の末尾に「メールの読み取りには、組織が設定する Google アプリが必要です。」と表示されます。
- Drive の権限をすべて:Google ドライブは接続されません(「Google が Drive へのアクセスを許可しなかったため、接続は作成されませんでした。…」)。
- Drive のフルアクセスだけ:Drive では Haruno フォルダにしかアクセスできません。この状態に狭められた既存の接続には、「この接続からは、あなたの Google Drive 内の Haruno フォルダしか見えなくなりました。…」という警告が表示されます。
対処はいずれも同じです。再度サインインし、すべての権限を選択したままにしてください。
スケジュールタスクへの影響
Mac のスケジュールタスクでは、組織のアプリにより、ハルノは確認を求めずにメールを検索・読み取り、ゴミ箱に移動できます。Gmail はゴミ箱に移したメールを 30 日間保管し、それを過ぎると復元できません。メールと返信は、タスクが自動で送信してよい設定になっていない限り、これまでどおり[保留中]で待機します。メールの読み取り権限がある場合は、保留された各項目がメンバーの Gmail の下書きにも置かれます。「保留されるものと、すぐに実行されるもの」をご覧ください。
組織の Google アプリを置き換える・削除する
アプリの置き換えと削除も、現時点ではアカウントダッシュボードでは行えません。お問い合わせフォーム[相談する]からご連絡いただくか、info@inferara.com 宛にメールをお送りください。組織を解散した場合も、アプリは削除されます。組織のアプリがない場合、Gmail と Google カレンダーの新しいサインインは、ハルノ内蔵のアプリを使うため、Gmail はメールを読み取れません。Mac の新しい Google ドライブ接続は、Haruno フォルダにしかアクセスできません。Windows では、アプリをもう一度保存するまで、[マイドライブ]を接続できません。
メンバーの接続はどうなるか
Google 側では何も変更されません。Mac の接続は次のように動作します。Mac に変更が反映されるのは、ハルノの起動時、または[コネクタ]ウィンドウを開いたときです。メンバーがハルノからサインアウトしたり、ハルノを再起動したりする必要はありません。
| 変更 | Mac での動作 |
|---|---|
| 新しいシークレット、同じクライアント ID | 接続は引き続き使えます。 |
| 別のクライアント | 古いアプリを通した接続は使えなくなります。「Gmail は古い Google アプリで接続されていました。組織が現在使用している Google アプリに切り替えるには、再度サインインしてください。」と表示されます。 |
| アプリを削除した場合、または組織を解散した場合 | そのアプリを通した接続は使えなくなります。「Gmail は、現在は設定されていない Google アプリで接続されていました。Haruno 内蔵のアプリで接続し直すには、再度サインインしてください。内蔵アプリで許可される範囲は狭くなります。」と表示されます。 |
| メンバーがハルノからサインアウトした場合、組織を離れた場合、または削除された場合 | 組織のアプリを通した接続は、メンバーが組織内でハルノにサインインし直すまで使えなくなります。 |
| 上記のいずれの場合も、内蔵アプリの接続 | そのまま使えます。 |
メンバーに、再度サインインするよう依頼してください。行の ⋯ メニューで[再度サインイン]を選びます。Google ドライブの場合は[編集…]、[Google Drive に進む]、[保存]の順にクリックします。Drive の行には、「この接続は、現在は設定されていない Google アプリで作成されました。再度サインインして接続し直してください。」と表示されることがあります。アプリを削除した後は、Drive はハルノ専用のフォルダにだけ再接続され、使用するフォルダは選び直す必要があります。それまでは、新しいチャットでそのコネクタのツールはオフになります。
Windows では、Gmail と Google カレンダーの接続は、作成時に使ったアプリのままです。現在の組織のアプリを使うには、メンバーが接続し直します。
うまくいかないとき
サインインの問題の多くは Google Cloud プロジェクトが原因で、修正できるのは管理者だけです。
アカウントダッシュボードの場合
現時点では、アカウントダッシュボードに Google アプリのカードがないため、アプリに関するメッセージもそこには表示されません。保存済みのアプリに関することは、お問い合わせフォーム[相談する]からご連絡いただくか、info@inferara.com 宛にメールをお送りください。
メンバーの Mac の場合
| メンバーに表示される内容 | 意味と対処 |
|---|---|
| 「Google がサインインを完了しませんでした。ご自分でキャンセルしていない場合は、…」、または Google のページに表示される「Error 403: access_denied」 | メンバーがキャンセルしたか、そのアカウントがテストユーザーではありません。[テストユーザー]に追加してください。 |
| 「このサインインで使われた Google アプリを Google が受け付けなかったため、…」([保留中]から送信したとき)、または許可画面の代わりに表示される Google のエラーページ | クライアントが削除または無効化されたか、シークレットが一致しなくなっています。必要に応じてデスクトップ アプリのクライアントを新しく作成し、当社にアプリの置き換えを依頼してください。メンバーは再度サインインします。行に「ブラウザでサインインを完了してください…」と表示されたままの場合は、先に[キャンセル]をクリックします。 |
| チャット、保留された項目、または Google ドライブのシートに、API がプロジェクトで使われていない、または無効になっているという内容が表示されます。保留された項目は「Google に拒否されました(403)。」で、シートは「Request failed (403) …」(リクエストに失敗しました (403) …)で始まる文面になります。 | そのサービスの API を有効にしてください。新たにサインインし直す必要はありません。 |
| 「お使いの Google Workspace の管理者がこのアプリをブロックしているため、接続できません。…」 | そのアドレスを所有する Workspace(会社の Workspace である場合もあります)が、アプリを許可する必要があります。 |
| 「この Google アカウントは組織の Google Workspace に属していないため、…」 | 組織のアプリは[内部]です。職場のアカウントでサインインしてください。それ以外のアドレスには、[外部]のアプリが必要です。 |
| 「組織の Google アプリを今は読み取れなかったため、…」 | ハルノは、別のアプリを使ってサインインさせることはせず、そこで止まります。数分後にもう一度お試しください。 |
| 「この接続は現在使用できません。…キーチェーンのロックを解除して、もう一度お試しください。」 | Mac のログインキーチェーンのロックを解除してください。 |
| 「Google returned no refresh token. …」(Google がリフレッシュトークンを返しませんでした。…) | Google アカウントの設定で Haruno のアクセスを削除してから、再度サインインしてください。 |
保存済みのサインインが拒否された場合(「資格情報が拒否されました。再度サインインして再接続してください。」)やその他のコネクタの問題については、「トラブルシューティング▸コネクタ」をご覧ください。