This method is a lot more complex than Rename tag and Delete tag. It is used to assign tags to articles. Not only user-created tags, but also system ones. For example it is used to mark articles as read, or to star them.
a- tag to add
r- tag to remove
i- item ID. Can accept two types of values (see Article ID formats), whichever you prefer:
1234567890(shortened ID, preferred as it saves bandwidth)
i can be an array of IDs instead of a scalar value, so you can tag multiple items at once
List of system tags:
user/-/state/com.google/read- mark/unmark this article as read. Note that articles with
firstitemmsecof its feed cannot be marked as unread. The API will silently ignore this request.
user/-/state/com.google/starred- Add/Remove star (favorite) to the article.
user/-/state/com.google/broadcast- Broadcast article.
user/-/state/com.google/like- Like article.
user/-/label/tag_name- add custom tag.
This will mark two articles as read in one request:
This will mark two articles as unread and will add
test tag to them: