Delen via

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 Ondersteuning voor Microsoft LogicApps
Ondersteuning voor Microsoft Power Automate
Ondersteuning voor Microsoft Power Apps
Connectormetagegevens
Uitgever Microsoft
Webpagina https://mail.google.com/mail/
Privacybeleid https://policies.google.com/privacy

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 Table Storage-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
API-aanroepen per verbinding 60 60 seconden
Werkeenheden per dag 90000 86400 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-maildetails ophalen

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

E-mail beantwoorden (V2)

Bewerkings-id:
ReplyToV2

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]

Bewerkings-id:
ReplyTo

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

Bewerkings-id:
TrashEmail

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

Bewerkings-id:
DeleteEmail

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)

Bewerkings-id:
SendEmailV2

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]

Bewerkings-id:
SendEmail

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-maildetails ophalen

Bewerkings-id:
GetEmail

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.

Body
DetailedReceiveMessage

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

Bewerkings-id:
OnNewEmail

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.

Body
DetailedReceiveMessage

Definities

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.