Informacje o wersji interfejsu Gmail API

Ta strona zawiera informacje o wersji interfejsu Gmail API.

12 listopada 2019 r. Nowa implementacja message.import()

Wdrożono messages.import() przy użyciu wydajniejszej implementacji backendu. Nowa wersja jest zgodna z interfejsem API w poprzedniej implementacji, a wszystkie klienty automatycznie zaczęły korzystać z nowego interfejsu kilka tygodni temu. Nowy backend obsługuje efektywne wywołania message.import(), a klienci mogą teraz równolegle importować wiadomości, aby osiągnąć większą przepustowość migracji. Koszt limitu metody interfejsu message.import() API został zmniejszony w celu odzwierciedlenia nowej wydajności.

7 lutego 2017 r. Filtrowanie typu historii pod kątem historii.list()

history.list() obsługuje teraz filtrowanie historii według typu.

30 listopada 2016 r. Nowa metoda wiadomości.batchModified()

messages.batchModify() to nowa metoda, która umożliwia modyfikowanie etykiet wielu wiadomości według identyfikatorów wiadomości w ramach jednej operacji zbiorczej.

1 listopada 2016 r.: nowy zakres metadanych

Gmail API obsługuje teraz nowy zakres gmail.metadata. Zakres ten zapewnia deweloperom dostęp do skrzynki pocztowej użytkownika, w tym do rekordów historii, etykiet i nagłówków, ale nie do treści e-maili ani załączników.

1 lipca 2016 roku: nowe punkty końcowe dla ustawień

Wprowadziliśmy kilka nowych punktów końcowych do zarządzania ustawieniami poczty. Szczegółowe informacje znajdziesz w tych przewodnikach:

• Aliasy wysyłane i podpisy
• Przekierowanie
• Filtry
• Wiadomość o nieobecności
• POP i IMAP

Ponadto drafts.list() ma nowy parametr żądania q, który ogranicza wyniki tylko do wiadomości odpowiadających określonemu zapytaniu.

25 lutego 2016 r.: nowa metoda wiadomości.batchDelete()

messages.batchDelete() to nowa metoda umożliwiająca usuwanie wielu wiadomości według identyfikatorów wiadomości w ramach jednej operacji zbiorczej.

13 stycznia 2016 roku: nowa opcja w wersji roboczej.list()

drafts.list() ma teraz nową opcję: IncludeSpamKosz, która służy do określania, czy odpowiedź powinna zawierać wersje robocze z etykietą SPAM lub TRASH. Obecnie ta opcja ma wartość Prawda, ale wkrótce planujemy ją zmienić na fałsz.

22 czerwca 2015 r.: labels from history.list()

history.list() zwraca teraz wszystkie bieżące Message.labelIds w ramach odpowiedzi w messagesAdded, messagesDeleted, labelsAdded i labelsRemoved, dzięki czemu można łatwo określić pełny stan e-maila przed zmianą i po niej.

18 czerwca 2015 r.: pole wiadomości wewnętrznej daty

Dodaliśmy nowe pole Message.internalDate, które pokazuje sygnaturę czasową utworzenia wiadomości w skrzynce pocztowej.

29 maja 2015 r.: powiadomienia push z interfejsu Gmail API

Interfejs Gmail API obsługuje teraz wysyłanie powiadomień push o aktualizacjach skrzynki pocztowej w celu zapewniania powiadomień na serwerze w czasie rzeczywistym bez konieczności ciągłego odpytywania. Korzystając z Cloud Pub/Sub, możesz teraz korzystać z webhooków, aby na przykład odbierać wywołania zwrotne o aktualizacjach. Dodatkowo te powiadomienia mogą być filtrowane według określonych etykiet Gmaila. Na początek zapoznaj się z przewodnikiem po powiadomieniach push.

31 marca 2015 roku: nowe zakresy dotyczące etykiet i wstawiania wiadomości

Wprowadziliśmy dwa nowe, bardziej szczegółowe zakresy ACL, aby lepiej chronić użytkowników i obsługiwać aplikacje, które nie potrzebują pełnego dostępu do danych skrzynki pocztowej:

• https://www.googleapis.com/auth/gmail.insert: umożliwia korzystanie tylko z messages.insert() i messages.import().
• https://www.googleapis.com/auth/gmail.labels: umożliwia korzystanie tylko z all label operations.

18 marca 2015 roku: nowe opcje wstawiania wiadomości

messages.insert() obsługuje teraz parametr żądania deleted i umożliwia ustawianie etykiet SENT i DRAFT.

25 lutego 2015 r.: więcej informacji z listy historii

history.list() zawiera teraz szczegóły typu zmiany w każdym rekordzie historii. Na przykład za pomocą znaczników messagesAdded, messagesDeleted, labelsAdded lub labelsDeleted łatwo jest określić, jak wiadomość została zmieniona, i zwykle bez konieczności wykonywania dodatkowych połączeń w celu zsynchronizowania klienta.

11 lutego 2015 roku: nowe opcje importowania wiadomości

messages.import() obsługuje teraz 3 nowe parametry, które lepiej obsługują przypadki użycia Email Migration. Informacje o tym, jak korzystać z nowych parametrów żądań neverMarkSpam, processForCalendar i deleted, znajdziesz w dokumentacji messages.import().

23 stycznia 2015 roku: obsługa etykiet importu wiadomości i zmiana domyślna

Możesz teraz określić message.labelIds w żądaniach messages.import(), aby automatycznie zastosować wybrane etykiety do wiadomości.

W ciągu najbliższych kilku tygodni domyślne działanie zmieni się tak, aby automatycznie dodawać etykiety INBOX i UNREAD do e-maili w messages.import(). Jeśli nie określisz wartości message.labelIds, zaimportowane e-maile będą widoczne tylko w sekcji „Wszystkie”. Jeśli chcesz zastosować etykiety INBOX lub UNREAD, podaj je w polu message.labelIds.

15 stycznia 2015 roku: zwiększenie limitów na użytkownika

Zwiększono domyślne ustawienie per-user quotas z 25 jednostek na użytkownika do 250 jednostek na użytkownika, a niektóre koszty metody zostały nieco skorygowane.

22 października 2014 r.: nowy parametr formatu do pobierania wątków

Możesz teraz określić format zwrotów dla threads.get(). Dostępne formaty to full, metadata i minimal, podobnie jak w metodzie messages.get(). Pamiętaj, że format raw nie jest dozwolony w przypadku threads.get(), aby uniknąć zwracania dużej ilości danych.

16 października 2014 roku: nowa metoda GetProfile

Dostępna jest nowa metoda getProfile(). Znajdziesz w niej informacje obejmujące całą skrzynkę pocztową, np. aktualny identyfikator historii czy łączną liczbę wiadomości i wątków.

6 października 2014 roku: nowa etykieta WAŻNE i nowe pola do liczenia wiadomości z daną etykietą

Dodaliśmy nową etykietę IMPORTANT, aby dopasować funkcje do interfejsu internetowego Gmaila.

Dodaliśmy też 4 nowe pola do zasobu Etykiety, aby uprościć zliczanie wiadomości z określoną etykietą.

Nowe pola: messagesTotal, messagesUnread, threadsTotal i threadsUnread.

8 września 2014 roku: dostępny jest nowy format wiadomości

Wprowadziliśmy pewne zmiany w messages.get(). Możesz teraz wysłać żądanie metadata, aby zwrócić tylko nagłówki i metadane, takie jak identyfikatory i etykiety.

2 września 2014 roku: zmiana sposobu działania dat

Możesz teraz określić internalDateSource dla messages.insert() i messages.import().

Chcielibyśmy zmienić sposób korzystania z tej flagi, aby był bardziej intuicyjny. Chcemy ją zmienić 15 września 2014 r. Od tego momentu messages.insert() będzie domyślnie korzystać z receivedTime, a messages.import() – z dateHeader. Jeśli interesuje Cię wewnętrzne źródło daty dla tagów messages.insert() lub messages.import(), zacznij określać ten parametr zapytania przed tym dniem.

11 lipca 2014 roku: aktualizacja kosztów limitu metody

Koszty przydziału wszystkich metod interfejsu API zostały zmniejszone o 10 razy. Jeśli na przykład metoda kosztuje 150 jednostek, teraz kosztuje 15 zł. Pełną listę kosztów metod API znajdziesz w tabeli wykorzystania limitu metody.

25 czerwca 2014 roku: dostępny jest interfejs Gmail API.

Interfejs Gmail API jest teraz dostępny publicznie.