Udostępnij przez


Gmail

Gmail to internetowa usługa poczty e-mail firmy Google. Za pomocą łącznika Gmail można wykonywać akcje, takie jak wysyłanie lub odbieranie wiadomości e-mail oraz wyzwalanie przepływów na nowych wiadomościach e-mail.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Standard Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Standard Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate Standard Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name Microsoft
adres URL Obsługa usługi Microsoft LogicApps
Pomoc techniczna usługi Microsoft Power Automate
Obsługa usługi Microsoft Power Apps
Metadane łącznika
Publisher Microsoft
Witryna internetowa https://mail.google.com/mail/
Zasady ochrony prywatności https://policies.google.com/privacy

Uwierzytelnianie i korzystanie z własnej aplikacji

Łącznik Gmail obsługuje teraz wiele typów uwierzytelniania:

  • Użyj domyślnej aplikacji udostępnionej
  • Korzystanie z własnej aplikacji

Domyślna aplikacja udostępniona używa aplikacji klienckiej Google obsługiwanej przez firmę Microsoft. W takim przypadku po zalogowaniu się do konta Gmail zostanie wyświetlony monit o wyrażenie zgody na aplikację Microsoft Power Platform .

Za pomocą opcji "Przynieś własną aplikację" możesz użyć własnej aplikacji klienckiej Google OAuth zamiast aplikacji zarządzanej przez firmę Microsoft. Dzięki temu można kontrolować uprawnienia i włączać pewne ograniczenia dotyczące korzystania z łącznika.

Aby korzystać z własnej aplikacji klienckiej Google OAuth z łącznikiem Gmail, należy wykonać następujące czynności:

  1. Tworzenie aplikacji klienckiej OAuth przy użyciu konsoli interfejsu API firmy Google
  2. Korzystanie z aplikacji w łączniku Gmail

Tworzenie aplikacji klienckiej OAuth w usłudze Google

Aby utworzyć własną aplikację klienczą Google OAuth, musisz najpierw zalogować się do https://developer.google.comusługi . Przejdź do konsoli interfejsu API firmy Google — w której możesz zarządzać dostępem do interfejsów API Google i utworzyć aplikację OAuth. Ten proces został wyjaśniony w przewodniku deweloperów interfejsu API Gmail firmy Google. Firma Google udostępnia narzędzie do konfigurowania , które przeprowadzi Cię przez proces tworzenia projektu, włączenia interfejsu API Gmail dla projektu i utworzenia aplikacji klienckiej OAuth oraz poświadczeń dla niego. Oto kilka informacji, które przydają się podczas przechodzenia przez narzędzie:

  • W razie potrzeby przeczytaj i zaakceptuj warunki użytkowania usługi.
  • Wybierz istniejący projekt lub narzędzie utworzy nowy o nazwie "Mój projekt".
  • Narzędzie włączy interfejs API Gmail w projekcie.
  • Narzędzie spróbuje znaleźć potrzebny typ poświadczeń. Musisz pobrać aplikację kliencka OAuth.
    • Wybierz interfejs API gmaila dla używanego interfejsu API (jeśli nie został jeszcze wybrany).
    • Wybierz pozycję Serwer sieci Web , z którego będziesz wywoływać interfejs API.
    • Wybierz pozycję Dane użytkownika dla danych, do których będziesz uzyskiwać dostęp.
  • Narzędzie przeprowadzi Cię przez ekran konfigurowania zgody OAuth.
    • Wybierz typ użytkownika (wewnętrzny lub zewnętrzny). Jeśli używasz konta użytkownika Gmail, nie możesz wybrać pozycji Wewnętrzne.
    • Podaj nazwę i opcjonalnie logo aplikacji.
    • Kliknij pozycję Dodaj zakres i dodaj zakres Gmail (https://mail.google.com).

      Uwaga / Notatka

      W zależności od potrzeb użycia możesz wybrać odpowiedni podzbiór zakresów uprawnień tutaj.

    • Dodaj azure-apim.net jako jedną z autoryzowanych domen.

      Uwaga / Notatka

      Jest to domena, w której jest hostowany łącznik Gmail, zgodnie z definicją w tym miejscu.

    • Opcjonalnie podaj inne informacje.
  • Narzędzie umożliwia zdefiniowanie i dodanie poświadczeń klienta OAuth 2.0.
    • Podaj nazwę aplikacji klienckiej OAuth.
    • Dodaj "https://global.consent.azure-apim.net/redirect" dla identyfikatora URI przekierowania.

Po zakończeniu przejdź do utworzonego klienta OAuth na stronie Poświadczenia. Identyfikator klienta i klucz tajny klienta aplikacji. Teraz możesz użyć tych wartości w połączeniu gmaila.

Klient google OAuth Klienta Google OAuth

Korzystanie z własnej aplikacji w łączniku Gmail

Po utworzeniu aplikacji klienckiej Google OAuth można jej użyć podczas tworzenia połączenia Gmail.

  • Wybierz pozycję Przynieś własną aplikację.
  • Określ wartości Identyfikator klienta i Klucz tajny klienta z aplikacji.

Kliknij pozycję Zaloguj się, aby zalogować się do konta Gmail. Spowoduje to wyświetlenie monitu o zalogowanie się do konta Gmail, a następnie autoryzowanie dostępu do aplikacji Google utworzonej powyżej.

Znane problemy i ograniczenia

Ograniczenia wyzwalacza dla dużej liczby przychodzących wiadomości e-mail

Wyzwalacz Po nadejściu nowej wiadomości e-mail może pominąć wiadomości e-mail, jeśli otrzymujesz więcej niż 300 wiadomości e-mail na 30 sekund. Rozważ skonfigurowanie przepływu przy użyciu dodatkowych parametrów filtru, aby zmniejszyć liczbę wiadomości e-mail.

Wyzwalacz Po nadejściu nowej wiadomości e-mail może sporadycznie pomijać wiadomości e-mail z załącznikami, jeśli używasz konta usługi Google Workspace (dawniej G Suite). Dzieje się tak, ponieważ w niektórych przypadkach przetwarzanie wiadomości e-mail przez interfejs API gmaila (prawdopodobnie ze względu na skanowanie zabezpieczeń załączników), dlatego wiadomości e-mail są odbierane z pewnym opóźnieniem.

Aby obejść ten problem, spróbuj wykonać następujące czynności:

  • Użyj małych wiadomości e-mail (bez załączników), spróbuj wysłać je nie tak często

  • Użyj innego konta Gmail użytkownika i skonfiguruj automatyczne przekazywanie z konta obszaru roboczego Google do tego nowego konta Gmail użytkownika. Skonfiguruj wyzwalacz dla tego nowego konta. Ponieważ jest to konto konsumenta, uważamy, że opóźnienie zostanie zminimalizowane, a wyzwalacz nie pominie takich wiadomości e-mail.

  • Użyj łącznika niestandardowego do interfejsuAPI ListMessage z parametrem q :

    • Utwórz akcję, aby wyświetlić listę komunikatów z ostatnich 5 minut. Można to zrobić przy użyciu q parametru . Przykład wartości parametru qafter:1649457986. Jako dane wejściowe akcji należy podać current time - 5min czas epoki.

      • 1649457986 to czas epoki, który reprezentuje "piątek, 8 kwietnia 2022 r. 3:46:26 GMT-07:00".
    • Sprawdź wartość nextPageToken z odpowiedzi, aż będzie pusta. Jeśli nie jest pusty, musisz wywołać ten sam interfejs API z wartością pageToken parametru ustawioną na wartość nextPageToken z odpowiedzi. Można to zrobić na przykład za pomocą pętli "Until".

    • Odfiltruj te identyfikatory komunikatów, które zostały już przetworzone w poprzednich uruchomieniach (np. możesz użyć łącznika usługi Azure Table Storage do przechowywania już przetworzonych identyfikatorów)

    • Użyj akcji Pobierz szczegóły wiadomości e-mail , aby uzyskać zawartość wiadomości e-mail według identyfikatora

Używanie łącznika Gmail z kontami usługi Gmail dla użytkowników

Zgodnie z zasadami zabezpieczeń i prywatności firmy Google klienci korzystający z kont Gmail konsumentów (konta kończące się @gmail.com i @googlemail.com) mogą łączyć się tylko z ograniczonym zestawem usług w usługach Power Automate i Logic Apps). Ta zmiana nie wpływa na klientów korzystających z usługi Google Workspace (dawniej G Suite). Jeśli musisz użyć łącznika Gmail z usługami, które nie zostały określone na poniższej liście, musisz zarejestrować własny identyfikator aplikacji w usłudze Google. Poniżej znajduje się lista bieżących zatwierdzonych usług, należy pamiętać, że ta lista podlega zmianie w przyszłości zgodnie z zasadami Firmy Google:

  • Usługi Google: Gmail, Kalendarz Google, Kontakty Google, Dysk Google, Arkusze Google, Google Tasks
  • Wbudowane akcje i wyzwalacze: Control, AI Builder, Data Operations, Date Time, Number Functions, Power Virtual Agents, Power Apps, Request, Schedule, Text Functions, Variables, Flow button, Location
  • Ograniczony zestaw usług firmy Microsoft: OneDrive, Sharepoint, Excel, Dynamics, Microsoft Teams, Office 365, SQL, SFTP i FTP

W usłudze Power Automate, jeśli utworzysz przepływ z niezgodną usługą, przepływ zostanie zapisany w stanie wyłączonym.

Obliczanie jednostek roboczych

Łącznik ma limit ograniczania przepustowości (zobacz tutaj) liczby jednostek roboczych, które mogą być używane w ciągu dnia.

Poniżej przedstawiono logikę obliczania tych jednostek roboczych dla każdej operacji:

  • Po nadejściu nowej wiadomości e-mail wyzwalacz: 10 + (5 * załącznikówCount);
    • Jeśli wyzwalacz zwraca nową wiadomość e-mail: 5 jednostek, aby wyświetlić listę wiadomości + 5 jednostek, aby uzyskać liczbę załączników i 5 jednostek wiadomości.
    • Jeśli wyzwalacz nie zwraca nowej wiadomości e-mail: 5 jednostek do wyświetlenia listy wiadomości.
  • Akcja Wyślij wiadomość e-mail (wersja 2): 100 jednostek.
  • Akcja Odpowiedz na adres e-mail (wersja 2): 105 + (5 * załącznikówCount);
    • 5 jednostek w celu pobrania oryginalnej wiadomości + 100 jednostek w celu wysłania wiadomości odpowiedzi + 5 jednostek * liczba załączników wbudowanych w oryginalnej wiadomości.
  • Dla wszystkich innych akcji: 10 jednostek.

Szczegółowe informacje o konektorze

Aby uzyskać więcej informacji na temat łącznika, zobacz szczegółową sekcję.

Ogólne limity

Name Wartość
Maksymalny rozmiar poczty (w MB) 35
Maksymalny rozmiar załącznika (w MB) 30

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:

Korzystanie z własnej aplikacji Zaloguj się przy użyciu własnej aplikacji Google. Aby uzyskać więcej informacji, zobacz https://docs.microsoft.com/connectors/gmail/#authentication-and-bring-your-own-application. Wszystkie regiony Nie można udostępniać
Użyj domyślnej aplikacji udostępnionej Zaloguj się przy użyciu standardowej aplikacji Google. Wszystkie regiony Nie można udostępniać
Domyślne [PRZESTARZAŁE] Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami. Wszystkie regiony Nie można udostępniać

Korzystanie z własnej aplikacji

Identyfikator uwierzytelniania: byoa

Dotyczy: wszystkie regiony

Zaloguj się przy użyciu własnej aplikacji Google. Aby uzyskać więcej informacji, zobacz https://docs.microsoft.com/connectors/gmail/#authentication-and-bring-your-own-application.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Name Typ Description Wymagane
ID klienta ciąg Identyfikator klienta (lub aplikacji) aplikacji Google Prawda
Tajemnica klienta securestring Wpis tajny klienta aplikacji Google Prawda

Użyj domyślnej aplikacji udostępnionej

Identyfikator uwierzytelniania: shared-application

Dotyczy: wszystkie regiony

Zaloguj się przy użyciu standardowej aplikacji Google.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Domyślne [PRZESTARZAŁE]

Dotyczy: wszystkie regiony

Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 60 60 sekund
Jednostki robocze dziennie 90000 86400 sekund

Akcje

Odpowiedz na adres e-mail (wersja 2)

Ta operacja służy do odpowiadania na określoną wiadomość e-mail.

Odpowiedz na adres e-mail [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj opcji Odpowiedz na adres e-mail (wersja 2).

Ta operacja służy do odpowiadania na określoną wiadomość e-mail.

Pobieranie szczegółów wiadomości e-mail

Ta operacja pobiera szczegóły określonej wiadomości e-mail.

Przenoszenie wiadomości e-mail do kosza

Ta operacja służy do przenoszenia określonej wiadomości e-mail do kosza.

Usuwanie wiadomości e-mail

Ta operacja służy do trwałego usuwania określonej wiadomości e-mail.

Wyślij wiadomość e-mail (wersja 2)

Ta operacja służy do wysyłania wiadomości e-mail do określonych adresatów.

Wyślij wiadomość e-mail [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj polecenia Wyślij wiadomość e-mail (wersja 2).

Ta operacja służy do wysyłania wiadomości e-mail do określonych adresatów.

Odpowiedz na adres e-mail (wersja 2)

Ta operacja służy do odpowiadania na określoną wiadomość e-mail.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator komunikatu
id True string

Identyfikator wiadomości e-mail do odpowiadania.

Do
To email

Przykład: recipient1@domain.com; recipient2@domain.com

napis
Cc email

Przykład: recipient1@domain.com; recipient2@domain.com

UDW
Bcc email

Przykład: recipient1@domain.com; recipient2@domain.com

Temat
Subject string

Temat wiadomości e-mail (jeśli jest pusty, użyty oryginalny temat).

Body
Body html

Treść wiadomości e-mail.

Odpowiedz wszystkim
ReplyAll boolean

Prawda, aby odpowiedzieć wszystkim adresatom. (wartość domyślna: Fałsz)

Ważność
Importance string

Wybierz ważność. (ustawienie domyślne: Normalny)

Name
Name True string

Tytuł załącznika.

Content
ContentBytes True byte

Treść załącznika.

Typ zawartości
ContentType string

Typ zawartości w załączniku.

Odpowiedz na adres e-mail [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj opcji Odpowiedz na adres e-mail (wersja 2).

Ta operacja służy do odpowiadania na określoną wiadomość e-mail.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator komunikatu
id True string

Identyfikator wiadomości e-mail do odpowiadania.

Do
To email

Przykład: recipient1@domain.com; recipient2@domain.com

napis
Cc email

Przykład: recipient1@domain.com; recipient2@domain.com

UDW
Bcc email

Przykład: recipient1@domain.com; recipient2@domain.com

Temat
Subject string

Temat wiadomości e-mail (jeśli jest pusty, użyty oryginalny temat).

Body
Body string

Treść wiadomości e-mail.

Odpowiedz wszystkim
ReplyAll boolean

Prawda, aby odpowiedzieć wszystkim adresatom. (wartość domyślna: Fałsz)

To HTML
IsHtml boolean

Wartość True, aby wysłać odpowiedź w formacie HTML. (wartość domyślna: Prawda)

Ważność
Importance string

Wybierz ważność. (ustawienie domyślne: Normalny)

Name
Name True string

Tytuł załącznika.

Content
ContentBytes True byte

Treść załącznika.

Typ zawartości
ContentType string

Typ zawartości w załączniku.

Pobieranie szczegółów wiadomości e-mail

Ta operacja pobiera szczegóły określonej wiadomości e-mail.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator komunikatu
id True string

Unikatowy identyfikator wiadomości e-mail.

Dołączanie załączników
includeAttachments boolean

W przypadku ustawienia wartości true załączniki również zostaną pobrane wraz z wiadomością e-mail.

Zwraca

Szczegóły skojarzone z określoną wiadomością e-mail.

Przenoszenie wiadomości e-mail do kosza

Ta operacja służy do przenoszenia określonej wiadomości e-mail do kosza.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator komunikatu
id True string

Identyfikator wiadomości e-mail, aby przejść do kosza.

Usuwanie wiadomości e-mail

Ta operacja służy do trwałego usuwania określonej wiadomości e-mail.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator komunikatu
id True string

Identyfikator wiadomości e-mail do usunięcia.

Wyślij wiadomość e-mail (wersja 2)

Ta operacja służy do wysyłania wiadomości e-mail do określonych adresatów.

Parametry

Nazwa Klucz Wymagane Typ Opis
Do
To True email

Lista prawidłowych adresów e-mail rozdzielonych średnikami lub przecinkami.

napis
Cc email

Lista prawidłowych adresów e-mail rozdzielonych średnikami lub przecinkami.

UDW
Bcc email

Lista prawidłowych adresów e-mail rozdzielonych średnikami lub przecinkami.

Temat
Subject string

Temat wychodzącej wiadomości e-mail.

Body
Body html

Treść wychodzącej wiadomości e-mail.

Ważność
Importance string

Ważność skojarzona z wiadomością e-mail.

Name
Name True string

Tytuł załącznika.

Content
ContentBytes True byte

Treść załącznika.

Typ zawartości
ContentType string

Typ zawartości w załączniku.

Wyślij wiadomość e-mail [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj polecenia Wyślij wiadomość e-mail (wersja 2).

Ta operacja służy do wysyłania wiadomości e-mail do określonych adresatów.

Parametry

Nazwa Klucz Wymagane Typ Opis
Do
To True email

Lista prawidłowych adresów e-mail rozdzielonych średnikami lub przecinkami.

napis
Cc email

Lista prawidłowych adresów e-mail rozdzielonych średnikami lub przecinkami.

UDW
Bcc email

Lista prawidłowych adresów e-mail rozdzielonych średnikami lub przecinkami.

Temat
Subject string

Temat wychodzącej wiadomości e-mail.

Body
Body string

Treść wychodzącej wiadomości e-mail.

To HTML
IsHtml boolean

Wartość True, aby wysłać wiadomość e-mail jako kod HTML. (wartość domyślna: Prawda)

Ważność
Importance string

Ważność skojarzona z wiadomością e-mail.

Name
Name True string

Tytuł załącznika.

Content
ContentBytes True byte

Treść załącznika.

Typ zawartości
ContentType string

Typ zawartości w załączniku.

Wyzwalacze

Po nadejściu nowej wiadomości e-mail

Ta operacja jest wyzwalana po nadejściu nowej wiadomości e-mail zgodnej z określonymi kryteriami.

Po nadejściu nowej wiadomości e-mail

Ta operacja jest wyzwalana po nadejściu nowej wiadomości e-mail zgodnej z określonymi kryteriami.

Parametry

Nazwa Klucz Wymagane Typ Opis
Etykieta
label string

Wybierz etykietę (domyślna: Skrzynka odbiorcza).

Do
to email

Lista prawidłowych adresów e-mail rozdzielonych średnikami lub przecinkami.

Źródło
from email

Przykład: Sender1 | sender2@domain.com.

Temat
subject string

Ciąg do wyszukania w temacie.

Ważność
importance string

Wartość True, jeśli wiadomość e-mail powinna być ważna. (ustawienie domyślne: Wszystkie).

Gwiazda
starred string

Wartość True, jeśli wiadomość e-mail powinna zostać wyświetlona. (ustawienie domyślne: Wszystkie).

Ma załączniki
fetchOnlyWithAttachments boolean

Wartość True, aby pobrać tylko wiadomości e-mail z załącznikami.

Dołączanie załączników
includeAttachments boolean

Wartość True w celu pobrania załączników wraz z wiadomością e-mail.

Zwraca

Szczegóły skojarzone z określoną wiadomością e-mail.

Definicje

DetailedReceiveMessage

Szczegóły skojarzone z określoną wiadomością e-mail.

Nazwa Ścieżka Typ Opis
Źródło
From email

Adres e-mail, z którego wysłano wiadomość.

Nazwa nadawcy
SenderName string

Nazwa nadawcy wiadomości e-mail

Do
To email

Adres e-mail, do którego wysłano wiadomość.

napis
Cc email

Adresy e-mail zawarte w polu CC.

UDW
Bcc email

Adresy e-mail zawarte w polu BCC.

Temat
Subject string

Temat lub temat skojarzony z wiadomością e-mail.

Body
Body string

Zawartość wiadomości e-mail.

Fragment
Snippet string

Krótka część tekstu wiadomości.

Identyfikatory etykiet
LabelIds array of string

Lista etykiet skojarzonych z wiadomością e-mail.

Odebrano Date-Time
DateTimeReceived date-time

Przykład: 2017-05-03T20:08:57+00:00

Szacowany rozmiar
EstimatedSize integer

Szacowany rozmiar w bajtach komunikatu.

Czy jest odczytywany?
IsRead boolean

Prawda, jeśli komunikat jest odczytywany; w przeciwnym razie wartość false.

To HTML
IsHtml boolean

Wartość True, jeśli komunikat ma format HTML.

Ma załączniki
HasAttachments boolean

Prawda, jeśli komunikat zawiera załączniki.

Załączniki
Attachments array of Attachment

Lista załączników do wiadomości e-mail.

Identyfikator komunikatu
Id string

Niezmienny identyfikator wiadomości.

Identyfikator wątku
ThreadId string

Identyfikator wątku, do którego należy komunikat.

Attachment

Właściwości załącznika wiadomości e-mail.

Nazwa Ścieżka Typ Opis
Name
Name string

Tytuł załącznika.

Content
ContentBytes byte

Treść załącznika.

Typ zawartości
ContentType string

Typ zawartości w załączniku.