Gmail

A Gmail egy webalapú e-mail szolgáltatás a Google-tól. A Gmail-összekötővel olyan műveleteket hajthat végre, mint például e-mailek küldése vagy fogadása, valamint folyamatok aktiválása új e-maileken.

Ez az összekötő a következő termékekben és régiókban érhető el:

Service	Class	Régiók
Copilot Studio	Standard	Az összes Power Automate-régió, kivéve a következőket:      - Amerikai kormány (GCC High)      - A 21Vianet által üzemeltetett China Cloud      - Amerikai Védelmi Minisztérium (DoD)
Logikai alkalmazások	Standard	Az összes Logic Apps-régió , kivéve a következőket:      - Azure China-régiók      - Amerikai Védelmi Minisztérium (DoD)
Power Alkalmazások	Standard	Az összes Power Apps-régió , kivéve a következőket:      - Amerikai kormány (GCC High)      - A 21Vianet által üzemeltetett China Cloud      - Amerikai Védelmi Minisztérium (DoD)
Power Automate	Standard	Az összes Power Automate-régió, kivéve a következőket:      - Amerikai kormány (GCC High)      - A 21Vianet által üzemeltetett China Cloud      - Amerikai Védelmi Minisztérium (DoD)

Érintkezés
Név	Microsoft
URL	Microsoft LogicApps-támogatás Microsoft Power Automate-támogatás Microsoft Power Apps-támogatás

Összekötő metaadatai
Kiadó	Microsoft
Webhely	https://mail.google.com/mail/
Adatvédelmi irányelvek	https://policies.google.com/privacy

Hitelesítés és saját alkalmazás létrehozása

A Gmail-összekötő mostantól több hitelesítési típust is támogat:

• Alapértelmezett megosztott alkalmazás használata
• Saját alkalmazás használata

Az alapértelmezett megosztott alkalmazás a Microsoft által karbantartott Google-ügyfélalkalmazást használja. Ebben az esetben, amikor bejelentkezik a Gmail-fiókjába, a rendszer kérni fogja, hogy járuljon hozzá a Microsoft Power Platform alkalmazáshoz.

A "Saját alkalmazás használata" lehetőséggel saját Google OAuth-ügyfélalkalmazást használhat a Microsoft által kezelt helyett. Ezzel szabályozhatja az engedélyeket, és engedélyezheti az összekötő használatára vonatkozó bizonyos korlátozásokat.

Ha saját Google OAuth-ügyfélalkalmazást szeretne használni a Gmail-összekötővel, a következő lépéseket kell végrehajtania:

1. OAuth-ügyfélalkalmazás létrehozása a Google API-konzoljával
2. Az alkalmazás használata a Gmail-összekötőben

OAuth-ügyfélalkalmazás létrehozása a Google-ban

Saját Google OAuth-ügyfélalkalmazás létrehozásához először be https://developer.google.comkell jelentkeznie. Lépjen a Google API-konzoljára – ahol kezelheti a Google API-khoz való hozzáférést –, és hozza létre az OAuth-alkalmazást. Ezt a folyamatot a Google Gmail API fejlesztői útmutatója ismerteti. A Google egy telepítőeszközt biztosít, amely végigvezeti Önt egy projekt létrehozásának folyamatán, engedélyezi a Gmail API-t a projekthez, és létrehoz egy OAuth-ügyfélalkalmazást és annak hitelesítő adatait. Az alábbi információk hasznosak lehetnek az eszköz használata során:

• Szükség esetén olvassa el és fogadja el a szolgáltatási feltételeket.
• Válasszon ki egy meglévő projektet, vagy az eszköz létrehoz egy "Saját projekt" nevű újat.
• Az eszköz engedélyezi a Gmail API-t a projektben.
• Az eszköz megpróbálja kideríteni a szükséges hitelesítő adatokat. Be kell szereznie egy OAuth-ügyfélalkalmazást.
  • Válassza a Gmail API-t a használni kívánt API-hoz (ha még nincs kiválasztva).
  • Válassza ki a webkiszolgálót arra a helyre, ahonnan az API-t meghívja.
  • Válassza ki a felhasználói adatokat azokhoz az adatokhoz, amelyhez hozzá fog férni.
• Az eszköz végigvezeti az OAuth hozzájárulási képernyőjének beállításán.
  • Válassza ki a felhasználó típusát (belső vagy külső). Ha Gmail-felhasználói fiókot használ, nem választhatja a Belső lehetőséget.
  • Adjon meg egy nevet és egy emblémát az alkalmazáshoz.
  • Kattintson a Hatókör hozzáadása elemre, és adja hozzá a Gmail-hatókört (https://mail.google.com).

    Megjegyzés:

    A használati igény alapján itt kiválaszthatja az engedélyhatókörök megfelelő részhalmazát.

  • Adja hozzá a azure-apim.net az egyik engedélyezett tartományként.

    Megjegyzés:

    Ez az a tartomány, amelyen a Gmail-összekötő üzemel, az itt meghatározott módon.

  • Igény szerint adja meg a többi információt.
• Az eszköz lehetővé teszi az OAuth 2.0-ügyfél hitelesítő adatainak meghatározását és hozzáadását.
  • Adja meg az OAuth-ügyfélalkalmazás nevét.
  • https://global.consent.azure-apim.net/redirect""; az átirányítási URI-hoz.

Ha végzett, lépjen a létrehozott OAuth-ügyfélre a Hitelesítő adatok lapon. Megtalálja az alkalmazás ügyfél-azonosítóját és titkos kódját. Ezeket az értékeket most már használhatja a Gmail-kapcsolatában.

Saját alkalmazás használata a Gmail-összekötőben

Miután létrehozta a Google OAuth-ügyfélalkalmazást, használhatja azt Gmail-kapcsolat létrehozásakor.

• Válassza a Saját alkalmazás létrehozása lehetőséget.
• Adja meg az alkalmazás ügyfélazonosítóját és titkos ügyfélkulcs-értékeit.

A Bejelentkezés gombra kattintva jelentkezzen be Gmail-fiókjába. Ez arra kéri, hogy jelentkezzen be Gmail-fiókjába, majd engedélyezze a fent létrehozott Google-alkalmazáshoz való hozzáférést.

Ismert problémák és korlátozások

Nagy számú bejövő e-mail aktiválási korlátozásai

Ha 300-nál több e-mailt kap 30 másodpercenként, az új e-mail-eseményindító kihagyhatja az e-maileket. Fontolja meg a folyamat konfigurálását további szűrőparaméterekkel az e-mailek számának csökkentése érdekében.

Az Új e-mailek érkezésekor eseményindító időnként kihagyhatja a mellékleteket tartalmazó e-maileket, ha Google Workspace-fiókot (korábbi nevén G Suite-fiókot) használ. Ez azért fordul elő, mert bizonyos esetekben a Gmail API hosszú időt vesz igénybe az e-mailek feldolgozásához (esetleg a mellékletek biztonsági vizsgálata miatt), így az e-mailek bizonyos késéssel érkeznek.

Lehetséges áthidaló megoldásként próbálkozzon a következő lehetőségekkel:

• Használjon apró e-maileket (mellékletek nélkül), próbálja meg nem ennyire gyakran elküldeni őket

• Használjon egy másik fogyasztói Gmail-fiókot, és konfigurálja az automatikus továbbítást a Google Workspace-fiókból ebbe az új fogyasztói Gmail-fiókba. Konfigurálja az eseményindítót az új fiókhoz. Mivel ez egy fogyasztói fiók, úgy gondoljuk, hogy a késés minimálisra csökken, és az eseményindító nem hagyja ki az ilyen e-maileket.

• Egyéni összekötő használata a ListMessage API-hoz egy q paraméterrel:

  • Hozzon létre egy műveletet az utolsó 5 perc üzeneteinek listázásához. Ezt paraméterrel q teheti meg. Példa a q paraméterértékre – after:1649457986. A művelet bemeneteként meg kell adnia current time - 5min a korszakidőt.

    • 1649457986 a "2022. április 8., péntek, 15:46:26 GMT-07:00" időpontot jelöli.

  • Ellenőrizze a következőPageToken értéket a válaszból, amíg üres nem lesz. Ha nem üres, akkor ugyanazt az API-t kell meghívnia, amelynek pageToken paraméterértéke a következőPageTokenre van állítva a válaszból. Ehhez használhatja például a "Until" ciklust .

  • Szűrje ki azokat az üzenetek azonosítóit, amelyeket már feldolgoztak az előző futtatások során (például használhatja az Azure Table Storage-összekötőt a már feldolgozott azonosítók tárolására)

  • Az e-mail részleteinek lekérése művelet az e-mail-tartalom azonosító alapján történő lekéréséhez

Gmail-összekötő használata fogyasztói Gmail-fiókokkal

A Google biztonsági és adatvédelmi szabályzatának megfelelően a fogyasztói Gmail-fiókokat használó ügyfelek (a fiókok végződnek @gmail.com , és @googlemail.com) csak korlátozott számú szolgáltatáshoz tudnak csatlakozni a Power Automate-ben és a Logic Appsben). A változás nem érinti a Google Workspace-fiókokat (korábbi nevén G Suite-fiókokat) használó ügyfeleket. Ha a Gmail-összekötőt az alábbi listában nem szereplő szolgáltatásokkal kell használnia, regisztrálnia kell saját alkalmazásazonosítóját a Google-ban. Az alábbiakban az aktuálisan jóváhagyott szolgáltatások listája látható, ne feledje, hogy ez a lista a Jövőben változhat a Google szabályzataival összhangban:

• Google-szolgáltatások: Gmail, Google Calendar, Google Contacts, Google Drive, Google Sheets, Google Tasks
• Beépített műveletek és eseményindítók: Vezérlő, AI Builder, Adatműveletek, Dátumidő, Számfüggvények, Power Virtual Agents, Power Apps, Kérelem, Ütemezés, Szövegfüggvények, Változók, Folyamat gomb, Hely
• Microsoft-szolgáltatások korlátozott készlete: OneDrive, Sharepoint, Excel, Dynamics, Microsoft Teams, Office 365, SQL, SFTP és FTP

A Power Automate-ben, ha nem megfelelő szolgáltatással hoz létre folyamatot, a folyamat le van tiltva.

Munkaegységek kiszámítása

Az összekötő szabályozási korlátja van ( lásd itt) az egy nap alatt felhasználható munkaegységek számát.

Az egyes műveletekhez tartozó munkaegységek kiszámításának logikája az alábbiakban látható:

• Új e-mail érkezésekor eseményindító: 10 + (5 * attachmentsCount);
  • Ha az eseményindító új e-mailt ad vissza: 5 egység az üzenetek listázásához + 5 egység az üzenet lekéréséhez + 5 egység * mellékletek száma.
  • Ha az eseményindító nem ad vissza új e-mailt: 5 egység az üzenetek listázásához.
• E-mail küldése (V2) művelet: 100 egység.
• Válasz e-mailre (V2) művelet: 105 + (5 * attachmentsCount);
  • 5 egység az eredeti üzenet lekéréséhez + 100 egység válaszüzenet küldéséhez + 5 egység * beágyazott mellékletek száma az eredeti üzenetben.
• Minden más művelethez: 10 egység.

Az összekötő részletes ismertetése

Az összekötőről további információt a részletes szakaszban talál.

Általános korlátok

Név	Érték
Maximális levélméret (MB-ban)	35
Maximális mellékletméret (MB-ban)	30

Kapcsolat létrehozása

Az összekötő a következő hitelesítési típusokat támogatja:

Saját alkalmazás használata	Jelentkezzen be saját Google-alkalmazásával. További információ: https://docs.microsoft.com/connectors/gmail/#authentication-and-bring-your-own-application.	Minden régió	Nem osztható meg
Alapértelmezett megosztott alkalmazás használata	Jelentkezzen be a szokásos Google-alkalmazással.	Minden régió	Nem osztható meg
Alapértelmezett [ELAVULT]	Ez a beállítás csak olyan régebbi kapcsolatokhoz használható, amelyeknek nincs explicit hitelesítési típusuk, és csak a visszamenőleges kompatibilitást biztosítják.	Minden régió	Nem osztható meg

Saját alkalmazás használata

Hitelesítési azonosító: byoa

Alkalmazható: Minden régió

Jelentkezzen be saját Google-alkalmazásával. További információ: https://docs.microsoft.com/connectors/gmail/#authentication-and-bring-your-own-application.

Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.

Név	Típus	Description	Kötelező
Ügyfélazonosító	karakterlánc	A Google-alkalmazás ügyfél-(vagy alkalmazás-) azonosítója	True
Titkos ügyfélkulcs	securestring	A Google-alkalmazás titkos ügyfélkódja	True

Alapértelmezett megosztott alkalmazás használata

Hitelesítési azonosító: megosztott alkalmazás

Alkalmazható: Minden régió

Jelentkezzen be a szokásos Google-alkalmazással.

Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.

Alapértelmezett [ELAVULT]

Alkalmazható: Minden régió

Ez a beállítás csak olyan régebbi kapcsolatokhoz használható, amelyeknek nincs explicit hitelesítési típusuk, és csak a visszamenőleges kompatibilitást biztosítják.

Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.

Szabályozási korlátok

Name	Hívások	Megújítási időszak
API-hívások kapcsolatonként	60	60 másodperc
Munkaegységek naponta	90000	86400 másodperc

Műveletek

E-mail küldése (V2)	Ez a művelet arra szolgál, hogy e-mailt küldjön adott címzetteknek.
E-mail küldése [ELAVULT]	Ez a művelet elavult. Használja helyette az E-mail küldése (V2) elemet . Ez a művelet arra szolgál, hogy e-mailt küldjön adott címzetteknek.
E-mail részleteinek lekérése	Ez a művelet lekéri egy adott e-mail részleteit.
E-mail törlése	Ez a művelet egy adott e-mail végleges törlésére szolgál.
E-mailek áthelyezése a kukába	Ez a művelet egy adott e-mail kukába való áthelyezésére szolgál.
Válasz e-mailre (V2)	Ez a művelet egy adott e-mail megválaszolására szolgál.
Válasz e-mailre [ELAVULT]	Ez a művelet elavult. Használja helyette a Válasz e-mail (V2) elemet . Ez a művelet egy adott e-mail megválaszolására szolgál.

E-mail küldése (V2)

Műveletazonosító:

SendEmailV2

Ez a művelet arra szolgál, hogy e-mailt küldjön adott címzetteknek.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Há	To	True	email	Pontosvesszővel vagy vesszővel elválasztott érvényes e-mail-címek listája.
felirat	Cc		email	Pontosvesszővel vagy vesszővel elválasztott érvényes e-mail-címek listája.
BCC	Bcc		email	Pontosvesszővel vagy vesszővel elválasztott érvényes e-mail-címek listája.
Tárgy	Subject		string	A kimenő e-mail tárgya.
Törzs	Body		html	A kimenő e-mail törzse.
Fontosság	Importance		string	Az e-mailhez társított fontosság.
Név	Name	True	string	A melléklet címe.
Content	ContentBytes	True	byte	A melléklet törzse.
Tartalom típusa	ContentType		string	A melléklet tartalma.

E-mail küldése [ELAVULT]

Műveletazonosító:

SendEmail

Ez a művelet elavult. Használja helyette az E-mail küldése (V2) elemet .

Ez a művelet arra szolgál, hogy e-mailt küldjön adott címzetteknek.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Há	To	True	email	Pontosvesszővel vagy vesszővel elválasztott érvényes e-mail-címek listája.
felirat	Cc		email	Pontosvesszővel vagy vesszővel elválasztott érvényes e-mail-címek listája.
BCC	Bcc		email	Pontosvesszővel vagy vesszővel elválasztott érvényes e-mail-címek listája.
Tárgy	Subject		string	A kimenő e-mail tárgya.
Törzs	Body		string	A kimenő e-mail törzse.
HTML-alapú	IsHtml		boolean	Igaz az e-mail HTML-ként való elküldéséhez. (alapértelmezett: Igaz)
Fontosság	Importance		string	Az e-mailhez társított fontosság.
Név	Name	True	string	A melléklet címe.
Content	ContentBytes	True	byte	A melléklet törzse.
Tartalom típusa	ContentType		string	A melléklet tartalma.

E-mail részleteinek lekérése

Műveletazonosító:

GetEmail

Ez a művelet lekéri egy adott e-mail részleteit.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Üzenetazonosító	id	True	string	Az e-mail egyedi azonosítója.
Mellékletek belefoglalása	includeAttachments		boolean	Ha igaz értékre van állítva, a rendszer a mellékleteket is lekéri az e-maillel együtt.

Válaszok

Adott e-mailhez társított részletek.

Törzs

DetailedReceiveMessage

E-mail törlése

Műveletazonosító:

DeleteEmail

Ez a művelet egy adott e-mail végleges törlésére szolgál.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Üzenetazonosító	id	True	string	A törölni kívánt e-mail azonosítója.

E-mailek áthelyezése a kukába

Műveletazonosító:

TrashEmail

Ez a művelet egy adott e-mail kukába való áthelyezésére szolgál.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Üzenetazonosító	id	True	string	Az e-mail azonosítója a kukába való áthelyezéshez.

Válasz e-mailre (V2)

Műveletazonosító:

ReplyToV2

Ez a művelet egy adott e-mail megválaszolására szolgál.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Üzenetazonosító	id	True	string	A megválaszolandó e-mail azonosítója.
Há	To		email	Példa: recipient1@domain.com; recipient2@domain.com
felirat	Cc		email	Példa: recipient1@domain.com; recipient2@domain.com
BCC	Bcc		email	Példa: recipient1@domain.com; recipient2@domain.com
Tárgy	Subject		string	E-mail tárgy (ha üres, az eredeti tárgy használt).
Törzs	Body		html	Az e-mail tartalma.
Válasz mindenkinek	ReplyAll		boolean	Igaz, hogy válaszoljon az összes címzettnek. (alapértelmezett: Hamis)
Fontosság	Importance		string	Válasszon fontosságot. (alapértelmezett: Normál)
Név	Name	True	string	A melléklet címe.
Content	ContentBytes	True	byte	A melléklet törzse.
Tartalom típusa	ContentType		string	A melléklet tartalma.

Válasz e-mailre [ELAVULT]

Műveletazonosító:

ReplyTo

Ez a művelet elavult. Használja helyette a Válasz e-mail (V2) elemet .

Ez a művelet egy adott e-mail megválaszolására szolgál.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Üzenetazonosító	id	True	string	A megválaszolandó e-mail azonosítója.
Há	To		email	Példa: recipient1@domain.com; recipient2@domain.com
felirat	Cc		email	Példa: recipient1@domain.com; recipient2@domain.com
BCC	Bcc		email	Példa: recipient1@domain.com; recipient2@domain.com
Tárgy	Subject		string	E-mail tárgy (ha üres, az eredeti tárgy használt).
Törzs	Body		string	Az e-mail tartalma.
Válasz mindenkinek	ReplyAll		boolean	Igaz, hogy válaszoljon az összes címzettnek. (alapértelmezett: Hamis)
HTML-alapú	IsHtml		boolean	Igaz, hogy html formátumban küldje el a választ. (alapértelmezett: Igaz)
Fontosság	Importance		string	Válasszon fontosságot. (alapértelmezett: Normál)
Név	Name	True	string	A melléklet címe.
Content	ContentBytes	True	byte	A melléklet törzse.
Tartalom típusa	ContentType		string	A melléklet tartalma.

Triggerek

Új e-mail érkezésekor

Ez a művelet akkor aktiválódik, ha a megadott feltételeknek megfelelő új e-mail érkezik.

Új e-mail érkezésekor

Műveletazonosító:

OnNewEmail

Ez a művelet akkor aktiválódik, ha a megadott feltételeknek megfelelő új e-mail érkezik.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Címke	label		string	Válasszon egy címkét (alapértelmezett: Beérkezett üzenetek).
Há	to		email	Pontosvesszővel vagy vesszővel elválasztott érvényes e-mail-címek listája.
Ettől kezdve	from		email	Példa: Sender1 | sender2@domain.com.
Tárgy	subject		string	A tárgyban keresendő sztring.
Fontosság	importance		string	Igaz, ha az e-mailnek fontosnak kell lennie. (alapértelmezett: Mind).
Játszott	starred		string	Igaz, ha az e-mailnek csillaggal kell rendelkeznie. (alapértelmezett: Mind).
Mellékletekkel rendelkezik	fetchOnlyWithAttachments		boolean	Igaz, ha csak mellékleteket tartalmazó e-maileket kér le.
Mellékletek belefoglalása	includeAttachments		boolean	Igaz a mellékletek lekérése az e-maillel együtt.

Válaszok

Adott e-mailhez társított részletek.

Törzs

DetailedReceiveMessage

Definíciók

DetailedReceiveMessage

Adott e-mailhez társított részletek.

Name	Elérési út	Típus	Description
Ettől kezdve	From	email	E-mail-cím, ahonnan az üzenetet küldték.
Feladó neve	SenderName	string	E-mail feladójának neve
Há	To	email	E-mail-cím, amelybe az üzenetet elküldték.
felirat	Cc	email	A CC mezőben található e-mail-címek.
BCC	Bcc	email	A Titkos másolat mezőben szereplő e-mail-címek.
Tárgy	Subject	string	Az e-mailhez társított tárgy vagy témakör.
Törzs	Body	string	Az e-mail tartalma.
Részlet	Snippet	string	Az üzenet szövegének egy rövid része.
Címkeazonosítók	LabelIds	array of string	Az e-mailhez társított címkék listája.
Fogadott Date-Time	DateTimeReceived	date-time	Példa:2017-05-03T20:08:57+00:00
Becsült méret	EstimatedSize	integer	Az üzenet becsült mérete bájtban.
Olvas?	IsRead	boolean	Igaz, ha az üzenet be van olvasva; máskülönben hamis.
HTML-alapú	IsHtml	boolean	Igaz, ha az üzenet HTML formátumú.
Mellékletekkel rendelkezik	HasAttachments	boolean	Igaz, ha az üzenet mellékletekkel rendelkezik.
Attachments	Attachments	array of Attachment	Az e-mail mellékleteinek listája.
Üzenetazonosító	Id	string	Az üzenet nem módosítható azonosítója.
Szálazonosító	ThreadId	string	Annak a szálnak az azonosítója, amelyhez az üzenet tartozik.

Attachment

E-mail melléklet tulajdonságai.

Name	Elérési út	Típus	Description
Név	Name	string	A melléklet címe.
Content	ContentBytes	byte	A melléklet törzse.
Tartalom típusa	ContentType	string	A melléklet tartalma.