Method: users.messages.insert

Wstawia wiadomość bezpośrednio do skrzynki pocztowej tego użytkownika, podobnie jak w przypadku IMAP APPEND, pomijając większość skanowania i klasyfikacji. Nie wysyła wiadomości.

Żądanie HTTP

  • Identyfikator URI przesyłania – dotyczy żądań przesyłania multimediów:
    POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages
  • Identyfikator URI metadanych, w przypadku żądań tylko z metadanymi:
    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 daty wewnętrznej wiadomości w Gmailu.

deleted

boolean

Oznaczyć e-maila jako trwale usunięty (nie USUNĄTY) i widoczny tylko w Google Vault dla administratora Vault. Używany tylko na kontach 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 przewodniku dotyczącym autoryzacji.