구독
메일함이 받는 뉴스레터와 메일링 리스트.
구독 도구
| 도구 | 하는 일 |
|---|---|
| listSubscriptions | 뉴스레터와 메일링 리스트의 발신자 목록으로, 발신자와 그 발신자가 메일을 보내는 주소마다 한 행이며, 각 발신자가 보낸 메일의 양과 구독 해제 방식을 함께 보여 줍니다. |
| listSubscriptionDomains | 같은 내용을 발신자 도메인마다 한 행으로, 그 도메인의 발신자 중 사람이 페이지를 열지 않고도 구독을 해제할 수 있는 발신자 수와 함께. |
| unsubscribeSubscription | 발신자 한 명의 구독을 그 발신자가 요구하는 방식으로 해제합니다. 페이지만 제공하는 발신자는 사람이 열 수 있도록 그 링크를 돌려줍니다. |
| unsubscribeSubscriptionDomain | 도메인에서 원클릭 요청이나 메일을 받는 모든 발신자의 구독을 해제하고, 나머지는 셉니다. |
| unsubscribeThread | 읽기 창의 “구독 해제” 버튼처럼 스레드 발신자의 구독을 해제합니다. |
| moveSubscription | 발신자가 보낸 모든 것을 보관함, 휴지통 또는 라벨로 옮기고, future를 쓰면 규칙으로 새 메일도 계속 옮깁니다. |
읽기에는 “스레드와 메시지 읽기”(threads:read), 구독 해제와 옮기기에는 “스레드에 라벨 지정, 읽음 표시, 보관”(threads:write)가 필요합니다. 새 메일을 계속 옮기면 규칙이 만들어지며, 여기에는 “메일 규칙 만들기, 편집, 순서 변경”(rules:write)도 필요합니다. 일부 주소로 제한된 클라이언트는 그 주소로 배달되는 구독에만 닿습니다.
구독을 해제하면 발신자에게 요청이나 메일이 가며, 여기서는 그것을 되돌릴 수 없습니다. 앱의 채팅에서 unsubscribeSubscriptionDomain은 항상 먼저 묻고, 나머지 변경은 직접 요청하지 않았다면 묻습니다.
레퍼런스
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.
입력
statusstring- 다음 중 하나
"active""unsubscribed" querystring- 최대 200자
sortstring- 다음 중 하나
"recent""most""unread""name" limitinteger- 1 이상200 이하
offsetinteger- 0 이상
addressstring- 3~320자
다른 사용처
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.
입력
statusstring- 다음 중 하나
"active""unsubscribed" querystring- 최대 200자
sortstring- 다음 중 하나
"recent""most""unread""name" limitinteger- 1 이상200 이하
offsetinteger- 0 이상
addressstring- 3~320자
다른 사용처
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.
입력
idstring필수- 1~64자
binboolean
다른 사용처
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.
입력
domainstring필수- 1~253자
addressstring- 3~320자
binboolean
다른 사용처
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.
입력
threadIdstring필수- 1~200자
다른 사용처
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.
입력
idstring필수- 1~64자
destinationstring필수- 다음 중 하나
"archive""bin""label" labelIdstring- 1~200자
futurebooleanruleNamestring- 최대 100자