[pixiv] implement 'metadata-bookmark' option (#3417)

docs/configuration.rst

@@ -1859,7 +1859,7 @@ Description
     Note: gallery-dl comes with built-in tokens for ``mastodon.social``,
     ``pawoo`` and ``baraag``. For other instances, you need to obtain an
     ``access-token`` in order to use usernames in place of numerical
-    user IDs. 
+    user IDs.
 
 
 extractor.[mastodon].reblogs
@@ -2168,6 +2168,17 @@ Description
     It is possible to use ``"all"`` instead of listing all values separately.
 
 
+extractor.pixiv.refresh-token
+-----------------------------
+Type
+    ``string``
+Description
+    The ``refresh-token`` value you get
+    from running ``gallery-dl oauth:pixiv`` (see OAuth_) or
+    by using a third-party tool like
+    `gppt <https://github.com/eggplants/get-pixivpy-token>`__.
+
+
 extractor.pixiv.metadata
 ------------------------
 Type
@@ -2178,6 +2189,20 @@ Description
     Fetch extended ``user`` metadata.
 
 
+extractor.pixiv.metadata-bookmark
+---------------------------------
+Type
+    ``bool``
+Default
+    ``false``
+Description
+    For works bookmarked by
+    `your own account <extractor.pixiv.refresh-token_>`__,
+    fetch bookmark tags as ``tags_bookmark`` metadata.
+
+    Note: This requires 1 additional API call per bookmarked post.
+
+
 extractor.pixiv.work.related
 ----------------------------
 Type
@@ -2309,7 +2334,7 @@ Description
     Retrieve additional comments by resolving the ``more`` comment
     stubs in the base comment tree.
 
-    This requires 1 additional API call for every 100 extra comments.
+    Note: This requires 1 additional API call for every 100 extra comments.
 
 
 extractor.reddit.date-min & .date-max

docs/gallery-dl.conf

@@ -237,6 +237,7 @@
             "refresh-token": null,
             "include": "artworks",
             "metadata": false,
+            "metadata-bookmark": false,
             "tags": "japanese",
             "ugoira": true
         },