Add validate rich menu object API (#391)

Author: intactio

README.rst

@@ -346,6 +346,27 @@ https://developers.line.biz/en/reference/messaging-api/#get-rich-menu
     rich_menu = line_bot_api.get_rich_menu(rich_menu_id)
     print(rich_menu.rich_menu_id)
 
+validate\_rich\_menu\_object(self, rich\_menu, timeout=None)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Validate a rich menu object.
+You can verify that a rich menu object is valid as a request body for creating rich menu.
+
+https://developers.line.biz/ja/reference/messaging-api/#validate-rich-menu-object
+
+.. code:: python
+
+    rich_menu_to_validate = RichMenu(
+        size=RichMenuSize(width=2500, height=843),
+        selected=False,
+        name="Nice richmenu",
+        chat_bar_text="Tap here",
+        areas=[RichMenuArea(
+            bounds=RichMenuBounds(x=0, y=0, width=2500, height=843),
+            action=URIAction(label='Go to line.me', uri='https://line.me'))]
+    )
+    line_bot_api.validate_rich_menu_object(rich_menu=rich_menu_to_create)
+
 create\_rich\_menu(self, rich\_menu, timeout=None)
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 

linebot/api.py

@@ -739,6 +739,24 @@ def get_rich_menu_alias_list(self, timeout=None):
         )
         return RichMenuAliasListResponse.new_from_json_dict(response.json)
 
+    def validate_rich_menu_object(self, rich_menu, timeout=None):
+        """Call validate rich menu object API.
+
+        https://developers.line.biz/ja/reference/messaging-api/#validate-rich-menu-object
+
+        :param rich_menu: Inquired to validate a rich menu object.
+        :type rich_menu: T <= :py:class:`linebot.models.rich_menu.RichMenu`
+        :param timeout: (optional) How long to wait for the server
+            to send data before giving up, as a float,
+            or a (connect timeout, read timeout) float tuple.
+            Default is self.http_client.timeout
+        :type timeout: float | tuple(float, float)
+        """
+        self._post(
+            '/v2/bot/richmenu/validate', data=rich_menu.as_json_string(),
+            timeout=timeout
+        )
+
     def create_rich_menu(self, rich_menu, timeout=None):
         """Call create rich menu API.
 

linebot/async_api.py

@@ -796,6 +796,24 @@ async def get_rich_menu_alias_list(self, timeout=None):
         response = await self._get("/v2/bot/richmenu/alias/list", timeout=timeout)
         return RichMenuAliasListResponse.new_from_json_dict((await response.json))
 
+    async def validate_rich_menu_object(self, rich_menu, timeout=None):
+        """Call validate rich menu object API.
+
+        https://developers.line.biz/ja/reference/messaging-api/#validate-rich-menu-object
+
+        :param rich_menu: Inquired to create a rich menu object.
+        :type rich_menu: T <= :py:class:`linebot.models.rich_menu.RichMenu`
+        :param timeout: (optional) How long to wait for the server
+            to send data before giving up, as a float,
+            or a (connect timeout, read timeout) float tuple.
+            Default is self.async_http_client.timeout
+        :type timeout: float | tuple(float, float)
+        """
+        await self._post(
+            "/v2/bot/richmenu/validate", data=rich_menu.as_json_string(),
+            timeout=timeout
+        )
+
     async def create_rich_menu(self, rich_menu, timeout=None):
         """Call create rich menu API.
 

tests/api/test_rich_menu.py

@@ -114,6 +114,46 @@ def test_get_rich_menu(self):
         self.assertEqual(rich_menu.areas[0].action.type, 'postback')
         self.assertEqual(rich_menu.areas[0].action.data, 'action=buy&itemid=123')
 
+    @responses.activate
+    def test_validate_rich_menu_object(self):
+        responses.add(
+            responses.POST,
+            LineBotApi.DEFAULT_API_ENDPOINT + '/v2/bot/richmenu/validate',
+            json={}, status=200
+        )
+
+        rich_menu = RichMenu(
+            size=RichMenuSize(
+                width=2500,
+                height=1686
+            ),
+            selected=False,
+            name="nice richmenu",
+            chatBarText="touch me",
+            areas=[
+                RichMenuArea(
+                    RichMenuBounds(
+                        x=0,
+                        y=0,
+                        width=833,
+                        height=843
+                    ),
+                    URITemplateAction(
+                        uri='https://line.me/R/nv/location/'
+                    )
+                )
+            ]
+        )
+
+        self.tested.validate_rich_menu_object(rich_menu)
+
+        request = responses.calls[0].request
+        self.assertEqual(request.method, 'POST')
+        self.assertEqual(
+            request.url,
+            LineBotApi.DEFAULT_API_ENDPOINT + '/v2/bot/richmenu/validate'
+        )
+
     @responses.activate
     def test_create_rich_menu(self):
         responses.add(