Gmail

Gmail is een web-e-mailservice van Google. Met de Gmail-connector kunt u acties uitvoeren zoals e-mailberichten verzenden of ontvangen en stromen activeren voor nieuwe e-mailberichten.

Deze connector is beschikbaar in de volgende producten en regio's:

Dienst Class Regions
Copilot Studio Standaard Alle Power Automate-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Logic-apps Standaard Alle Logic Apps-regio's , met uitzondering van het volgende:
     - Azure China-regio's
     - Us Department of Defense (DoD)
Power Apps Standaard Alle Power Apps-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Power Automate Standaard Alle Power Automate-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Contactpersoon
Naam Microsoft
URL https://learn.microsoft.com/en-us/connectors/gmail/
E-mailadres connectorservicing@microsoft.com
Connectormetagegevens
Uitgever Microsoft
Webpagina https://mail.google.com/mail/
Privacybeleid https://policies.google.com/privacy
Categorieën Productiviteit

Verificatie en Bring Your Own Application

De Gmail-connector ondersteunt nu meerdere verificatietypen:

  • Standaard gedeelde toepassing gebruiken
  • Bring Your Own Application

De standaard gedeelde toepassing maakt gebruik van een Google Client-toepassing die wordt onderhouden door Microsoft. In dit geval wordt u gevraagd om toestemming te geven voor de Microsoft Power Platform-toepassing wanneer u zich aanmeldt bij uw Gmail-account.

Met de optie 'Bring your own application' kunt u uw eigen Google OAuth-clienttoepassing gebruiken in plaats van de toepassing die wordt beheerd door Microsoft. Hierdoor kunt u machtigingen beheren en bepaalde beperkingen voor het gebruik van de connector inschakelen.

Als u uw eigen Google OAuth-clienttoepassing wilt gebruiken met de Gmail-connector, moet u de volgende stappen uitvoeren:

  1. Een OAuth-clienttoepassing maken met behulp van de API-console van Google
  2. De toepassing gebruiken in de Gmail-connector

Een OAuth-clienttoepassing maken in Google

Als u uw eigen Google OAuth-clienttoepassing wilt maken, moet u zich eerst aanmelden bij https://developer.google.com. Navigeer naar de API-console van Google, waar u de toegang tot Google-API's kunt beheren en de OAuth-toepassing kunt maken. Dit proces wordt uitgelegd in de ontwikkelaarshandleiding voor de Gmail-API van Google. Google biedt een installatieprogramma om u te begeleiden bij het maken van een project voor u, het inschakelen van de Gmail-API voor uw project en het maken van een OAuth-clienttoepassing en de referenties hiervoor. Hier vindt u enkele informatie die nuttig is bij het doorlopen van het hulpprogramma:

  • Lees en ga indien nodig akkoord met de servicevoorwaarden.
  • Selecteer een bestaand project of het hulpprogramma maakt een nieuw project met de naam 'Mijn project'.
  • Met het hulpprogramma wordt de Gmail-API in het project ingeschakeld.
  • Het hulpprogramma probeert het referentietype te achterhalen dat u nodig hebt. U moet een OAuth-clienttoepassing ophalen.
    • Selecteer de Gmail-API voor de API die u gaat gebruiken (als deze nog niet is geselecteerd).
    • Selecteer webserver voor de locatie waaruit u de API aanroept.
    • Selecteer Gebruikersgegevens voor de gegevens die u wilt openen.
  • Het hulpprogramma begeleidt u bij het instellen van een OAuth-toestemmingsscherm.
    • Selecteer het gebruikerstype (intern of extern). Als u een Gmail-consumentenaccount gebruikt, kunt u Intern niet selecteren.
    • Geef een naam op en eventueel een logo voor uw toepassing.
    • Klik op Bereik toevoegen en voeg het Gmail-bereik (https://mail.google.com) toe.

      Opmerking

      Op basis van uw gebruiksbehoefte kunt u hier een geschikte subset van de machtigingsbereiken selecteren.

    • Voeg azure-apim.net toe als een van de geautoriseerde domeinen.

      Opmerking

      Dit is het domein waarop de Gmail-connector wordt gehost, zoals hier is gedefinieerd.

    • Geef desgewenst de andere informatie op.
  • Met het hulpprogramma kunt u een OAuth 2.0-clientreferentie definiëren en toevoegen.
    • Geef een naam op voor uw OAuth-clienttoepassing.
    • Toevoegen "https://global.consent.azure-apim.net/redirect" voor de omleidings-URI.

Zodra u klaar bent, gaat u naar de gemaakte OAuth-client vanaf de pagina Referenties. U vindt de client-id en het clientgeheim van uw app. U kunt deze waarden nu gebruiken in uw Gmail-verbinding.

Google OAuth-client

Uw eigen toepassing gebruiken in de Gmail-connector

Zodra u de Google OAuth-clienttoepassing hebt gemaakt, kunt u deze gebruiken tijdens het maken van een Gmail-verbinding.

  • Selecteer Bring Your Own Application.
  • Geef de client-id en clientgeheimwaarden van uw toepassing op.

Klik op Aanmelden om u aan te melden bij uw Gmail-account. U wordt gevraagd u aan te melden bij uw Gmail-account en vervolgens toegang te verlenen tot de Google-app die u hierboven hebt gemaakt.

Bekende problemen en beperkingen

Triggerbeperkingen voor een groot aantal binnenkomende e-mailberichten

De trigger Wanneer een nieuwe e-mail binnenkomt, kan e-mailberichten overslaan als u meer dan 300 e-mailberichten per interval van 30 seconden ontvangt. Overweeg om uw stroom te configureren met extra filterparameters om het aantal e-mailberichten te verminderen.

De trigger Wanneer een nieuwe e-mail binnenkomt, kan af en toe e-mailberichten met bijlagen overslaan als u een Google Workspace-account (voorheen G Suite) gebruikt. Dit gebeurt omdat het in sommige gevallen lang duurt voordat de Gmail-API e-mailberichten verwerkt (mogelijk vanwege beveiligingsscans van bijlagen), zodat de e-mailberichten met een bepaalde vertraging worden ontvangen.

Probeer het volgende als tijdelijke oplossing:

  • Gebruik kleine e-mailberichten (zonder bijlagen), probeer ze niet zo vaak te verzenden

  • Gebruik een ander Gmail-account voor consumenten en configureer automatisch doorsturen vanuit het Google Workspace-account naar dit nieuwe Gmail-account voor consumenten. Configureer de trigger voor dit nieuwe account. Omdat dit een consumentenaccount is, geloven we dat de vertraging wordt geminimaliseerd en dat de trigger dergelijke e-mailberichten niet overslaat.

  • Gebruik een aangepaste connector voor de ListMessage-API met een q parameter:

    • Maak een actie om berichten voor de afgelopen 5 minuten weer te geven. U kunt dit doen met behulp van q de parameter. Voorbeeld van q parameterwaarde - after:1649457986. U moet tijdsduur opgeven current time - 5min als de actie-invoer.

      • 1649457986 is de tijd die staat voor "vrijdag, 8 april 2022 3:46:26 PM GMT-07:00".
    • Controleer de nextPageToken-waarde uit het antwoord totdat deze leeg is. Als deze niet leeg is, moet u dezelfde API aanroepen met pageToken parameterwaarde die is ingesteld op het nextPageToken vanuit het antwoord. U kunt dit bijvoorbeeld doen met de lus 'Until' .

    • Filter deze berichten-id's die al in eerdere uitvoeringen zijn verwerkt (u kunt bijvoorbeeld de Azure-tabelopslag-connector gebruiken om al verwerkte id's op te slaan)

    • De actie E-maildetails ophalen gebruiken om e-mailinhoud op id op te halen

Gmail-connector gebruiken met consumenten-Gmail-accounts

In overeenstemming met het beveiligings- en privacybeleid van Google gebruiken klanten Gmail-accounts voor consumenten (accounts eindigend @gmail.com en @googlemail.com) kunnen ze alleen verbinding maken met een beperkte set services in Power Automate en Logic Apps. Klanten die Gebruikmaken van Google Workspace-accounts (voorheen G Suite) worden niet beïnvloed door deze wijziging. Als u de Gmail-connector wilt gebruiken met services die niet zijn opgegeven in de onderstaande lijst, moet u uw eigen toepassings-id registreren bij Google. Hieronder ziet u de lijst met de huidige goedgekeurde services. Houd er rekening mee dat deze lijst in de toekomst kan worden gewijzigd in overeenstemming met het beleid van Google:

  • Google-services: Gmail, Google Agenda, Google Contactpersonen, Google Drive, Google Spreadsheets, Google Tasks
  • Ingebouwde acties en triggers: Beheer, AI Builder, Gegevensbewerkingen, Datum/tijd, Getalfuncties, Power Virtual Agents, Power Apps, Aanvraag, Planning, Tekstfuncties, Variabelen, Stroomknop, Locatie
  • Beperkte set Microsoft-services: OneDrive, Sharepoint, Excel, Dynamics, Microsoft Teams, Office 365, SQL, SFTP en FTP

Als u in Power Automate een stroom maakt met een niet-compatibele service, wordt de stroom uiteindelijk opgeslagen in een uitgeschakelde status.

Werkeenheden berekenen

De connector heeft een beperkingslimiet ( zie hier) voor het aantal werkeenheden dat in een dag kan worden verbruikt.

De logica voor de berekening van deze werkeenheden voor elke bewerking wordt hieronder weergegeven:

  • Wanneer er een nieuwe e-mail binnenkomt : 10 + (5 * attachmentsCount);
    • Als de trigger nieuwe e-mail retourneert: 5 eenheden om berichten + 5 eenheden weer te geven om het aantal berichten + 5 eenheden * bijlagen op te halen.
    • Als de trigger geen nieuwe e-mail retourneert: 5 eenheden om berichten weer te geven.
  • E-mailactie (V2) verzenden : 100 eenheden.
  • Antwoord op e-mailactie (V2): 105 + (5 * attachmentsCount);
    • 5 eenheden om het oorspronkelijke bericht + 100 eenheden te ontvangen om antwoordbericht + 5 eenheden * aantal inlinebijlagen in het oorspronkelijke bericht te verzenden.
  • Voor alle andere acties: 10 eenheden.

Connector uitgebreid

Zie de uitgebreide sectie voor meer informatie over de connector.

Algemene limieten

Naam Waarde
Maximale grootte van e-mail (in MB) 35
Maximale bijlagegrootte (in MB) 30

Een verbinding maken

De connector ondersteunt de volgende verificatietypen:

Bring Your Own Application Meld u aan met uw eigen Google-app. Zie https://docs.microsoft.com/connectors/gmail/#authentication-and-bring-your-own-applicationvoor meer informatie. Alle regio's Niet deelbaar
Standaard gedeelde toepassing gebruiken Meld u aan met behulp van de standaard Google-app. Alle regio's Niet deelbaar
Standaard [AFGESCHAFT] Deze optie is alleen bedoeld voor oudere verbindingen zonder expliciet verificatietype en is alleen beschikbaar voor compatibiliteit met eerdere versies. Alle regio's Niet deelbaar

Bring Your Own Application

Verificatie-id: byoa

Van toepassing: Alle regio's

Meld u aan met uw eigen Google-app. Zie https://docs.microsoft.com/connectors/gmail/#authentication-and-bring-your-own-applicationvoor meer informatie.

Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.

Naam Typologie Description Verplicht
Klant-ID touw Client-id (of toepassing) van uw Google-toepassing Klopt
Clientgeheim beveiligde string Clientgeheim van uw Google-toepassing Klopt

Standaard gedeelde toepassing gebruiken

Verificatie-id: gedeelde toepassing

Van toepassing: Alle regio's

Meld u aan met behulp van de standaard Google-app.

Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.

Standaard [AFGESCHAFT]

Van toepassing: Alle regio's

Deze optie is alleen bedoeld voor oudere verbindingen zonder expliciet verificatietype en is alleen beschikbaar voor compatibiliteit met eerdere versies.

Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.

Beperkingslimieten

Name Aanroepen Verlengingsperiode
Werkeenheden per dag 90000 86400 seconden
API-aanroepen per verbinding 60 60 seconden

Acties

E-mail beantwoorden (V2)

Deze bewerking wordt gebruikt om een specifiek e-mailbericht te beantwoorden.

E-mail beantwoorden [AFGESCHAFT]

Deze actie is afgeschaft. Gebruik in plaats daarvan E-mail beantwoorden (V2 ).

Deze bewerking wordt gebruikt om een specifiek e-mailbericht te beantwoorden.

E-mail verplaatsen naar prullenbak

Deze bewerking wordt gebruikt om een specifieke e-mail naar de prullenbak te verplaatsen.

E-mail verwijderen

Deze bewerking wordt gebruikt om een specifiek e-mailbericht permanent te verwijderen.

E-mail verzenden (V2)

Deze bewerking wordt gebruikt om een e-mailbericht te verzenden naar specifieke geadresseerden.

E-mail verzenden [AFGESCHAFT]

Deze actie is afgeschaft. Gebruik in plaats daarvan E-mail verzenden (V2 ).

Deze bewerking wordt gebruikt om een e-mailbericht te verzenden naar specifieke geadresseerden.

E-mailberichten zoeken

Met deze bewerking wordt gezocht naar e-mailberichten die voldoen aan de opgegeven criteria, de meest recente eerste.

E-maildetails ophalen

Met deze bewerking worden de details van een specifiek e-mailbericht opgehaald.

E-mail beantwoorden (V2)

Deze bewerking wordt gebruikt om een specifiek e-mailbericht te beantwoorden.

Parameters

Name Sleutel Vereist Type Description
Bericht-id
id True string

Id van het e-mailbericht dat moet worden beantwoord.

Tot
To email

Voorbeeld: recipient1@domain.com; recipient2@domain.com

CC
Cc email

Voorbeeld: recipient1@domain.com; recipient2@domain.com

BCC
Bcc email

Voorbeeld: recipient1@domain.com; recipient2@domain.com

Onderwerp
Subject string

E-mailonderwerp (indien leeg, het oorspronkelijke onderwerp dat wordt gebruikt).

Body
Body html

Inhoud van de e-mail.

Allen beantwoorden
ReplyAll boolean

Waar om alle geadresseerden te beantwoorden. (standaard: Onwaar)

Belang
Importance string

Kies een urgentie. (standaard: Normaal)

Naam
Name True string

Titel van de bijlage.

Content
ContentBytes True byte

Hoofdtekst van de bijlage.

Inhoudstype
ContentType string

Het type inhoud in de bijlage.

E-mail beantwoorden [AFGESCHAFT]

Deze actie is afgeschaft. Gebruik in plaats daarvan E-mail beantwoorden (V2 ).

Deze bewerking wordt gebruikt om een specifiek e-mailbericht te beantwoorden.

Parameters

Name Sleutel Vereist Type Description
Bericht-id
id True string

Id van het e-mailbericht dat moet worden beantwoord.

Tot
To email

Voorbeeld: recipient1@domain.com; recipient2@domain.com

CC
Cc email

Voorbeeld: recipient1@domain.com; recipient2@domain.com

BCC
Bcc email

Voorbeeld: recipient1@domain.com; recipient2@domain.com

Onderwerp
Subject string

E-mailonderwerp (indien leeg, het oorspronkelijke onderwerp dat wordt gebruikt).

Body
Body string

Inhoud van de e-mail.

Allen beantwoorden
ReplyAll boolean

Waar om alle geadresseerden te beantwoorden. (standaard: Onwaar)

Is HTML
IsHtml boolean

Waar als u het antwoord als HTML wilt verzenden. (standaard: Waar)

Belang
Importance string

Kies een urgentie. (standaard: Normaal)

Naam
Name True string

Titel van de bijlage.

Content
ContentBytes True byte

Hoofdtekst van de bijlage.

Inhoudstype
ContentType string

Het type inhoud in de bijlage.

E-mail verplaatsen naar prullenbak

Deze bewerking wordt gebruikt om een specifieke e-mail naar de prullenbak te verplaatsen.

Parameters

Name Sleutel Vereist Type Description
Bericht-id
id True string

Id van het e-mailbericht om naar de prullenbak te gaan.

E-mail verwijderen

Deze bewerking wordt gebruikt om een specifiek e-mailbericht permanent te verwijderen.

Parameters

Name Sleutel Vereist Type Description
Bericht-id
id True string

Id van het e-mailbericht dat u wilt verwijderen.

E-mail verzenden (V2)

Deze bewerking wordt gebruikt om een e-mailbericht te verzenden naar specifieke geadresseerden.

Parameters

Name Sleutel Vereist Type Description
Tot
To True email

Een lijst met geldige e-mailadressen gescheiden door een puntkomma of een komma.

CC
Cc email

Een lijst met geldige e-mailadressen gescheiden door een puntkomma of een komma.

BCC
Bcc email

Een lijst met geldige e-mailadressen gescheiden door een puntkomma of een komma.

Onderwerp
Subject string

Onderwerp van de uitgaande e-mail.

Body
Body html

Hoofdtekst van de uitgaande e-mail.

Belang
Importance string

Urgentie die is gekoppeld aan het e-mailbericht.

Naam
Name True string

Titel van de bijlage.

Content
ContentBytes True byte

Hoofdtekst van de bijlage.

Inhoudstype
ContentType string

Het type inhoud in de bijlage.

E-mail verzenden [AFGESCHAFT]

Deze actie is afgeschaft. Gebruik in plaats daarvan E-mail verzenden (V2 ).

Deze bewerking wordt gebruikt om een e-mailbericht te verzenden naar specifieke geadresseerden.

Parameters

Name Sleutel Vereist Type Description
Tot
To True email

Een lijst met geldige e-mailadressen gescheiden door een puntkomma of een komma.

CC
Cc email

Een lijst met geldige e-mailadressen gescheiden door een puntkomma of een komma.

BCC
Bcc email

Een lijst met geldige e-mailadressen gescheiden door een puntkomma of een komma.

Onderwerp
Subject string

Onderwerp van de uitgaande e-mail.

Body
Body string

Hoofdtekst van de uitgaande e-mail.

Is HTML
IsHtml boolean

Waar als u de e-mail als HTML wilt verzenden. (standaard: Waar)

Belang
Importance string

Urgentie die is gekoppeld aan het e-mailbericht.

Naam
Name True string

Titel van de bijlage.

Content
ContentBytes True byte

Hoofdtekst van de bijlage.

Inhoudstype
ContentType string

Het type inhoud in de bijlage.

E-mailberichten zoeken

Met deze bewerking wordt gezocht naar e-mailberichten die voldoen aan de opgegeven criteria, de meest recente eerste.

Parameters

Name Sleutel Vereist Type Description
Zoekquery
searchQuery string

Gmail-zoekquery, bijvoorbeeld 'groter:5M is:ongelezen'.

Etiket
label string

Haal e-mailberichten op met dit label.

Tot
to email

E-mailberichten ophalen die naar dit adres worden verzonden.

Van
from email

E-mailberichten ophalen die van dit adres zijn verzonden.

Onderwerp
subject string

E-mailberichten ophalen waarvan het onderwerp deze tekst bevat.

Belang
importance string

E-mailberichten ophalen met dit belang.

Speelde
starred string

Haal e-mailberichten met deze sterstatus op.

Heeft bijlagen
fetchOnlyWithAttachments boolean

Als deze optie is ingesteld op waar, worden alleen e-mailberichten met bijlagen opgehaald.

Bijlagen opnemen
includeAttachments boolean

Als deze optie is ingesteld op true, worden bijlagen ook samen met elke e-mail opgehaald.

Maximum aantal resultaten
maxResults integer

Maximum aantal e-mailberichten dat op één pagina moet worden geretourneerd.

Paginatoken
pageToken string

Token waarmee de pagina wordt geïdentificeerd die moet worden opgehaald. Laat leeg om de eerste pagina op te halen.

Retouren

Eén pagina met e-mailberichten.

Body
EmailPage

E-maildetails ophalen

Met deze bewerking worden de details van een specifiek e-mailbericht opgehaald.

Parameters

Name Sleutel Vereist Type Description
Bericht-id
id True string

Unieke id van het e-mailbericht.

Bijlagen opnemen
includeAttachments boolean

Als deze optie is ingesteld op true, worden bijlagen ook samen met het e-mailbericht opgehaald.

Retouren

Details die zijn gekoppeld aan een specifiek e-mailbericht.

Triggers

Wanneer er een nieuwe e-mail binnenkomt

Deze bewerking wordt geactiveerd wanneer een nieuwe e-mail die overeenkomt met de opgegeven criteria binnenkomt.

Wanneer er een nieuwe e-mail binnenkomt

Deze bewerking wordt geactiveerd wanneer een nieuwe e-mail die overeenkomt met de opgegeven criteria binnenkomt.

Parameters

Name Sleutel Vereist Type Description
Etiket
label string

Kies een label (standaard: Postvak IN).

Tot
to email

Een lijst met geldige e-mailadressen gescheiden door een puntkomma of een komma.

Van
from email

Voorbeeld: Afzender1 | sender2@domain.com.

Onderwerp
subject string

Tekenreeks die moet worden gezocht in het onderwerp.

Belang
importance string

Waar als het e-mailbericht belangrijk moet zijn. (standaard: Alle).

Speelde
starred string

Waar als het e-mailbericht moet worden gemarkeerd. (standaard: Alle).

Heeft bijlagen
fetchOnlyWithAttachments boolean

Is waar om alleen e-mailberichten met bijlagen op te halen.

Bijlagen opnemen
includeAttachments boolean

Waar om bijlagen samen met het e-mailbericht op te halen.

Retouren

Details die zijn gekoppeld aan een specifiek e-mailbericht.

Definities

EmailPage

Eén pagina met e-mailberichten.

Name Pad Type Description
E-mailberichten
Emails array of DetailedReceiveMessage

E-mailberichten op deze pagina.

Token volgende pagina
NextPageToken string

Token dat wordt gebruikt om de volgende pagina met e-mailberichten op te halen. Leeg als er geen pagina's meer zijn.

DetailedReceiveMessage

Details die zijn gekoppeld aan een specifiek e-mailbericht.

Name Pad Type Description
Van
From email

E-mailadres van waaruit het bericht is verzonden.

Naam van afzender
SenderName string

De naam van de afzender van e-mail

Tot
To email

E-mailadres waarnaar het bericht is verzonden.

CC
Cc email

E-mailadressen in het veld CC.

BCC
Bcc email

E-mailadressen in het veld BCC.

Onderwerp
Subject string

Onderwerp of onderwerp dat is gekoppeld aan het e-mailbericht.

Body
Body string

Inhoud van het e-mailbericht.

Fragment
Snippet string

Een kort deel van de berichttekst.

Label-id's
LabelIds array of string

Lijst met labels die zijn gekoppeld aan het e-mailbericht.

Ontvangen Date-Time
DateTimeReceived date-time

Voorbeeld:2017-05-03T20:08:57+00:00

Geschatte grootte
EstimatedSize integer

Geschatte grootte in bytes van het bericht.

Is Lezen?
IsRead boolean

Waar als het bericht wordt gelezen; anders onwaar.

Is HTML
IsHtml boolean

Waar als het bericht de HTML-indeling heeft.

Heeft bijlagen
HasAttachments boolean

Waar als het bericht bijlagen bevat.

Bijlagen
Attachments array of Attachment

Lijst met bijlagen bij het e-mailbericht.

Bericht-id
Id string

De onveranderbare id van het bericht.

Thread-id
ThreadId string

De id van de thread waartoe het bericht behoort.

Attachment

Eigenschappen van een e-mailbijlage.

Name Pad Type Description
Naam
Name string

Titel van de bijlage.

Content
ContentBytes byte

Hoofdtekst van de bijlage.

Inhoudstype
ContentType string

Het type inhoud in de bijlage.