Gmail podpisi prek Gmail API: nastavitev po korakih

Kaj potrebujem, da nastavim Gmail podpis vsem uporabnikom?

• Račun super skrbnika v Google Workspace.
• Dostop do Google Cloud konzole z istim računom (brezplačno; plačilna kartica ni potrebna).
• Približno 30 minut.

Tako delujejo vsa orodja za upravljanje podpisov v Google Workspace, tudi SignetMail. Enake korake potrebujete, če pišete lastno skripto.

1. Projekt in API-ji

1. V console.cloud.google.com se prijavite kot super skrbnik in ustvarite nov projekt. Preverite, da je pod vašo organizacijo (ne »No organization«).
2. APIs & Services → Library: omogočite Gmail API in Admin SDK API.

2. Servisni račun in ključ

1. IAM & Admin → Service accounts → Create service account. Vloge projekta ne potrebuje.
2. Na zavihku Keys: Add key → Create new key → JSON. Datoteko shranite varno — kdor jo ima, lahko deluje v imenu servisnega računa.
3. Na zavihku Details si zapišite Unique ID (številka); potrebovali jo boste v koraku 3.

Napaka »Service account key creation is disabled«

Google za organizacije, ustvarjene v zadnjih letih, privzeto vklopi varnostno politiko iam.managed.disableServiceAccountKeyCreation (secure by default). Ključ odklenete samo za ta projekt:

1. IAM & Admin → Manage resources: označite organizacijo in v plošči Permissions sebi dodajte vlogo Organization Policy Administrator. Super skrbnik je v Workspace nima samodejno.
2. Izberite projekt in odprite IAM & Admin → Organization policies.
3. Odprite Disable service account key creation → Manage policy → Override parent's policy → Add rule → Enforcement: Off → Set policy.
4. Počakajte minuto in ponovno ustvarite ključ.

Politika ostane vklopljena za vse druge projekte v organizaciji.

3. Domain-wide delegation

V admin.google.com → Security → Access and data control → API controls → Manage domain-wide delegation → Add new vpišite Unique ID iz koraka 2 in obsege:

https://www.googleapis.com/auth/gmail.settings.basic
https://www.googleapis.com/auth/admin.directory.user.readonly
https://www.googleapis.com/auth/admin.directory.group.readonly
https://www.googleapis.com/auth/admin.directory.group.member.readonly

Prvi obseg dovoli spreminjanje nastavitev Gmaila (tudi podpisa), ne pa branja pošte. Ostali trije so samo za branje imenika — iz njega pridejo ime, naziv, oddelek in telefon. Sprememba običajno velja v nekaj minutah, lahko pa do 24 ur.

4. Nastavitev podpisa

Aplikacija s ključem pridobi žeton v imenu uporabnika (subject = njegov e-naslov) in pokliče:

PATCH https://gmail.googleapis.com/gmail/v1/users/{e-naslov}/settings/sendAs/{e-naslov}
{ "signature": "<table>…</table>" }

To ponovi za vsakega uporabnika. Gmail sprejme do 10.000 znakov HTML, odstrani bloke <style> in podpis prikaže v nekaj minutah.

5. Prijava skrbnikov (neobvezno)

Če ima orodje spletni portal s prijavo Google, potrebuje še OAuth odjemalca: APIs & Services → OAuth consent screen (tip Internal), nato Credentials → Create OAuth client ID → Web application z naslovom portala pod Authorized JavaScript origins.

Pogoste napake

Pogosta vprašanja

Ali lahko nastavim tudi, da je podpis nad citatom in brez »--«?

Ne centralno. To je osebna nastavitev v Gmailu (Nastavitve → Splošno → Privzeti podpisi), ki je Gmail API ne ponuja. Uporabnikom pošljite kratko navodilo.

Ali potrebujem skripto?

Za enkratno nastavitev zadošča skripta. Če se podatki spreminjajo (novi zaposleni, nazivi, kampanje), je orodje, ki podpise samodejno posodablja, manj dela. SignetMail uporablja točno te korake; navodila so v dokumentaciji.

Kje so razlike med podpisom in nogo v Admin konzoli?

Glejte vodič Noga sporočila v Google Workspace.