문서로 건너뛰기
MCP 서버

구독

메일함이 받는 뉴스레터와 메일링 리스트.

구독 도구

도구하는 일
listSubscriptions뉴스레터와 메일링 리스트의 발신자 목록으로, 발신자와 그 발신자가 메일을 보내는 주소마다 한 행이며, 각 발신자가 보낸 메일의 양과 구독 해제 방식을 함께 보여 줍니다.
listSubscriptionDomains같은 내용을 발신자 도메인마다 한 행으로, 그 도메인의 발신자 중 사람이 페이지를 열지 않고도 구독을 해제할 수 있는 발신자 수와 함께.
unsubscribeSubscription발신자 한 명의 구독을 그 발신자가 요구하는 방식으로 해제합니다. 페이지만 제공하는 발신자는 사람이 열 수 있도록 그 링크를 돌려줍니다.
unsubscribeSubscriptionDomain도메인에서 원클릭 요청이나 메일을 받는 모든 발신자의 구독을 해제하고, 나머지는 셉니다.
unsubscribeThread읽기 창의 “구독 해제” 버튼처럼 스레드 발신자의 구독을 해제합니다.
moveSubscription발신자가 보낸 모든 것을 보관함, 휴지통 또는 라벨로 옮기고, future를 쓰면 규칙으로 새 메일도 계속 옮깁니다.

읽기에는 “스레드와 메시지 읽기”(threads:read), 구독 해제와 옮기기에는 “스레드에 라벨 지정, 읽음 표시, 보관”(threads:write)가 필요합니다. 새 메일을 계속 옮기면 규칙이 만들어지며, 여기에는 “메일 규칙 만들기, 편집, 순서 변경”(rules:write)도 필요합니다. 일부 주소로 제한된 클라이언트는 그 주소로 배달되는 구독에만 닿습니다.

구독을 해제하면 발신자에게 요청이나 메일이 가며, 여기서는 그것을 되돌릴 수 없습니다. 앱의 채팅에서 unsubscribeSubscriptionDomain은 항상 먼저 묻고, 나머지 변경은 직접 요청하지 않았다면 묻습니다.

레퍼런스

listSubscriptions

범위threads:read앱의 어시스턴트가 묻지 않고 실행합니다툴킷subscriptions

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자

다른 사용처

API
GET /subscriptions
SDK
subscriptions.list()

listSubscriptionDomains

범위threads:read앱의 어시스턴트가 묻지 않고 실행합니다툴킷subscriptions

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자

다른 사용처

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

unsubscribeSubscription

범위threads:write직접 요청하지 않은 한 앱의 어시스턴트가 먼저 확인합니다툴킷subscriptions

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

다른 사용처

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

unsubscribeSubscriptionDomain

범위threads:write앱의 어시스턴트가 항상 먼저 확인합니다툴킷subscriptions

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

다른 사용처

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

unsubscribeThread

범위threads:write직접 요청하지 않은 한 앱의 어시스턴트가 먼저 확인합니다툴킷subscriptions

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자

다른 사용처

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

moveSubscription

범위threads:write직접 요청하지 않은 한 앱의 어시스턴트가 먼저 확인합니다툴킷subscriptions

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자
futureboolean
ruleNamestring
최대 100자

다른 사용처

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