Modify the labels on a message — gm_modify_message • gmailr

Function to modify the labels on a given message by id. Note you need to use the label ID as arguments to this function, not the label name.

gm_modify_message(id, add_labels = NULL, remove_labels = NULL, user_id = "me")

Arguments

id: message id to access
add_labels: label IDs to add to the specified message
remove_labels: label IDs to remove from the specified message
user_id: gmail user_id to access, special value of 'me' indicates the authenticated user.

References

https://developers.google.com/gmail/api/reference/rest/v1/users.messages/modify

See also

Other message: gm_attachment(), gm_delete_message(), gm_import_message(), gm_insert_message(), gm_messages(), gm_message(), gm_save_attachments(), gm_save_attachment(), gm_send_message(), gm_trash_message(), gm_untrash_message()

Examples

if (FALSE) { # \dontrun{
gm_modify_message(12345, add_labels = "label_1")
gm_modify_message(12345, remove_labels = "label_1")
# add and remove at the same time
gm_modify_message(12345, add_labels = "label_2", remove_labels = "label_1")
} # }