Gmail API

Interfejs Gmail API pozwala wyświetlać dane skrzynki pocztowej Gmail, takie jak wątki, wiadomości czy etykiety, i zarządzać nimi.

Usługa: gmail.googleapis.com

Do korzystania z tej usługi zalecamy używanie bibliotek klienta udostępnionych przez Google. Jeśli aplikacja musi używać własnych bibliotek do wywoływania tej usługi, podczas wysyłania żądań do interfejsu API używaj tych informacji.

Dokument Discovery

Dokument Discovery to czytelna dla komputera specyfikacja opisująca interfejsy API REST i korzystanie z nich. Służy do tworzenia bibliotek klienta, wtyczek IDE i innych narzędzi, które współpracują z interfejsami API Google. Jedna usługa może udostępniać wiele dokumentów opisujących. Ta usługa dostarcza następujący dokument opisujący interfejs API:

Punkt końcowy usługi

Punkt końcowy usługi to podstawowy adres URL, który określa adres sieciowy usługi interfejsu API. Jedna usługa może mieć wiele punktów końcowych. Ta usługa ma następujący punkt końcowy usługi i wszystkie poniższe identyfikatory URI odnoszą się do tego punktu końcowego usługi:

  • https://gmail.googleapis.com

Zasób REST: v1.users

Metody
getProfile GET /gmail/v1/users/{userId}/profile
Pobiera profil Gmaila bieżącego użytkownika.
stop POST /gmail/v1/users/{userId}/stop
Nie otrzymuj już powiadomień push dla danej skrzynki pocztowej użytkownika.
watch POST /gmail/v1/users/{userId}/watch
Skonfiguruj lub zaktualizuj zegarek z powiadomieniem push w danej skrzynce pocztowej użytkownika.

Zasób REST: v1.users.drafts

Metody
create POST /gmail/v1/users/{userId}/drafts
POST /upload/gmail/v1/users/{userId}/drafts
Tworzy nową wersję roboczą z etykietą DRAFT.
delete DELETE /gmail/v1/users/{userId}/drafts/{id}
Natychmiast i trwale usuwa określoną wersję roboczą.
get GET /gmail/v1/users/{userId}/drafts/{id}
Pobiera określoną wersję roboczą.
list GET /gmail/v1/users/{userId}/drafts
Wyświetla wersje robocze w skrzynce pocztowej użytkownika.
send POST /gmail/v1/users/{userId}/drafts/send
POST /upload/gmail/v1/users/{userId}/drafts/send
Wysyła konkretną, istniejącą wersję roboczą do adresatów w nagłówkach To, Cc i Bcc.
update PUT /gmail/v1/users/{userId}/drafts/{id}
PUT /upload/gmail/v1/users/{userId}/drafts/{id}
Zastępuje treść wersji roboczej.

Zasób REST: v1.users.history

Metody
list GET /gmail/v1/users/{userId}/history
Zawiera historię wszystkich zmian w danej skrzynce pocztowej.

Zasób REST: v1.users.labels

Metody
create POST /gmail/v1/users/{userId}/labels
Utworzy nową etykietę.
delete DELETE /gmail/v1/users/{userId}/labels/{id}
Natychmiast i trwale usunie określoną etykietę oraz ze wszystkich wiadomości i wątków, do których została zastosowana.
get GET /gmail/v1/users/{userId}/labels/{id}
Pobiera określoną etykietę.
list GET /gmail/v1/users/{userId}/labels
Zawiera listę wszystkich etykiet w skrzynce pocztowej użytkownika.
patch PATCH /gmail/v1/users/{userId}/labels/{id}
Zastosuj poprawkę do określonej etykiety.
update PUT /gmail/v1/users/{userId}/labels/{id}
Aktualizuje określoną etykietę.

Zasób REST: v1.users.messages

Metody
batchDelete POST /gmail/v1/users/{userId}/messages/batchDelete
Usuwa wiele wiadomości według identyfikatora.
batchModify POST /gmail/v1/users/{userId}/messages/batchModify
Modyfikuje etykiety w określonych wiadomościach.
delete DELETE /gmail/v1/users/{userId}/messages/{id}
Natychmiast i trwale usuwa określoną wiadomość.
get GET /gmail/v1/users/{userId}/messages/{id}
Pobiera wskazaną wiadomość.
import POST /gmail/v1/users/{userId}/messages/import
POST /upload/gmail/v1/users/{userId}/messages/import
Importuje wiadomości tylko do skrzynki pocztowej tego użytkownika, korzystając ze standardowego skanowania i klasyfikacji dostarczania poczty e-mail podobnej do odbierania przez SMTP.
insert POST /gmail/v1/users/{userId}/messages
POST /upload/gmail/v1/users/{userId}/messages
Bezpośrednio wstawia wiadomość tylko do skrzynki pocztowej tego użytkownika, podobnie jak IMAP APPEND, pomijając większość skanowania i klasyfikacji.
list GET /gmail/v1/users/{userId}/messages
Zawiera listę wiadomości w skrzynce pocztowej użytkownika.
modify POST /gmail/v1/users/{userId}/messages/{id}/modify
Modyfikuje etykiety w określonej wiadomości.
send POST /gmail/v1/users/{userId}/messages/send
POST /upload/gmail/v1/users/{userId}/messages/send
Wysyła określoną wiadomość do adresatów w nagłówkach To, Cc i Bcc.
trash POST /gmail/v1/users/{userId}/messages/{id}/trash
Przeniesienie określonej wiadomości do kosza.
untrash POST /gmail/v1/users/{userId}/messages/{id}/untrash
Usuwa określoną wiadomość z kosza.

Zasób REST: v1.users.messages.attachments

Metody
get GET /gmail/v1/users/{userId}/messages/{messageId}/attachments/{id}
Pobiera określony załącznik wiadomości.

Zasób REST: v1.users.settings

Metody
getAutoForwarding GET /gmail/v1/users/{userId}/settings/autoForwarding
Pobiera ustawienie automatycznego przekazywania dla określonego konta.
getImap GET /gmail/v1/users/{userId}/settings/imap
Pobiera ustawienia IMAP.
getLanguage GET /gmail/v1/users/{userId}/settings/language
Pobiera ustawienia języka.
getPop GET /gmail/v1/users/{userId}/settings/pop
Pobiera ustawienia POP.
getVacation GET /gmail/v1/users/{userId}/settings/vacation
Pobiera ustawienia wiadomości o nieobecności.
updateAutoForwarding PUT /gmail/v1/users/{userId}/settings/autoForwarding
Aktualizuje ustawienie automatycznego przekazywania dla określonego konta.
updateImap PUT /gmail/v1/users/{userId}/settings/imap
Aktualizuje ustawienia IMAP.
updateLanguage PUT /gmail/v1/users/{userId}/settings/language
Aktualizuje ustawienia języka.
updatePop PUT /gmail/v1/users/{userId}/settings/pop
Aktualizuje ustawienia POP.
updateVacation PUT /gmail/v1/users/{userId}/settings/vacation
Aktualizuje ustawienia wiadomości o nieobecności.

Zasób REST: v1.users.settings.cse.identities

Metody
create POST /gmail/v1/users/{userId}/settings/cse/identities
Tworzy i konfiguruje tożsamość szyfrowania po stronie klienta, która jest upoważniona do wysyłania poczty z konta użytkownika.
delete DELETE /gmail/v1/users/{userId}/settings/cse/identities/{cseEmailAddress}
Usuwa tożsamość szyfrowania po stronie klienta.
get GET /gmail/v1/users/{userId}/settings/cse/identities/{cseEmailAddress}
Pobiera konfigurację tożsamości szyfrowania po stronie klienta.
list GET /gmail/v1/users/{userId}/settings/cse/identities
Wyświetla listę zaszyfrowanych tożsamości po stronie klienta dla uwierzytelnionego użytkownika.
patch PATCH /gmail/v1/users/{userId}/settings/cse/identities/{emailAddress}
Przypisuje inną parę kluczy do istniejącej tożsamości szyfrowania po stronie klienta.

Zasób REST: v1.users.settings.cse.keypars

Metody
create POST /gmail/v1/users/{userId}/settings/cse/keypairs
Utworzy i prześle łańcuch certyfikatów szyfrowania S/MIME kluczy publicznych po stronie klienta oraz metadane klucza prywatnego dla uwierzytelnionego użytkownika.
disable POST /gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:disable
Wyłącza parę kluczy szyfrowania po stronie klienta.
enable POST /gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:enable
Włącza parę kluczy szyfrowania po stronie klienta, która została wyłączona.
get GET /gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}
Pobiera istniejącą parę kluczy szyfrowania po stronie klienta.
list GET /gmail/v1/users/{userId}/settings/cse/keypairs
Wyświetla pary kluczy szyfrowania po stronie klienta dla uwierzytelnionego użytkownika.
obliterate POST /gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:obliterate
Trwale i natychmiast usunie parę kluczy szyfrowania po stronie klienta.

Zasób REST: v1.users.settings.delegates

Metody
create POST /gmail/v1/users/{userId}/settings/delegates
Dodaje przedstawiciela z stanem weryfikacji ustawionym bezpośrednio na accepted, bez wysyłania e-maila weryfikacyjnego.
delete DELETE /gmail/v1/users/{userId}/settings/delegates/{delegateEmail}
Usuwa określoną osobę z przekazanym dostępem (która może mieć dowolny stan weryfikacji) i unieważnia wszystkie próby przejścia weryfikacji, które mogły być wymagane.
get GET /gmail/v1/users/{userId}/settings/delegates/{delegateEmail}
Pobiera określonego przedstawiciela.
list GET /gmail/v1/users/{userId}/settings/delegates
Zawiera listę przedstawicieli z określonym kontem.

Zasób REST: v1.users.settings.filters

Metody
create POST /gmail/v1/users/{userId}/settings/filters
Tworzy filtr.
delete DELETE /gmail/v1/users/{userId}/settings/filters/{id}
Natychmiast i trwale usuwa określony filtr.
get GET /gmail/v1/users/{userId}/settings/filters/{id}
Pobiera filtr.
list GET /gmail/v1/users/{userId}/settings/filters
Wyświetla filtry wiadomości użytkownika Gmaila.

Zasób REST: v1.users.settings.forwardingAddresses

Metody
create POST /gmail/v1/users/{userId}/settings/forwardingAddresses
Utworzy adres do przekazywania dalej.
delete DELETE /gmail/v1/users/{userId}/settings/forwardingAddresses/{forwardingEmail}
Usuwa określony adres do przekazywania dalej i unieważnia wszelką wymaganą weryfikację.
get GET /gmail/v1/users/{userId}/settings/forwardingAddresses/{forwardingEmail}
Pobiera określony adres do przekazywania dalej.
list GET /gmail/v1/users/{userId}/settings/forwardingAddresses
Zawiera listę adresów do przekazywania poczty dla wybranego konta.

Zasób REST: v1.users.settings.sendAs

Metody
create POST /gmail/v1/users/{userId}/settings/sendAs
Tworzy niestandardowy alias „Od” nadawcy.
delete DELETE /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Usuwa określony alias wysyłania.
get GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Pobiera podany alias wysyłania.
list GET /gmail/v1/users/{userId}/settings/sendAs
Wyświetla aliasy wysyłania wysyłane na określonym koncie.
patch PATCH /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Poprawianie określonego aliasu wysyłania.
update PUT /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Aktualizuje alias wysyłania jako.
verify POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/verify
Wysyła e-maila weryfikacyjnego na podany alias adresu e-mail.

Zasób REST: v1.users.settings.sendAs.smimeInfo

Metody
delete DELETE /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}
Usuwa określoną konfigurację S/MIME dla określonego aliasu wysyłania.
get GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}
Pobiera podaną konfigurację S/MIME dla określonego aliasu wysyłania.
insert POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo
Wstaw (prześlij) daną konfigurację S/MIME w przypadku określonego aliasu wysyłania.
list GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo
Wyświetla listę konfiguracji S/MIME dla określonego aliasu wysyłania.
setDefault POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}/setDefault
Ustawia domyślną konfigurację S/MIME dla określonego aliasu wysyłania.

Zasób REST: v1.users.threads

Metody
delete DELETE /gmail/v1/users/{userId}/threads/{id}
Natychmiast i trwale usuwa określony wątek.
get GET /gmail/v1/users/{userId}/threads/{id}
Pobiera określony wątek.
list GET /gmail/v1/users/{userId}/threads
Wyświetla wątki w skrzynce pocztowej użytkownika.
modify POST /gmail/v1/users/{userId}/threads/{id}/modify
Modyfikuje etykiety zastosowane do wątku.
trash POST /gmail/v1/users/{userId}/threads/{id}/trash
Przeniesienie określonego wątku do kosza.
untrash POST /gmail/v1/users/{userId}/threads/{id}/untrash
Usuwa określony wątek z kosza.