Method: users.messages.import

Importuje wiadomość tylko do skrzynki pocztowej tego użytkownika, ze standardowym skanowaniem i klasyfikacją dostarczania e-maili podobną do odbierania przez SMTP. Ta metoda nie przeprowadza kontroli SPF, więc może nie działać w przypadku niektórych wiadomości spamowych, np. tych, które próbują podszywać się pod domeny. Ta metoda nie wysyła wiadomości. Pamiętaj, że maksymalny rozmiar wiadomości to 150 MB.

Żądanie HTTP

  • Identyfikator URI przesyłania w przypadku żądań przesyłania multimediów:
    POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages/import
  • Identyfikator URI metadanych w przypadku żądań dotyczących tylko metadanych:
    POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/import

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
userId

string

Adres e-mail użytkownika. Wartość specjalna me może służyć do wskazywania uwierzytelnionego użytkownika.

Parametry zapytania

Parametry
internalDateSource

enum (InternalDateSource)

Źródło wewnętrznej daty wiadomości w Gmailu.
neverMarkSpam

boolean

Zignoruj decyzję klasyfikatora spamu w Gmailu i nigdy nie oznaczaj tego e-maila jako SPAM w skrzynce pocztowej.
processForCalendar

boolean

Przetwarzanie zaproszeń z kalendarza w e-mailu i dodawanie wyodrębnionych spotkań do Kalendarza Google tego użytkownika.
deleted

boolean

Oznacz e-maila jako trwale usuniętego (nie jako przeniesionego do KOSZA) i widocznego tylko w Google Vault dla administratora Vault. Używane tylko w przypadku kont Google Workspace.

Treść żądania

Treść żądania zawiera wystąpienie elementu Message.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Message.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.insert

Więcej informacji znajdziesz w sekcji OAuth 2.0 Overview.