Method: users.messages.insert

Bezpośrednio wstawia wiadomość tylko do skrzynki pocztowej tego użytkownika, podobnie jak IMAP APPEND, z pominięciem większości skanowania i klasyfikacji. Nie wysyła wiadomości.

Żądanie HTTP

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

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.
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.