Suscripciones
Los boletines y las listas de correo que recibe el buzón.
Herramientas de suscripciones
| Herramienta | Qué hace |
|---|---|
| listSubscriptions | Los remitentes de boletines y listas de correo, una fila por remitente y dirección a la que escribe, con cuánto correo envió cada uno y cómo te permite darte de baja. |
| listSubscriptionDomains | Lo mismo, una fila por dominio de remitente, con cuántos de sus remitentes permiten darse de baja sin que una persona abra una página. |
| unsubscribeSubscription | Darse de baja de un remitente como él lo pide. Un remitente que solo ofrece una página devuelve su enlace para que una persona lo abra. |
| unsubscribeSubscriptionDomain | Darse de baja de todos los remitentes de un dominio que aceptan una solicitud de un clic o un correo, y contar el resto. |
| unsubscribeThread | Darse de baja del remitente de un hilo, como hace el botón «Cancelar suscripción» del panel de lectura. |
| moveSubscription | Mover todo lo que envió un remitente al archivo, a la papelera o a una etiqueta, y con future seguir moviendo su correo nuevo con una regla. |
Leer requiere «Leer hilos y mensajes» (threads:read), y darse de baja y mover requieren «Etiquetar, marcar como leídos y archivar hilos» (threads:write). Seguir moviendo el correo nuevo crea una regla, lo que además requiere «Crear, editar y reordenar reglas de correo» (rules:write). Un cliente limitado a algunas direcciones solo alcanza las suscripciones que se entregan a ellas.
Darse de baja envía una solicitud o un correo al remitente, y nada de aquí lo deshace. En el chat de la app, unsubscribeSubscriptionDomain siempre pregunta antes, y los demás cambios preguntan salvo que los hayas pedido tú.
Referencia
listSubscriptions
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.
Entradas
statusstring- Uno de
"active""unsubscribed" querystring- Hasta 200 caracteres
sortstring- Uno de
"recent""most""unread""name" limitinteger- Al menos 1Como máximo 200
offsetinteger- Al menos 0
addressstring- De 3 a 320 caracteres
También disponible en
listSubscriptionDomains
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.
Entradas
statusstring- Uno de
"active""unsubscribed" querystring- Hasta 200 caracteres
sortstring- Uno de
"recent""most""unread""name" limitinteger- Al menos 1Como máximo 200
offsetinteger- Al menos 0
addressstring- De 3 a 320 caracteres
También disponible en
unsubscribeSubscription
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.
Entradas
idstringObligatorio- De 1 a 64 caracteres
binboolean
También disponible en
unsubscribeSubscriptionDomain
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.
Entradas
domainstringObligatorio- De 1 a 253 caracteres
addressstring- De 3 a 320 caracteres
binboolean
También disponible en
unsubscribeThread
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.
Entradas
threadIdstringObligatorio- De 1 a 200 caracteres
También disponible en
moveSubscription
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.
Entradas
idstringObligatorio- De 1 a 64 caracteres
destinationstringObligatorio- Uno de
"archive""bin""label" labelIdstring- De 1 a 200 caracteres
futurebooleanruleNamestring- Hasta 100 caracteres