Aby asistent mohl číst poštu v Google Workspace a zakládat v ní koncepty, potřebuje přístup přes Gmail API. K tomu si organizace něco založí ve svém Google Cloudu; draften nemá společnou aplikaci, které byste jen udělili souhlas. Platí to pro naši službu i pro instalaci na vlastním serveru.
Všechno tady platí jen pro účty Google Workspace s vlastní doménou. Osobním účtem @gmail.com se do draftenu přihlásit nejde; osobní Gmail ale připojíte přes IMAP s heslem aplikace — viz Podporovaní poskytovatelé a omezení.
Co chcete a co nastavit
| Co chcete | Co nastavit |
|---|---|
| Členové se přihlašují účtem Google a každý má vlastní schránku | klient organizace — to stačí |
| K tomu schránky, ke kterým se nikdo nepřihlašuje (třeba info@), nebo přístup ke schránkám nastavený centrálně, bez jejich vlastníků | navíc registrace organizace (servisní účet) |
| Přihlašování účtem Google nechcete | lidé se přihlašují heslem z pozvánky, poštu připojí registrace organizace (nebo IMAP) |
Dvě různé věci v Googlu
Klient organizace a registrace organizace jsou dvě samostatné věci v Google Cloudu. Každá dělá něco jiného a navzájem se nezastoupí:
| Klient organizace | Registrace organizace | |
|---|---|---|
| Co to je | OAuth klient s consent screen typu Internal | servisní účet s klíčem a domain-wide delegation |
| Co dělá | přihlašování členů tlačítkem Přihlásit přes Google a tlačítko Připojit Gmail u vlastní schránky | přístup asistenta ke schránkám bez přihlášení jejich vlastníků |
| Kde v draftenu | Organizace → Přihlašování a přístup k poště → karta Přihlášení účtem a připojení schránek | Organizace → Přihlašování a přístup k poště → karta Registrace pro sdílené schránky a centrální správu |
| Kdo ji v draftenu nastavuje | vlastník organizace | vlastník nebo správce organizace |
| Kdo ji zakládá v Googlu | správce Google Cloudu | správce Google Cloudu a superadministrátor Google Admin |
| Kdo se ke schránce přihlašuje | vlastník každé schránky, jednou | nikdo |
| Na které schránky dosáhne | jen na ty, které si lidé sami připojí | na všechny schránky domény |
Jsou to záměrně dvě věci. Souhlas s klientem dává práva jen ke schránkám, které si lidé sami připojí — nikdy k poště celé domény. Servisní účet naopak dosáhne na každou schránku domény, a proto ho dostává jen draften pro přístup ke schránkám, ne přihlašování. Nespojujte je.
Každá schránka používá jeden z obou přístupů; obojí můžete mít zároveň. draften žádá jen rozsah gmail.modify — čtení a zakládání konceptů, nic neodesílá.
Klient organizace: přihlášení a Připojit Gmail
Vlastník schránky se přihlásí svým účtem Google a povolí přístup jen ke své poště. Tentýž klient slouží i k přihlašování do draftenu účtem Google.
V Google Cloudu
Pracujete v https://console.cloud.google.com, přihlášení účtem správce vaší domény Workspace. Všechno se odehrává v jednom projektu — vybraný projekt je vidět nahoře vlevo vedle loga Google Cloud; tam ho i přepnete nebo založíte nový. Hlavní nabídku otevřete ikonou ☰ vlevo nahoře.
- V draftenu si nejdřív otevřete Organizace → Přihlašování a přístup k poště, kartu Přihlášení účtem a připojení schránek. Ukazuje dvě redirect URI přesně pro vaši adresu draftenu — končí na
/auth/google/callbacka/mailboxes/connect/google/callback. Zkopírujte je odtud; musí sedět znak po znaku. - Vyberte projekt, nebo založte nový (třeba
draften), a zapněte v něm Gmail API: ☰ → APIs & Services → Library, vyhledejte Gmail API, otevřete ji a klikněte na Enable. Přímo: https://console.cloud.google.com/apis/library/gmail.googleapis.com - Nastavte, jak se aplikace představí uživatelům (consent screen): ☰ → APIs & Services → OAuth consent screen. Otevře se stránka Google Auth Platform; přímo: https://console.cloud.google.com/auth/overview (zkontrolujte, že je nahoře vybraný správný projekt). Klikněte na Get started a projděte průvodce:
- App Information — App name
draftena User support email (váš e-mail nebo skupina správců). Next. - Audience — zvolte Internal. Přihlásit se pak může jen účet vaší domény Workspace a aplikaci nemusí ověřovat Google. Next.
- Contact Information — e-mail, na který vám Google pošle upozornění k aplikaci. Next.
- Finish — zaškrtněte políčko se souhlasem se zásadami Googlu (I agree to the Google API Services: User Data Policy), klikněte na Continue a pak na Create.
- App Information — App name
- Povolte aplikaci rozsahy. V Google Auth Platform v nabídce vlevo otevřete Data Access (přímo: https://console.cloud.google.com/auth/scopes) → Add or remove scopes. V seznamu zaškrtněte
openid,.../auth/userinfo.emaila.../auth/userinfo.profile. Rozsah pro Gmail vložte do pole Manually add scopes:https://www.googleapis.com/auth/gmail.modify→ Add to table. Klikněte na Update a dole na Save. - Vytvořte klienta. V Google Auth Platform v nabídce vlevo otevřete Clients (přímo: https://console.cloud.google.com/auth/clients) → Create client. Application type: Web application, název třeba
draften. U Authorized redirect URIs klikněte na Add URI a vložte první adresu z karty, pak znovu Add URI a druhou. Klikněte na Create. - Zobrazí se Client ID a Client secret — zkopírujte si hned obojí. Client secret Google později už znovu neukáže; kdybyste ho ztratili, vytvoříte u klienta nový.
V draftenu
- Vlastník organizace otevře Organizace → Přihlašování a přístup k poště, v kartě Přihlášení účtem a připojení schránek vyplní u Google OAuth klient hodnoty Client ID a Client secret z kroku 6 a klikne na Uložit.
- Přihlašování účtem Google zapne na téže stránce v kartě Přihlašování členů: do E-mailové domény organizace napíše svou doménu Workspace — primární, ne aliasovou (tu Google při přihlášení neposílá). Jakmile má organizace klienta i doménu, členové se přihlašují účtem Google a jejich hesla přestanou platit — viz Přihlašování členů.
- Vlastník schránky otevře stránku schránky a v kartě Přístup k poště v řádku Připojit účtem schránky: klikne na Připojit Gmail. Přihlásí se účtem té schránky — jiný účet draften odmítne — a povolí přístup. Tlačítko vidí jen vlastník schránky, a jen když organizace klienta má; bez něj karta místo tlačítka napíše, že připojení účtem půjde, až vlastník organizace klienta přidá.
- Pak Otestovat spojení.
Když se schránka odpojí
- Účet byl smazán nebo zablokován, nebo přístup odvolán — Google přestane vydávat tokeny a draften schránku odpojí. Připojte ji znovu (Znovu připojit Gmail), nebo registrací organizace (níže).
- „Poskytovatel nevydal obnovovací token“ — vlastník schránky odebere aplikaci v nastavení svého účtu Google (Zabezpečení → Aplikace třetích stran) a připojí schránku znovu.
- „Přihlásil se jiný účet, než je adresa schránky“ — při připojení vyberte účet právě té schránky.
Registrace organizace: přístup bez přihlášení
Servisní účet s domain-wide delegation dá asistentovi přístup ke schránkám domény, aniž by se kdokoli přihlašoval. Hodí se pro schránky, ke kterým se nikdo nepřihlašuje (třeba info@), a pro organizace, které chtějí přístup spravovat centrálně. S přihlašováním do draftenu nesouvisí.
V Google Cloudu
Pracujete v https://console.cloud.google.com, ve stejném projektu, kde je zapnuté Gmail API (krok 2 u klienta organizace; bez klienta ho zapněte stejně). Projekt zkontrolujte nahoře vlevo vedle loga Google Cloud.
- Otevřete seznam servisních účtů: ☰ → IAM & Admin → Service accounts. Přímo: https://console.cloud.google.com/iam-admin/serviceaccounts
- Nahoře klikněte na + Create service account a projděte tři kroky:
- Service account details — Service account name třeba
draften-posta(ID se doplní samo). Klikněte na Create and continue. - Permissions (optional) — nic nevybírejte; žádné role v projektu nepotřebuje, přístup k poště mu dá až delegace v Google Admin. Klikněte na Continue.
- Principals with access (optional) — nic nevyplňujte, klikněte na Done.
- Service account details — Service account name třeba
- V seznamu klikněte na nový servisní účet. Na záložce Details si zkopírujte Unique ID — dlouhé číslo; to je Client ID pro Google Admin.
- Záložka Keys → Add key → Create new key → Key type: JSON → Create. Prohlížeč stáhne soubor s klíčem (
….json).
Když Google vytvoření klíče odmítne, má vaše organizace zapnutou zásadu Disable service account key creation (iam.disableServiceAccountKeyCreation; nové organizace ji mají ve výchozím stavu). Správce organizace ji pro tento projekt vypne: ☰ → IAM & Admin → Organization policies (https://console.cloud.google.com/iam-admin/orgpolicies), vyhledá iam.disableServiceAccountKeyCreation → Manage policy → Override parent's policy → Enforcement: Off → Set policy. Pak krok 4 zopakujte.
V Google Admin
Potřebujete účet superadministrátora Google Workspace.
- Otevřete https://admin.google.com → v nabídce vlevo Security → Access and data control → API controls → dole Domain wide delegation → Manage domain wide delegation. Přímo: https://admin.google.com/ac/owl/domainwidedelegation
- Klikněte na Add new a vyplňte:
- Client ID — číselné Unique ID z kroku 3,
- OAuth scopes (comma-delimited) —
https://www.googleapis.com/auth/gmail.modify.
Klikněte na Authorize. Delegace se objeví v seznamu. Projeví se obvykle do pár minut, výjimečně až za několik hodin.
V draftenu
- Otevřete Organizace → Přihlašování a přístup k poště, kartu Registrace pro sdílené schránky a centrální správu. Registrace spravuje vlastník nebo správce organizace.
- Systém: Google Workspace. Vyplňte Název, u Klíč servisního účtu (JSON) vyberte stažený soubor a klikněte na Přidat registraci. Klíč se uloží zašifrovaný; v kartě je pak vidět jen e-mail servisního účtu a jeho Client ID.
- Na stránce každé schránky v kartě Přístup k poště vyberte u Registrace organizace tuto registraci, klikněte na Nastavit a pak na Otestovat spojení. Postup se snímky ukazuje návod Přidání a připojení schránky.
Stažený soubor s klíčem pak smažte. Kdo ho má, dostane se do každé schránky domény. Nový klíč téhož servisního účtu (krok 4 výše) nahrajete u registrace volbou nový klíč (JSON); klíč jiného servisního účtu přidejte jako novou registraci. Starý klíč pak v Google Cloudu smažte: servisní účet → záložka Keys → ikona koše u starého klíče.
Se zapnutou automatickou schránkou (Přihlašování členů) se nová schránka na registraci naváže sama, když je pro Google Workspace právě jedna aktivní.
Chyby testu spojení
Test ověří tři kroky: Přístup, Token a oprávnění a Čtení Inboxu.
| V hlášce | Co to znamená | Co udělat |
|---|---|---|
delegace pro rozsah není povolená (unauthorized_client) | v Google Admin chybí domain-wide delegation, nebo má jiné Client ID či rozsah | zkontrolovat delegaci v Google Admin: číselné ID a přesný rozsah gmail.modify |
invalid_grant u servisního účtu | taková schránka v doméně Workspace není | zkontrolovat adresu schránky |
| „Gmail API has not been used…“ | v projektu není zapnuté Gmail API | zapnout Gmail API |
token bez gmail.modify | delegace nebo consent screen nemá rozsah gmail.modify | doplnit rozsah |
invalid_grant, deleted_client u připojeného účtu | připojení bylo odvoláno nebo klient smazán | Znovu připojit Gmail |
Další chyby popisuje Řešení potíží.