Versionshinweise zur Gmail API

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Diese Seite enthält Versionshinweise für die Gmail API.

12. November 2019 Neue Implementierung von message.import()

messages.import() wird jetzt mit einer leistungsstärkeren Back-End-Implementierung implementiert. Die neue Version ist mit der vorherigen Implementierung API-kompatibel und alle Clients verwenden seit ein paar Wochen automatisch das neue Verhalten. Das neue Back-End unterstützt parallele message.import()-Aufrufe effizient und Clients können jetzt Nachrichten parallel importieren, um einen höheren Migrationsdurchsatz zu erzielen. Die Kontingentkosten für die API-Methode message.import() wurden entsprechend der neuen Leistung gesenkt.

7. Februar 2017 Verlaufstyp nach „history.list()“ filtern

history.list() unterstützt jetzt das Filtern von Verlaufseinträgen nach Typ.

30. November 2016 Neue Methode "messages.batchModify()"

messages.batchModify() ist eine neue Methode, mit der Labels für mehrere Nachrichten nach Nachrichten-IDs in einem einzigen Batchvorgang geändert werden können.

1. November 2016: Neuer Metadaten-Bereich

Die Gmail API unterstützt jetzt einen neuen gmail.metadata-Bereich. Mit diesem Bereich haben Entwickler Zugriff auf das Postfach eines Nutzers, einschließlich Verlaufseinträgen, Labels und E-Mail-Headern. E-Mail-Texte und -Anhänge sind jedoch nicht zulässig.

1. Juli 2016: Neue Endpunkte für Einstellungen

Wir haben mehrere neue Endpunkte für die Verwaltung von E-Mail-Einstellungen eingeführt. Weitere Informationen finden Sie in den folgenden Anleitungen:

Außerdem hat drafts.list() den neuen Anfrageparameter q, der Ergebnisse auf die Nachrichten beschränkt, die der angegebenen Abfrage entsprechen.

25. Februar 2016: Neue Methode "messages.batchDelete()"

messages.batchDelete() ist eine neue Methode, mit der mehrere Nachrichten anhand von Nachrichten-IDs in einem einzigen Batch gelöscht werden können.

13. Januar 2016: Neue Option für Entwurf.list()

drafts.list() hat jetzt die neue Option „spamSpam“. Damit können Sie festlegen, ob die Antwort Entwürfe mit dem SPAM- oder TRASH-Label enthalten soll. Die Standardeinstellung ist derzeit für diese Option auf „wahr“ gesetzt. Wir planen jedoch, sie bald auf „falsch“ zu setzen.

22. Juni 2015: Labels von history.list()

history.list() gibt jetzt alle aktuellen Message.labelIds-Werte als Teil der Antwort in messagesAdded, messagesDeleted, labelsAdded und labelsRemoved zurück. So kann der Status einer E-Mail vor und nach einer Änderung problemlos ermittelt werden.

18. Juni 2015: Feld „internes Datum“

Es wurde ein neues Message.internalDate-Feld hinzugefügt, das den Erstellungszeitstempel der Nachricht im Postfach anzeigt.

29. Mai 2015: Gmail API-Push-Benachrichtigungen

Die Gmail API unterstützt jetzt das Senden von Push-Benachrichtigungen bei Postfachaktualisierungen, sodass Serverbenachrichtigungen in Echtzeit erfolgen, ohne ständig Abfragen durchzuführen. Mithilfe von Cloud Pub/Sub können Sie jetzt Webhooks verwenden, um beispielsweise Callbacks zu empfangen. Außerdem können diese Benachrichtigungen nach bestimmten Gmail-Labels gefiltert werden. Weitere Informationen finden Sie im Leitfaden zu Push-Benachrichtigungen.

31. März 2015: Neue Bereiche für Labels und Einfügen von Nachrichten

Wir haben zwei neue, detailliertere ACL-Bereiche eingeführt, um Nutzer und Anwendungen, die keinen vollständigen Postfachzugriff benötigen, besser zu schützen:

18. März 2015: Neue Optionen zum Einfügen von Nachrichten

messages.insert() unterstützt jetzt den deleted-Anfrageparameter und ermöglicht das Festlegen von Labels für SENT und DRAFT.

25. Februar 2015: Weitere Details aus der Verlaufsliste

history.list() enthält jetzt Details zum Änderungstyp in jedem Verlauf. Beispielsweise können Sie mit messagesAdded, messagesDeleted, labelsAdded oder labelsDeleted leicht erkennen, wie eine Nachricht geändert wurde. In der Regel sind dann keine zusätzlichen Aufrufe zur Synchronisierung Ihres Clients erforderlich.

11. Februar 2015: Neue Optionen für den Nachrichtenimport

messages.import() unterstützt jetzt drei neue Parameter für Email Migration-Anwendungsfälle. Informationen zur Verwendung der neuen Anfrageparameter neverMarkSpam, processForCalendar und deleted finden Sie in der messages.import()-Dokumentation.

23. Januar 2015: Support für Nachrichtenimport-Labels und Standardänderung

Sie können jetzt message.labelIds in messages.import()-Anfragen angeben, damit die angegebenen Labels automatisch auf die Nachricht angewendet werden.

Daher wird sich das Standardverhalten in den nächsten Wochen ändern, sodass messages.import()-E-Mails INBOX- und UNREAD-Labels nicht mehr automatisch hinzugefügt werden. Wenn message.labelIds nicht angegeben ist, sind importierte E-Mails nur in „Alle Nachrichten“ sichtbar. Wenn die Labels INBOX und/oder UNREAD angewendet werden sollen, geben Sie diese im Feld message.labelIds an.

15. Januar 2015: Erhöhte Kontingente pro Nutzer

Der Standardwert von per-user quotas wurde von 25 Einheiten/Nutzer/Sekunde auf 250 Einheiten/Nutzer/Sekunde erhöht. Außerdem wurden einige Methodenkosten geringfügig angepasst.

22. Oktober 2014: Neuer Formatparameter zum Abrufen von Threads

Sie können jetzt das Rückgabeformat für threads.get() angeben. Die verfügbaren Formate sind full, metadata und minimal, ähnlich wie die Methode messages.get(). Das Format raw ist für threads.get() nicht zulässig, um zu verhindern, dass unerwartet große Datenmengen zurückgegeben werden.

16. Oktober 2014: Neue GetProfile-Methode

Eine neue getProfile()-Methode ist jetzt verfügbar. Sie enthält Informationen zum gesamten Postfach, z. B. die aktuelle Verlaufs-ID sowie die Gesamtzahl der Nachrichten und Threads.

6. Oktober 2014: Neues WICHTIG-Label und neue Felder zum Zählen von Nachrichten mit einem bestimmten Label

Wir haben ein neues IMPORTANT-Label hinzugefügt, das der Funktionalität der Gmail-Weboberfläche entspricht.

Außerdem haben wir der Ressource "Labels" vier neue Felder hinzugefügt, um die Zählung von Nachrichten mit einem bestimmten Label zu vereinfachen.

Die neuen Felder sind messagesTotal, messagesUnread, threadsTotal und threadsUnread.

8. September 2014: Neues Nachrichtenformat verfügbar

Wir haben einige Änderungen an messages.get() vorgenommen. Sie können jetzt das metadata-Rückgabeformat anfordern, um nur die E-Mail-Header und Metadaten wie Kennzeichnungen und Labels zurückzugeben.

2. September 2014: Änderungen am internen Datum

Sie können jetzt internalDateSource sowohl für messages.insert() als auch für messages.import() angeben.

Wir möchten das Standardverhalten für dieses Flag intuitiver gestalten und das Standardverhalten am 15. September 2014 ändern. Danach wird für messages.insert() standardmäßig receivedTime und für messages.import() standardmäßig dateHeader verwendet. Wenn die interne Datumsquelle für messages.insert() oder messages.import() wichtig ist, müssen Sie diesen Anfrageabfrageparameter vor diesem Datum angeben.

11. Juli 2014: Aktualisierung der Methodenkontingentkosten

Die Kontingentkosten für alle Methoden in der API wurden um den Faktor 10 gesenkt. Wenn eine Methode zuvor 150 Kontingenteinheiten kostete, kostet sie jetzt 15. Eine vollständige Liste der Kosten für API-Methoden finden Sie im Diagramm zur Nutzung pro Kontingentkontingent.

25. Juni 2014: Einführung der Gmail API

Die Gmail API ist jetzt öffentlich verfügbar.