Sdílet prostřednictvím

Gmail

Gmail je webová e-mailová služba od Googlu. Pomocí konektoru Gmail můžete provádět akce, jako je odesílání nebo příjem e-mailových zpráv, a aktivovat toky na nových e-mailech.

Tento konektor je dostupný v následujících produktech a oblastech:

Service Class Regions
Copilot Studio Standard Všechny oblasti Power Automate s výjimkou následujících:
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Logic Apps Standard Všechny oblasti Logic Apps s výjimkou následujících:
     – Oblasti Azure China
     - Ministerstvo obrany USA (DoD)
Power Apps Standard Všechny oblasti Power Apps s výjimkou následujících:
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Power Automate Standard Všechny oblasti Power Automate s výjimkou následujících:
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Kontakt
Název Microsoft
URL Podpora Microsoft LogicApps
Podpora microsoft Power Automate
Podpora Microsoft Power Apps
Metadata konektoru
Vydavatel Microsoft
Internetová stránka https://mail.google.com/mail/
Zásady ochrany osobních údajů https://policies.google.com/privacy

Ověřování a používání vlastní aplikace

Konektor Gmail teď podporuje více typů ověřování:

  • Použít výchozí sdílenou aplikaci
  • Používání vlastní aplikace

Výchozí sdílená aplikace používá klientskou aplikaci Google, kterou spravuje Microsoft. V takovém případě se při přihlášení k účtu Gmail zobrazí výzva k vyjádření souhlasu s aplikací Microsoft Power Platform .

Pomocí možnosti Přineste si vlastní aplikaci můžete místo aplikace spravované Microsoftem použít vlastní klientskou aplikaci Google OAuth. Tím umožníte řídit oprávnění a povolit určitá omezení používání konektoru.

Pokud chcete používat vlastní klientskou aplikaci Google OAuth s konektorem Gmail, musíte provést následující kroky:

  1. Vytvoření klientské aplikace OAuth pomocí konzoly ROZHRANÍ API Googlu
  2. Použití aplikace v konektoru Gmail

Vytvoření klientské aplikace OAuth v Googlu

Pokud chcete vytvořit vlastní klientskou aplikaci Google OAuth, musíte se nejprve přihlásit .https://developer.google.com Přejděte do konzoly ROZHRANÍ API Google – kde můžete spravovat přístup k rozhraním GOOGLE API – a vytvořit aplikaci OAuth. Tento proces je vysvětlený v Příručce pro vývojáře rozhraní GMAIL API Google. Google poskytuje nástroj pro nastavení , který vás provede procesem vytvoření projektu, povolením rozhraní Gmail API pro váš projekt a vytvořením klientské aplikace OAuth a přihlašovacích údajů pro něj. Tady jsou některé informace, které jsou užitečné při procházení nástroje:

  • V případě potřeby si přečtěte podmínky služby a odsouhlaste je.
  • Vyberte existující projekt nebo nástroj vytvoří nový projekt s názvem Můj projekt.
  • Nástroj v projektu povolí rozhraní API Gmailu.
  • Nástroj se pokusí zjistit typ přihlašovacích údajů, který potřebujete. Budete muset získat klientskou aplikaci OAuth.
    • Vyberte rozhraní API Gmailu pro rozhraní API, které budete používat (pokud ještě není vybrané).
    • Vyberte webový server , ze kterého budete rozhraní API volat.
    • Vyberte Uživatelská data pro data, ke které budete přistupovat.
  • Tento nástroj vás provede nastavením obrazovky souhlasu OAuth.
    • Vyberte typ uživatele (interní nebo externí). Pokud používáte uživatelský účet Gmail, nemůžete vybrat Interní.
    • Zadejte název a volitelně logo aplikace.
    • Klikněte na Přidat obor a přidejte obor Gmailu (https://mail.google.com).

      Poznámka:

      V závislosti na potřebě využití můžete zde vybrat příslušnou podmnožinu oborů oprávnění.

    • Přidejte azure-apim.net jako jednu z autorizovaných domén.

      Poznámka:

      Toto je doména, na které je konektor Gmail hostovaný, jak je zde definováno.

    • Volitelně můžete zadat další informace.
  • Nástroj vám umožní definovat a přidat přihlašovací údaje klienta OAuth 2.0.
    • Zadejte název klientské aplikace OAuth.
    • Přidat "https://global.consent.azure-apim.net/redirect" pro identifikátor URI přesměrování.

Po dokončení přejděte na vytvořeného klienta OAuth ze stránky Přihlašovací údaje. Najdete ID klienta a tajný klíč klienta vaší aplikace. Tyto hodnoty teď můžete použít ve svém připojení Gmail.

Klient Google OAuth Client

Použití vlastní aplikace v konektoru Gmail

Jakmile vytvoříte klientskou aplikaci Google OAuth, můžete ji použít při vytváření připojení Gmail.

  • Vyberte Možnost Přineste si vlastní aplikaci.
  • Zadejte ID klienta a tajné klíče klienta z vaší aplikace.

Kliknutím na Přihlásit se přihlaste ke svému účtu Gmail. Zobrazí se výzva, abyste se přihlásili ke svému účtu Gmail a pak autorizujete přístup k aplikaci Google, kterou jste vytvořili výše.

Známé problémy a omezení

Omezení aktivačních událostí pro velký počet příchozích e-mailů

Trigger Když přijde nový e-mail , může přeskočit e-maily, pokud dostáváte více než 300 e-mailů za 30 sekund interval. Zvažte konfiguraci toku s dalšími parametry filtru, abyste snížili počet e-mailů.

Trigger Při přijetí nového e-mailu může přerušovaně přeskočit e-maily s přílohami, pokud používáte účet Google Workspace (dříve G Suite). K tomu dochází, protože v některých případech trvá zpracování e-mailů rozhraní Gmail API dlouhou dobu (pravděpodobně kvůli kontrole zabezpečení příloh), takže e-maily se přijímají s určitým zpožděním.

Pokud je to možné alternativní řešení, zkuste následující:

  • Používejte malé e-maily (bez příloh), zkuste je poslat tak často

  • Použijte jiný uživatelský účet Gmail a nakonfigurujte automatické přeposílání z účtu Google Workspace na tento nový uživatelský účet Gmail. Nakonfigurujte aktivační událost pro tento nový účet. Vzhledem k tomu, že se jedná o uživatelský účet, věříme, že zpoždění bude minimalizované a trigger tyto e-maily nepřeskočí.

  • Použití vlastního konektoru k rozhraní LISTMessage API s parametrem q :

    • Vytvořte akci pro výpis zpráv za posledních 5 minut. Můžete to udělat pomocí q parametru. Příklad hodnoty parametru q - after:1649457986. Jako vstup akce byste měli zadat current time - 5min epochu.

      • 1649457986 je epocha, která představuje "Pátek, 8. dubna 2022 3:46:26 GMT-07:00".

    • Zkontrolujte hodnotu nextPageToken z odpovědi, dokud není prázdná. Pokud není prázdný, musíte z odpovědi volat stejné rozhraní API s pageToken hodnotou parametru nastavenou na nextPageToken . Můžete to udělat například pomocí smyčky "Until" .

    • Vyfiltrujte ID zpráv, které už byly zpracovány v předchozích spuštěních (např. k ukládání již zpracovaných ID můžete použít konektor Azure Table Storage ).

    • Akce Získat podrobnosti e-mailu k získání e-mailového obsahu podle ID

Používání konektoru Gmail s uživatelskými účty Gmail

V souladu se zásadami zabezpečení a ochrany osobních údajů společnosti Google se zákazníci, kteří používají účty Gmail uživatelů (účty končící @gmail.com a @googlemail.com) můžou se připojovat pouze k omezené sadě služeb v Rámci Power Automate a Logic Apps). Na zákazníky používající účty Google Workspace (dříve G Suite) tato změna nemá vliv. Pokud potřebujete používat konektor Gmail se službami, které nejsou uvedené v následujícím seznamu, budete muset zaregistrovat vlastní ID aplikace u Googlu. Níže je uveden seznam aktuálních schválených služeb, mějte na paměti, že tento seznam se může v budoucnu měnit v souladu se zásadami Společnosti Google:

  • Služby Google: Gmail, Google Calendar, Google Contacts, Google Drive, Google Sheets, Google Tasks
  • Integrované akce a triggery: Řízení, AI Builder, Operace s daty, Datum a čas, Číselné funkce, Power Virtual Agents, Power Apps, Request, Schedule, Text Functions, Variables, Flow button, Location
  • Omezená sada služeb Microsoftu: OneDrive, SharePoint, Excel, Dynamics, Microsoft Teams, Office 365, SQL, SFTP a FTP

Pokud v Power Automate vytvoříte tok s nevyhovující službou, tok se uloží do zakázaného stavu.

Výpočet pracovních jednotek

Konektor má limit omezování (viz zde) počtu pracovních jednotek, které je možné spotřebovat za den.

Logika výpočtu těchto pracovních jednotek pro každou operaci je znázorněna níže:

  • Když přijde nový e-mail : 10 + (5 * přílohCount);
    • Pokud trigger vrátí nový e-mail: 5 jednotek pro výpis zpráv + 5 jednotek pro získání zprávy + 5 jednotek * počet příloh.
    • Pokud trigger nevrátí nový e-mail: 5 jednotek pro výpis zpráv.
  • Akce Odeslat e-mail (V2): 100 jednotek.
  • Reakce na e-mail (V2) akce: 105 + (5 * přílohCount);
    • 5 jednotek pro získání původní zprávy + 100 jednotek pro odeslání zprávy odpovědi + 5 jednotek * počet vložených příloh v původní zprávě.
  • Pro všechny ostatní akce: 10 jednotek.

Hloubková spojnice

Další informace o konektoru najdete v podrobné části.

Obecné limity

Název Hodnota
Maximální velikost pošty (v MB) 35
Maximální velikost přílohy (v MB) 30

Vytvoření připojení

Konektor podporuje následující typy ověřování:
Používání vlastní aplikace Přihlaste se pomocí vlastní aplikace Google. Další podrobnosti najdete tady: https://docs.microsoft.com/connectors/gmail/#authentication-and-bring-your-own-application. Všechny oblasti Nesdílitelné
Použít výchozí sdílenou aplikaci Přihlaste se pomocí standardní aplikace Google. Všechny oblasti Nesdílitelné
Výchozí [ZASTARALÉ] Tato možnost je určená pouze pro starší připojení bez explicitního typu ověřování a poskytuje se pouze pro zpětnou kompatibilitu. Všechny oblasti Nesdílitelné

Používání vlastní aplikace

ID ověřování: byoa

Použitelné: Všechny oblasti

Přihlaste se pomocí vlastní aplikace Google. Další podrobnosti najdete tady: https://docs.microsoft.com/connectors/gmail/#authentication-and-bring-your-own-application.

Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

Název Typ Description Povinné
ID klienta řetězec ID klienta (nebo aplikace) vaší aplikace Google Pravdivé
Tajný klíč klienta securestring Tajný klíč klienta vaší aplikace Google Pravdivé

Použít výchozí sdílenou aplikaci

ID ověřování: shared-application

Použitelné: Všechny oblasti

Přihlaste se pomocí standardní aplikace Google.

Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

Výchozí [ZASTARALÉ]

Použitelné: Všechny oblasti

Tato možnost je určená pouze pro starší připojení bez explicitního typu ověřování a poskytuje se pouze pro zpětnou kompatibilitu.

Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

Limity omezování

Name Volání Období obnovení
Volání rozhraní API na připojení 60 60 sekund
Jednotky práce za den 90000 86400 sekund

Akce

Odeslat e-mail (V2)

Tato operace slouží k odeslání e-mailu konkrétním příjemcům.
Odeslat e-mail [ZASTARALÉ]

Tato akce je zastaralá. Místo toho použijte odeslat e-mail (V2).

Tato operace slouží k odeslání e-mailu konkrétním příjemcům.
Odpověď na e-mail (V2)

Tato operace slouží k odpovídání na konkrétní e-mail.
Odpověď na e-mail [ZASTARALÉ]

Tato akce je zastaralá. Místo toho použijte odpověď na e-mail (V2).

Tato operace slouží k odpovídání na konkrétní e-mail.
Odstranění e-mailu

Tato operace slouží k trvalému odstranění konkrétního e-mailu.
Přesunutí e-mailu do koše

Tato operace slouží k přesunutí konkrétního e-mailu do koše.
Získání podrobností e-mailu

Tato operace načte podrobnosti konkrétního e-mailu.

Odeslat e-mail (V2)

ID operace:
SendEmailV2

Tato operace slouží k odeslání e-mailu konkrétním příjemcům.

Parametry

Name Klíč Vyžadováno Typ Description
To
 To True email

Seznam platných e-mailových adres oddělených středníkem nebo čárkou.
titulek
 Cc email

Seznam platných e-mailových adres oddělených středníkem nebo čárkou.
SKRYTÁ
 Bcc email

Seznam platných e-mailových adres oddělených středníkem nebo čárkou.
Předmět
 Subject string

Předmět odchozího e-mailu
Body
 Body html

Text odchozího e-mailu
Důležitost
 Importance string

Důležitost přidružená k e-mailové zprávě
Název
 Name True string

Název přílohy
Content
 ContentBytes True byte

Text přílohy
Typ obsahu
 ContentType string

Typ obsahu v příloze

Odeslat e-mail [ZASTARALÉ]

ID operace:
SendEmail

Tato akce je zastaralá. Místo toho použijte odeslat e-mail (V2).

Tato operace slouží k odeslání e-mailu konkrétním příjemcům.

Parametry

Name Klíč Vyžadováno Typ Description
To
 To True email

Seznam platných e-mailových adres oddělených středníkem nebo čárkou.
titulek
 Cc email

Seznam platných e-mailových adres oddělených středníkem nebo čárkou.
SKRYTÁ
 Bcc email

Seznam platných e-mailových adres oddělených středníkem nebo čárkou.
Předmět
 Subject string

Předmět odchozího e-mailu
Body
 Body string

Text odchozího e-mailu
Je HTML
 IsHtml boolean

Ano, pokud chcete e-mail odeslat jako HTML. (výchozí: Pravda)
Důležitost
 Importance string

Důležitost přidružená k e-mailové zprávě
Název
 Name True string

Název přílohy
Content
 ContentBytes True byte

Text přílohy
Typ obsahu
 ContentType string

Typ obsahu v příloze

Odpověď na e-mail (V2)

ID operace:
ReplyToV2

Tato operace slouží k odpovídání na konkrétní e-mail.

Parametry

Name Klíč Vyžadováno Typ Description
ID zprávy
 id True string

ID e-mailu, na který chcete odpovědět.
To
 To email

Příklad: recipient1@domain.com; recipient2@domain.com
titulek
 Cc email

Příklad: recipient1@domain.com; recipient2@domain.com
SKRYTÁ
 Bcc email

Příklad: recipient1@domain.com; recipient2@domain.com
Předmět
 Subject string

Předmět e-mailu (pokud je prázdný, použije se původní předmět).
Body
 Body html

Obsah e-mailu.
Odpovědět všem
 ReplyAll boolean

Ano, pokud chcete odpovědět všem příjemcům. (výchozí hodnota: Nepravda)
Důležitost
 Importance string

Vyberte důležitost. (výchozí: Normální)
Název
 Name True string

Název přílohy
Content
 ContentBytes True byte

Text přílohy
Typ obsahu
 ContentType string

Typ obsahu v příloze

Odpověď na e-mail [ZASTARALÉ]

ID operace:
ReplyTo

Tato akce je zastaralá. Místo toho použijte odpověď na e-mail (V2).

Tato operace slouží k odpovídání na konkrétní e-mail.

Parametry

Name Klíč Vyžadováno Typ Description
ID zprávy
 id True string

ID e-mailu, na který chcete odpovědět.
To
 To email

Příklad: recipient1@domain.com; recipient2@domain.com
titulek
 Cc email

Příklad: recipient1@domain.com; recipient2@domain.com
SKRYTÁ
 Bcc email

Příklad: recipient1@domain.com; recipient2@domain.com
Předmět
 Subject string

Předmět e-mailu (pokud je prázdný, použije se původní předmět).
Body
 Body string

Obsah e-mailu.
Odpovědět všem
 ReplyAll boolean

Ano, pokud chcete odpovědět všem příjemcům. (výchozí hodnota: Nepravda)
Je HTML
 IsHtml boolean

True pro odeslání odpovědi jako HTML. (výchozí: Pravda)
Důležitost
 Importance string

Vyberte důležitost. (výchozí: Normální)
Název
 Name True string

Název přílohy
Content
 ContentBytes True byte

Text přílohy
Typ obsahu
 ContentType string

Typ obsahu v příloze

Odstranění e-mailu

ID operace:
DeleteEmail

Tato operace slouží k trvalému odstranění konkrétního e-mailu.

Parametry

Name Klíč Vyžadováno Typ Description
ID zprávy
 id True string

ID e-mailu, který chcete odstranit.

Přesunutí e-mailu do koše

ID operace:
TrashEmail

Tato operace slouží k přesunutí konkrétního e-mailu do koše.

Parametry

Name Klíč Vyžadováno Typ Description
ID zprávy
 id True string

ID e-mailu, který se má přesunout do koše

Získání podrobností e-mailu

ID operace:
GetEmail

Tato operace načte podrobnosti konkrétního e-mailu.

Parametry

Name Klíč Vyžadováno Typ Description
ID zprávy
 id True string

Jedinečné ID e-mailové zprávy
Zahrnout přílohy
 includeAttachments boolean

Pokud je nastavená hodnota true, přílohy se také načtou spolu s e-mailem.

Návraty

Podrobnosti spojené s konkrétní e-mailovou zprávou

Body
DetailedReceiveMessage

Aktivační události

Když přijde nový e-mail

Tato operace se aktivuje, když přijde nový e-mail odpovídající zadaným kritériím.

Když přijde nový e-mail

ID operace:
OnNewEmail

Tato operace se aktivuje, když přijde nový e-mail odpovídající zadaným kritériím.

Parametry

Name Klíč Vyžadováno Typ Description
Označení
 label string

Vyberte popisek (výchozí: Doručená pošta).
To
 to email

Seznam platných e-mailových adres oddělených středníkem nebo čárkou.
Od
 from email

Příklad: Sender1 | sender2@domain.com.
Předmět
 subject string

Řetězec, který chcete vyhledat v předmětu.
Důležitost
 importance string

Hodnota True, pokud má být e-mail důležitý. (výchozí: Vše).
Hvězdička
 starred string

Hodnota True, pokud má být e-mail označený hvězdičkou. (výchozí: Vše).
Obsahuje přílohy.
 fetchOnlyWithAttachments boolean

Ano, pokud chcete načíst jenom e-maily s přílohami.
Zahrnout přílohy
 includeAttachments boolean

Ano, pokud chcete načíst přílohy spolu s e-mailem.

Návraty

Podrobnosti spojené s konkrétní e-mailovou zprávou

Body
DetailedReceiveMessage

Definice

DetailedReceiveMessage

Podrobnosti spojené s konkrétní e-mailovou zprávou

Name Cesta Typ Description
Od
 From email

E-mailová adresa, ze které byla zpráva odeslána.
Jméno odesílatele
 SenderName string

Jméno odesílatele e-mailu
To
 To email

E-mailová adresa, na kterou byla zpráva odeslána.
titulek
 Cc email

E-mailové adresy obsažené v poli KOPIE
SKRYTÁ
 Bcc email

E-mailové adresy obsažené v poli SKRYTÁ.
Předmět
 Subject string

Předmět nebo téma přidružené k e-mailové zprávě
Body
 Body string

Obsah e-mailové zprávy
Úryvek
 Snippet string

Krátká část textu zprávy.
ID popisků
 LabelIds array of string

Seznam popisků přidružených k e-mailové zprávě
Přijaté Date-Time
 DateTimeReceived date-time

Příklad:2017-05-03T20:08:57+00:00
Odhadovaná velikost
 EstimatedSize integer

Odhadovaná velikost v bajtech zprávy
Je přečteno?
 IsRead boolean

True pokud je zpráva přečtená; jinak nepravda.
Je HTML
 IsHtml boolean

True, pokud je zpráva ve formátu HTML.
Obsahuje přílohy.
 HasAttachments boolean

Má hodnotu True, pokud zpráva obsahuje přílohy.
Attachments
 Attachments array of Attachment

Seznam příloh e-mailové zprávy
ID zprávy
 Id string

Neměnné ID zprávy.
ID vlákna
 ThreadId string

ID vlákna, do které zpráva patří.

Příloha

Vlastnosti přílohy e-mailu

Name Cesta Typ Description
Název
 Name string

Název přílohy
Content
 ContentBytes byte

Text přílohy
Typ obsahu
 ContentType string

Typ obsahu v příloze