Aller à la documentation
Serveur MCP

Abonnements

Les newsletters et listes de diffusion que reçoit la boîte aux lettres.

Outils Abonnements

OutilCe qu'il fait
listSubscriptionsLes expéditeurs de newsletters et de listes de diffusion, une ligne par expéditeur et par adresse à laquelle il écrit, avec la quantité de courrier envoyée par chacun et la façon dont il permet de se désabonner.
listSubscriptionDomainsLa même chose, avec une ligne par domaine d'expéditeur et le nombre de ses expéditeurs dont on peut se désabonner sans qu'une personne ouvre une page.
unsubscribeSubscriptionSe désabonner d'un expéditeur de la façon qu'il demande. Un expéditeur qui ne propose qu'une page renvoie son lien, qu'une personne doit ouvrir.
unsubscribeSubscriptionDomainSe désabonner de chaque expéditeur d'un domaine qui accepte une demande en un clic ou un e-mail, et compter les autres.
unsubscribeThreadSe désabonner de l'expéditeur d'un fil, comme le fait le bouton « Se désabonner » du volet de lecture.
moveSubscriptionDéplacer tout ce qu'un expéditeur a envoyé vers l'archive, la corbeille ou un libellé, et, avec future, continuer à déplacer son nouveau courrier grâce à une règle.

Lire demande « Lire les conversations et les messages » (threads:read), et se désabonner et déplacer demandent « Étiqueter, marquer comme lues et archiver les conversations » (threads:write). Continuer à déplacer le nouveau courrier crée une règle, qui demande aussi « Créer, modifier et réordonner les règles de courrier » (rules:write). Un client limité à certaines adresses n'atteint que les abonnements qui leur sont distribués.

Se désabonner envoie une demande ou un e-mail à l'expéditeur, et rien ici ne l'annule. Dans le chat de l'application, unsubscribeSubscriptionDomain demande toujours d'abord, et les autres modifications demandent, sauf si vous les avez demandées.

Référence

listSubscriptions

Portéesthreads:readL'assistant de l'application l'exécute sans demanderBoîte à outilssubscriptions

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.

Entrées

statusstring
L'un de"active""unsubscribed"
querystring
Jusqu'à 200 caractères
sortstring
L'un de"recent""most""unread""name"
limitinteger
Au moins 1Au plus 200
offsetinteger
Au moins 0
addressstring
De 3 à 320 caractères

Aussi disponible dans

API
GET /subscriptions
SDK
subscriptions.list()

listSubscriptionDomains

Portéesthreads:readL'assistant de l'application l'exécute sans demanderBoîte à outilssubscriptions

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.

Entrées

statusstring
L'un de"active""unsubscribed"
querystring
Jusqu'à 200 caractères
sortstring
L'un de"recent""most""unread""name"
limitinteger
Au moins 1Au plus 200
offsetinteger
Au moins 0
addressstring
De 3 à 320 caractères

Aussi disponible dans

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

unsubscribeSubscription

Portéesthreads:writeL'assistant de l'application demande d'abord, sauf si vous l'avez demandéBoîte à outilssubscriptions

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.

Entrées

idstringObligatoire
De 1 à 64 caractères
binboolean

Aussi disponible dans

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

unsubscribeSubscriptionDomain

Portéesthreads:writeL'assistant de l'application demande toujours d'abordBoîte à outilssubscriptions

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.

Entrées

domainstringObligatoire
De 1 à 253 caractères
addressstring
De 3 à 320 caractères
binboolean

Aussi disponible dans

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

unsubscribeThread

Portéesthreads:writeL'assistant de l'application demande d'abord, sauf si vous l'avez demandéBoîte à outilssubscriptions

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.

Entrées

threadIdstringObligatoire
De 1 à 200 caractères

Aussi disponible dans

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

moveSubscription

Portéesthreads:writeL'assistant de l'application demande d'abord, sauf si vous l'avez demandéBoîte à outilssubscriptions

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.

Entrées

idstringObligatoire
De 1 à 64 caractères
destinationstringObligatoire
L'un de"archive""bin""label"
labelIdstring
De 1 à 200 caractères
futureboolean
ruleNamestring
Jusqu'à 100 caractères

Aussi disponible dans

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