Zur Dokumentation springen
MCP-Server

Abonnements

Die Newsletter und Mailinglisten, die das Postfach empfängt.

Abonnement-Tools

ToolWas es tut
listSubscriptionsDie Absender von Newslettern und Mailinglisten, eine Zeile pro Absender und Adresse, an die er schreibt, mit der Menge an Mail, die jeder gesendet hat, und der Art, wie er die Abmeldung ermöglicht.
listSubscriptionDomainsDasselbe, eine Zeile pro Absenderdomain, mit der Zahl ihrer Absender, von denen man sich abmelden kann, ohne dass eine Person eine Seite öffnet.
unsubscribeSubscriptionSich von einem Absender so abmelden, wie er es verlangt. Ein Absender, der nur eine Seite anbietet, gibt ihren Link zurück, damit eine Person ihn öffnet.
unsubscribeSubscriptionDomainSich von jedem Absender einer Domain abmelden, der eine Ein-Klick-Anfrage oder eine E-Mail annimmt, und den Rest zählen.
unsubscribeThreadSich vom Absender eines Threads abmelden, wie es die Schaltfläche „Abbestellen“ im Lesebereich tut.
moveSubscriptionAlles, was ein Absender gesendet hat, ins Archiv, in den Papierkorb oder unter ein Label verschieben und mit future seine neue Mail per Regel weiter verschieben.

Lesen erfordert „Threads und Nachrichten lesen“ (threads:read), und Abmelden und Verschieben erfordern „Threads labeln, als gelesen markieren und archivieren“ (threads:write). Neue Mail weiter zu verschieben legt eine Regel an, was zusätzlich „Mail-Regeln erstellen, bearbeiten und neu ordnen“ (rules:write) erfordert. Ein auf einige Adressen beschränkter Client erreicht nur die Abonnements, die an diese Adressen zugestellt werden.

Eine Abmeldung sendet eine Anfrage oder eine E-Mail an den Absender, und nichts hier macht sie rückgängig. Im Chat der App fragt unsubscribeSubscriptionDomain immer zuerst nach, und die anderen Änderungen fragen nach, sofern Sie sie nicht selbst verlangt haben.

Referenz

listSubscriptions

Geltungsbereichethreads:readDer Assistent in der App führt es ohne Nachfrage ausToolkitsubscriptions

The newsletters and mailing lists the mailbox receives, as the Subscriptions page shows them: one row per sender and the address it writes to, with how much mail it sent, how much is unread and how it lets you unsubscribe. status is active (the default) or unsubscribed. query searches the sender, sort is recent, most, unread or name, and offset pages on.

Eingaben

statusstring
Einer von"active""unsubscribed"
querystring
Bis zu 200 Zeichen
sortstring
Einer von"recent""most""unread""name"
limitinteger
Mindestens 1Höchstens 200
offsetinteger
Mindestens 0
addressstring
3 bis 320 Zeichen

Auch verfügbar über

API
GET /subscriptions
SDK
subscriptions.list()

listSubscriptionDomains

Geltungsbereichethreads:readDer Assistent in der App führt es ohne Nachfrage ausToolkitsubscriptions

The same subscriptions grouped by sender domain, so a company that writes from several addresses is one row, with how many of its senders can be unsubscribed without a person opening a page. Takes the same filters as listSubscriptions.

Eingaben

statusstring
Einer von"active""unsubscribed"
querystring
Bis zu 200 Zeichen
sortstring
Einer von"recent""most""unread""name"
limitinteger
Mindestens 1Höchstens 200
offsetinteger
Mindestens 0
addressstring
3 bis 320 Zeichen

Auch verfügbar über

API
GET /subscriptions/domains
SDK
subscriptions.listDomains()

unsubscribeSubscription

Geltungsbereichethreads:writeDer Assistent in der App fragt zuerst nach, außer Sie haben darum gebetenToolkitsubscriptions

Unsubscribe from one sender the way it asks for: a one-click request when it offers one, otherwise an unsubscribe email from the address the mail arrived at. A sender that only offers a page returns its link, which a person has to open. bin also moves every conversation from the sender to the Bin. Take the id from listSubscriptions.

Eingaben

idstringErforderlich
1 bis 64 Zeichen
binboolean

Auch verfügbar über

API
POST /subscriptions/{id}/unsubscribe
SDK
subscriptions.unsubscribe()

unsubscribeSubscriptionDomain

Geltungsbereichethreads:writeDer Assistent in der App fragt immer zuerst nachToolkitsubscriptions

Unsubscribe from every sender on one domain that can be unsubscribed without a person opening a page, as the domain view of the Subscriptions page does. Senders that only offer a page are skipped and counted. bin also moves their conversations to the Bin, and address keeps it to the subscriptions delivered to one address.

Eingaben

domainstringErforderlich
1 bis 253 Zeichen
addressstring
3 bis 320 Zeichen
binboolean

Auch verfügbar über

API
POST /subscriptions/domains/{domain}/unsubscribe
SDK
subscriptions.unsubscribeDomain()

unsubscribeThread

Geltungsbereichethreads:writeDer Assistent in der App fragt zuerst nach, außer Sie haben darum gebetenToolkitsubscriptions

Unsubscribe from the sender of an email thread, as the Unsubscribe button of the reading pane does, from the newest message in it that carries an unsubscribe header.

Eingaben

threadIdstringErforderlich
1 bis 200 Zeichen

Auch verfügbar über

API
POST /threads/{id}/unsubscribe
SDK
threads.unsubscribe()

moveSubscription

Geltungsbereichethreads:writeDer Assistent in der App fragt zuerst nach, außer Sie haben darum gebetenToolkitsubscriptions

Move every conversation from one sender to the archive, the Bin or a label. future, true by default, also makes a rule that keeps doing it to new mail from the sender, which needs permission to change rules, and false drops such a rule. labelId is the label for destination label, from getUserLabels.

Eingaben

idstringErforderlich
1 bis 64 Zeichen
destinationstringErforderlich
Einer von"archive""bin""label"
labelIdstring
1 bis 200 Zeichen
futureboolean
ruleNamestring
Bis zu 100 Zeichen

Auch verfügbar über

API
POST /subscriptions/{id}/move
SDK
subscriptions.move()