Ta bort etikett
remove_labelRemoves a specific label from one or more emails without deleting, moving, or otherwise changing them; specify the mailbox UID and label to update.
Instructions
Ta bort en etikett (Labels/…) från ett mejl utan att röra mejlet i övrigt.
Mejlet ligger kvar i sin mapp och behåller sina andra etiketter; det raderas inte och hamnar inte i Trash. Verktyget letar upp mejlets UID i etikettens vy via Message-ID (UID:n gäller per vy) och gör UID EXPUNGE på just det UID:t där, vilket hos Bridge bara tar bort etiketten.
mailbox kan vara mappen där mejlet ligger (t.ex. INBOX) eller etiketten själv (t.ex. "Labels/Kvitton" med UID:t från en listning av etiketten).
Avvisas med fel (inget ändras):
mejlet har inte etiketten,
etiketten finns inte (create_folder("Labels/Namn") skapar den); finns den bara med annan versal/gemen används den befintliga, och finns flera sådana varianter räknar felet upp dem,
label är Starred (använd unflag_email), en mapp eller en systemmapp,
UID:t finns inte i mailbox (UID:n gäller per mapp),
mejlet saknar ett Message-ID som går att söka på, eller går inte att skilja från ett annat mejl i etiketten — ange då etiketten som mailbox och UID:t därifrån (i en lista gäller felet bara det UID:t),
Bridge nekar (felet innehåller Bridges förklaring).
Args: uid: Mejlets UID i mailbox, eller en lista med upp till 100 UID:n ur samma mailbox mailbox: Mappen som UID:t kom från (obligatorisk). UID:n gäller per mapp: samma nummer i en annan mapp är ett annat mejl. Använd fältet mailbox från svaret av list_emails, search_emails eller get_email. label: Etiketten, med eller utan prefix: "Kvitton" eller "Labels/Kvitton"
Returns: True när etiketten är borttagen. Med en lista med UID:n blir svaret {"ok": [UID, ...], "failed": [{"uid": ..., "error": ...}]}: ett resultat per UID. UID:n som inte finns, som saknar etiketten eller som Bridge nekar hamnar i failed medan de andra genomförs. Nekar Bridge borttagningen efter att ha hunnit med en del, kontrolleras vilka mejl som inte längre har etiketten; de räknas som ok. Ett ogiltigt UID (inte heltal) eller fler än 100 avvisar hela anropet innan något ändras.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uid | Yes | Mejlets UID i mailbox, eller en lista med upp till 100 UID:n ur samma mailbox. Med en lista blir svaret {"ok": [UID, ...], "failed": [{"uid": ..., "error": ...}]}. | |
| label | Yes | ||
| mailbox | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |