line-bot-api 1.29.1 → 1.30.0

data/lib/line/bot/v2/webhook/model/video_play_complete_event.rb

@@ -0,0 +1,109 @@
+# Webhook Type Definition
+# Webhook event definition of the LINE Messaging API
+#
+# The version of the OpenAPI document: 1.0.0
+#
+# NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+# https://openapi-generator.tech
+# Do not edit the class manually.
+
+require_relative './event'
+
+module Line
+  module Bot
+    module V2
+      module Webhook
+        # Event for when a user finishes viewing a video at least once with the specified trackingId sent by the LINE Official Account.
+        class VideoPlayCompleteEvent < Event
+          # @!attribute [r] type
+          #   @return [String] Type of the event
+          attr_reader :type
+          # @!attribute [rw] source
+          #   @return [Source,nil] 
+          attr_accessor :source
+          # @!attribute [rw] timestamp
+          #   @return [Integer] Time of the event in milliseconds.
+          attr_accessor :timestamp
+          # @!attribute [rw] mode
+          #   @return [String] ('active'|'standby') 
+          attr_accessor :mode
+          # @!attribute [rw] webhook_event_id
+          #   @return [String] Webhook Event ID. An ID that uniquely identifies a webhook event. This is a string in ULID format.
+          attr_accessor :webhook_event_id
+          # @!attribute [rw] delivery_context
+          #   @return [DeliveryContext] 
+          attr_accessor :delivery_context
+          # @!attribute [rw] reply_token
+          #   @return [String] Reply token used to send reply message to this event
+          attr_accessor :reply_token
+          # @!attribute [rw] video_play_complete
+          #   @return [VideoPlayComplete] 
+          attr_accessor :video_play_complete
+
+          # @param source [Source, Hash[Symbol, untyped], nil] 
+          # @param timestamp [Integer] Time of the event in milliseconds.
+          # @param mode [String] ('active'|'standby') 
+          # @param webhook_event_id [String] Webhook Event ID. An ID that uniquely identifies a webhook event. This is a string in ULID format.
+          # @param delivery_context [DeliveryContext, Hash[Symbol, untyped]] 
+          # @param reply_token [String] Reply token used to send reply message to this event
+          # @param video_play_complete [VideoPlayComplete, Hash[Symbol, untyped]] 
+          def initialize(
+            source: nil,
+            timestamp:,
+            mode:,
+            webhook_event_id:,
+            delivery_context:,
+            reply_token:,
+            video_play_complete:,
+            **dynamic_attributes
+          )
+            @type = "videoPlayComplete"
+            
+            @source = source.is_a?(Line::Bot::V2::Webhook::Source) || source.nil? ? source : Line::Bot::V2::Webhook::Source.create(**source) # steep:ignore
+            @timestamp = timestamp
+            @mode = mode
+            @webhook_event_id = webhook_event_id
+            @delivery_context = delivery_context.is_a?(Line::Bot::V2::Webhook::DeliveryContext) ? delivery_context : Line::Bot::V2::Webhook::DeliveryContext.create(**delivery_context) # steep:ignore
+            @reply_token = reply_token
+            @video_play_complete = video_play_complete.is_a?(Line::Bot::V2::Webhook::VideoPlayComplete) ? video_play_complete : Line::Bot::V2::Webhook::VideoPlayComplete.create(**video_play_complete) # steep:ignore
+
+            dynamic_attributes.each do |key, value|
+              self.class.attr_accessor key
+
+              if value.is_a?(Hash)
+                struct_klass = Struct.new(*value.keys.map(&:to_sym))
+                struct_values = value.map { |_k, v| v.is_a?(Hash) ? Line::Bot::V2::Utils.hash_to_struct(v) : v }
+                instance_variable_set("@#{key}", struct_klass.new(*struct_values))
+              else
+                instance_variable_set("@#{key}", value)
+              end
+            end
+          end
+
+          # Create an instance of the class from a hash
+          # @param args [Hash] Hash containing all the required attributes
+          # @return [Line::Bot::V2::Webhook::VideoPlayCompleteEvent] Instance of the class
+          def self.create(args) # steep:ignore
+            symbolized_args = Line::Bot::V2::Utils.deep_symbolize(args)
+            return new(**symbolized_args) # steep:ignore
+          end
+
+          # @param other [Object] Object to compare
+          # @return [Boolean] true if the objects are equal, false otherwise
+          def ==(other)
+            return false unless self.class == other.class
+
+            instance_variables.all? do |var|
+                instance_variable_get(var) == other.instance_variable_get(var)
+            end
+          end
+
+          # @return [Integer] Hash code of the object
+          def hash
+            [self.class, *instance_variables.map { |var| instance_variable_get(var) }].hash
+          end
+        end
+      end
+    end
+  end
+end

data/lib/line/bot/v2/webhook_parser.rb

@@ -0,0 +1,94 @@
+require 'base64'
+require 'json'
+require 'openssl'
+
+require 'line/bot/v2/utils'
+require 'line/bot/v2/webhook/core'
+
+module Line
+  module Bot
+    module V2
+      class WebhookParser
+        class InvalidSignatureError < StandardError; end
+
+        def initialize(channel_secret:)
+          @channel_secret = channel_secret
+        end
+
+        # Parse events from the raw request body and validate the signature.
+        #
+        # @param body [String]
+        #   The unmodified request body (exactly as received).
+        # @param signature [String]
+        #   The value of the 'X-LINE-Signature' header.
+        # @return [Array<Line::Bot::V2::Webhook::Event>]
+        #   An array of event objects. Recognized events become instances of classes
+        #   under `Line::Bot::V2::Webhook::*Event`;
+        #   `Line::Bot::V2::Webhook::Event` is returned as fallback only when the event class is not defined in line-bot-sdk library.
+        #   When you update the SDK, you may not need to handle `Line::Bot::V2::Webhook::Event` anymore.
+        # @raise [InvalidSignatureError]
+        #   If the signature fails verification.
+        #
+        # @example Sinatra usage
+        #   def parser
+        #     @parser ||= Line::Bot::V2::WebhookParser.new(channel_secret: ENV.fetch("LINE_CHANNEL_SECRET"))
+        #   end
+        #
+        #   post '/callback' do
+        #     body = request.body.read
+        #     signature = request.env['HTTP_X_LINE_SIGNATURE']
+        #
+        #     begin
+        #       events = parser.parse(body: body, signature: signature)
+        #     rescue Line::Bot::V2::WebhookParser::InvalidSignatureError
+        #       halt 400, { 'Content-Type' => 'text/plain' }, 'Bad Request'
+        #     end
+        #
+        #     # Handle events...
+        #     events.each do |event|
+        #       case event
+        #       when Line::Bot::V2::Webhook::MessageEvent
+        #         handle_message_event(event)
+        #       ...
+        #     end
+        #     "OK"
+        #   end
+        def parse(body:, signature:)
+          raise InvalidSignatureError.new("Invalid signature: #{signature}") unless verify_signature(body: body, signature: signature)
+
+          data = JSON.parse(body.chomp, symbolize_names: true)
+          data = Line::Bot::V2::Utils.deep_underscore(data)
+          data = Line::Bot::V2::Utils.deep_convert_reserved_words(data)
+          data = Line::Bot::V2::Utils.deep_symbolize(data)
+
+          data[:events].map do |event|
+            Line::Bot::V2::Webhook::Event.create(**event) # steep:ignore
+          end
+        end
+
+        private
+
+        def verify_signature(body:, signature:)
+          hash = OpenSSL::HMAC.digest(OpenSSL::Digest.new('SHA256'), @channel_secret, body)
+          expected = Base64.strict_encode64(hash)
+          variable_secure_compare(signature, expected)
+        end
+
+        # To avoid timing attacks
+        def variable_secure_compare(a, b)
+          secure_compare(::Digest::SHA256.hexdigest(a), ::Digest::SHA256.hexdigest(b))
+        end
+
+        def secure_compare(a, b)
+          return false unless a.bytesize == b.bytesize
+
+          l = a.unpack("C#{a.bytesize}")
+
+          res = 0
+          b.each_byte { |byte| res |= byte ^ l.shift } # steep:ignore ArgumentTypeMismatch
+          res == 0
+        end
+      end
+    end
+  end
+end

data/lib/line/bot/version.rb

@@ -0,0 +1,7 @@
+module Line
+  module Bot
+    # This version is updated before releasing a new version in the release process.
+    # You don't have to update this version manually.
+    VERSION = "1.30.0"
+  end
+end

data/lib/line/bot.rb

@@ -1,10 +1,10 @@
-# Copyright 2016 LINE
+# Copyright 2016-2024 LINE
 #
 # LINE Corporation licenses this file to you under the Apache License,
 # version 2.0 (the "License"); you may not use this file except in compliance
 # with the License. You may obtain a copy of the License at:
 #
-#     http://www.apache.org/licenses/LICENSE-2.0
+#     http://www.apache.org/licenses/LICENSE_2.0
 #
 # Unless required by applicable law or agreed to in writing, software
 # distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
@@ -12,10 +12,25 @@
 # License for the specific language governing permissions and limitations
 # under the License.
 
-require 'line/bot/util'
-require 'line/bot/client'
-require 'line/bot/event'
-require 'line/bot/api/errors'
-require 'line/bot/api'
-require 'line/bot/httpclient'
-require 'line/bot/api/version'
+# V1
+require 'line/bot/v1/util'
+require 'line/bot/v1/client'
+require 'line/bot/v1/event'
+require 'line/bot/v1/api/errors'
+require 'line/bot/v1/api'
+require 'line/bot/v1/httpclient'
+require 'line/bot/v1/api/version'
+
+# V2
+require 'line/bot/v2/webhook_parser'
+
+## OpenAPI
+require 'line/bot/v2/channel_access_token/core'
+require 'line/bot/v2/insight/core'
+require 'line/bot/v2/liff/core'
+require 'line/bot/v2/manage_audience/core'
+require 'line/bot/v2/messaging_api/core'
+require 'line/bot/v2/module/core'
+require 'line/bot/v2/module_attach/core'
+require 'line/bot/v2/shop/core'
+require 'line/bot/v2/webhook/core'

data/line-bot-api.gemspec

@@ -1,26 +1,31 @@
-lib = File.expand_path('lib', __dir__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'line/bot/api/version'
+version = File.read("#{__dir__}/lib/line/bot/version.rb").match(/VERSION *= *['"]([^'"]+)/)[1] or raise
+raise "Invalid version format <#{version}>" unless version.match?(/\A\d+\.\d+\.\d+(?:[+-][\w.-]+)?\z/)
 
 Gem::Specification.new do |spec|
-  spec.name          = "line-bot-api"
-  spec.version       = Line::Bot::API::VERSION
-  spec.authors       = ["LINE Corporation"]
-  spec.email         = ["kimoto@linecorp.com", "todaka.yusuke@linecorp.com", "masaki_kurosawa@linecorp.com"]
+  spec.name = "line-bot-api"
+  spec.version = version
+  spec.authors = ["LINE Corporation"]
 
-  spec.description   = "Line::Bot::API - SDK of the LINE Messaging API for Ruby"
-  spec.summary       = "SDK of the LINE Messaging API"
-  spec.homepage      = "https://github.com/line/line-bot-sdk-ruby"
-  spec.license       = "Apache-2.0"
+  spec.summary = "SDK of the LINE Messaging API for Ruby"
+  spec.description = "SDK of the LINE Messaging API for Ruby"
+  spec.homepage = "https://github.com/line/line-bot-sdk-ruby"
+  spec.license = "Apache-2.0"
 
-  spec.files         = %w(CONTRIBUTING.md LICENSE README.md line-bot-api.gemspec) + Dir['lib/**/*.rb']
-  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.files = %w(CONTRIBUTING.md LICENSE README.md line-bot-api.gemspec) + Dir['lib/**/*.rb'] + Dir['sig/**/*.rbs']
   spec.require_paths = ["lib"]
 
-  spec.required_ruby_version     = '>= 2.4.0'
+  spec.metadata = {
+    "bug_tracker_uri" => "#{spec.homepage}/issues",
+    "changelog_uri" => "#{spec.homepage}/releases",
+    "documentation_uri" => "https://rubydoc.info/gems/#{spec.name}/#{spec.version}",
+    "homepage_uri" => spec.homepage,
+    "source_code_uri" => spec.homepage,
+  }
 
-  spec.add_development_dependency "addressable", "~> 2.3"
-  spec.add_development_dependency 'rake', "~> 13.0"
-  spec.add_development_dependency "rspec", "~> 3.0"
-  spec.add_development_dependency "webmock", "~> 3.8"
+  spec.required_ruby_version = '>= 3.2.0'
+
+  spec.add_runtime_dependency "multipart-post", "~> 2.4"
+
+  # gems that aren't default gems as of Ruby 3.4
+  spec.add_runtime_dependency "base64", "~> 0.2"
 end

data/sig/line/bot/v2/channel_access_token/api/channel_access_token_client.rbs

@@ -0,0 +1,327 @@
+# Channel Access Token API
+# This document describes Channel Access Token API.
+#
+# The version of the OpenAPI document: 0.0.1
+#
+# NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+# https://openapi-generator.tech
+# Do not edit the class manually.
+
+module Line
+  module Bot
+    module V2
+      module ChannelAccessToken
+        class ApiClient
+          @http_client: HttpClient
+          # Initializes a new {Line::Bot::V2::ChannelAccessToken::ApiClient} instance.
+          #
+          # @param base_url [String] The base URL for requests (optional).
+          #   Defaults to 'https://api.line.me' if none is provided.
+          #   You can override this for testing or to use a mock server.
+          # @param http_options [Hash] HTTP options (same as Net::HTTP options).
+          #   See: https://docs.ruby-lang.org/en/3.4/Net/HTTP.html to understand the options.
+          #
+          # @example
+          #   @client ||= Line::Bot::V2::ChannelAccessToken::ApiClient.new(
+          #     http_options: {
+          #       open_timeout: 5,
+          #       read_timeout: 5,
+          #     }
+          #   )
+          def initialize: (
+            ?base_url: String?,
+            ?http_options: Hash[String|Symbol, untyped]
+          ) -> void
+
+          # Gets all valid channel access token key IDs.
+          # This requests to <code>GET https://api.line.me/oauth2/v2.1/tokens/kid</code>
+          # This returns an array containing response, HTTP status code, and header in order. Please specify all header keys in lowercase.
+          #
+          # @param client_assertion_type [String] `urn:ietf:params:oauth:client-assertion-type:jwt-bearer`
+          # @param client_assertion [String] A JSON Web Token (JWT) (opens new window)the client needs to create and sign with the private key.
+          # @see https://developers.line.biz/en/reference/messaging-api/#get-all-valid-channel-access-token-key-ids-v2-1
+          # @return [Array(Line::Bot::V2::ChannelAccessToken::ChannelAccessTokenKeyIdsResponse, Integer, Hash{String => String})] when HTTP status code is 200
+          # @return [Array((String|nil), Integer, Hash{String => String})] when other HTTP status code is returned. String is HTTP response body itself.
+          def gets_all_valid_channel_access_token_key_ids_with_http_info: (
+            client_assertion_type: String, 
+            client_assertion: String
+          ) -> (
+            [ChannelAccessTokenKeyIdsResponse, 200, Hash[untyped, untyped]] # when HTTP status code is 200
+            | [String?, Integer, Hash[untyped, untyped]] # otherwise
+          )
+
+          # Gets all valid channel access token key IDs.
+          # This requests to <code>GET https://api.line.me/oauth2/v2.1/tokens/kid</code>
+          # When you want to get HTTP status code or response headers, use {#gets_all_valid_channel_access_token_key_ids_with_http_info} instead of this.
+          #
+          # @param client_assertion_type [String] `urn:ietf:params:oauth:client-assertion-type:jwt-bearer`
+          # @param client_assertion [String] A JSON Web Token (JWT) (opens new window)the client needs to create and sign with the private key.
+          # @see https://developers.line.biz/en/reference/messaging-api/#get-all-valid-channel-access-token-key-ids-v2-1
+          # @return [Line::Bot::V2::ChannelAccessToken::ChannelAccessTokenKeyIdsResponse] when HTTP status code is 200
+          # @return [String, nil] when other HTTP status code is returned. This String is HTTP response body itself.
+          def gets_all_valid_channel_access_token_key_ids: (
+            client_assertion_type: String, 
+            client_assertion: String
+          ) -> (
+            ChannelAccessTokenKeyIdsResponse # when HTTP status code is 200
+            | String? # otherwise
+          )
+
+          # Issue short-lived channel access token
+          # This requests to <code>POST https://api.line.me/v2/oauth/accessToken</code>
+          # This returns an array containing response, HTTP status code, and header in order. Please specify all header keys in lowercase.
+          #
+          # @param grant_type [String] `client_credentials`
+          # @param client_id [String] Channel ID.
+          # @param client_secret [String] Channel secret.
+          # @see https://developers.line.biz/en/reference/messaging-api/#issue-shortlived-channel-access-token
+          # @return [Array(Line::Bot::V2::ChannelAccessToken::IssueShortLivedChannelAccessTokenResponse, Integer, Hash{String => String})] when HTTP status code is 200
+          # @return [Array(Line::Bot::V2::ChannelAccessToken::ErrorResponse, Integer, Hash{String => String})] when HTTP status code is 400
+          # @return [Array((String|nil), Integer, Hash{String => String})] when other HTTP status code is returned. String is HTTP response body itself.
+          def issue_channel_token_with_http_info: (
+            grant_type: String, 
+            client_id: String, 
+            client_secret: String
+          ) -> (
+            [IssueShortLivedChannelAccessTokenResponse, 200, Hash[untyped, untyped]] # when HTTP status code is 200
+            | [ErrorResponse, 400, Hash[untyped, untyped]] # when HTTP status code is 400
+            | [String?, Integer, Hash[untyped, untyped]] # otherwise
+          )
+
+          # Issue short-lived channel access token
+          # This requests to <code>POST https://api.line.me/v2/oauth/accessToken</code>
+          # When you want to get HTTP status code or response headers, use {#issue_channel_token_with_http_info} instead of this.
+          #
+          # @param grant_type [String] `client_credentials`
+          # @param client_id [String] Channel ID.
+          # @param client_secret [String] Channel secret.
+          # @see https://developers.line.biz/en/reference/messaging-api/#issue-shortlived-channel-access-token
+          # @return [Line::Bot::V2::ChannelAccessToken::IssueShortLivedChannelAccessTokenResponse] when HTTP status code is 200
+          # @return [Line::Bot::V2::ChannelAccessToken::ErrorResponse] when HTTP status code is 400
+          # @return [String, nil] when other HTTP status code is returned. This String is HTTP response body itself.
+          def issue_channel_token: (
+            grant_type: String, 
+            client_id: String, 
+            client_secret: String
+          ) -> (
+            IssueShortLivedChannelAccessTokenResponse # when HTTP status code is 200
+            | ErrorResponse # when HTTP status code is 400
+            | String? # otherwise
+          )
+
+          # Issues a channel access token that allows you to specify a desired expiration date. This method lets you use JWT assertion for authentication.
+          # This requests to <code>POST https://api.line.me/oauth2/v2.1/token</code>
+          # This returns an array containing response, HTTP status code, and header in order. Please specify all header keys in lowercase.
+          #
+          # @param grant_type [String] client_credentials
+          # @param client_assertion_type [String] urn:ietf:params:oauth:client-assertion-type:jwt-bearer
+          # @param client_assertion [String] A JSON Web Token the client needs to create and sign with the private key of the Assertion Signing Key.
+          # @see https://developers.line.biz/en/reference/messaging-api/#issue-channel-access-token-v2-1
+          # @return [Array(Line::Bot::V2::ChannelAccessToken::IssueChannelAccessTokenResponse, Integer, Hash{String => String})] when HTTP status code is 200
+          # @return [Array((String|nil), Integer, Hash{String => String})] when other HTTP status code is returned. String is HTTP response body itself.
+          def issue_channel_token_by_jwt_with_http_info: (
+            grant_type: String, 
+            client_assertion_type: String, 
+            client_assertion: String
+          ) -> (
+            [IssueChannelAccessTokenResponse, 200, Hash[untyped, untyped]] # when HTTP status code is 200
+            | [String?, Integer, Hash[untyped, untyped]] # otherwise
+          )
+
+          # Issues a channel access token that allows you to specify a desired expiration date. This method lets you use JWT assertion for authentication.
+          # This requests to <code>POST https://api.line.me/oauth2/v2.1/token</code>
+          # When you want to get HTTP status code or response headers, use {#issue_channel_token_by_jwt_with_http_info} instead of this.
+          #
+          # @param grant_type [String] client_credentials
+          # @param client_assertion_type [String] urn:ietf:params:oauth:client-assertion-type:jwt-bearer
+          # @param client_assertion [String] A JSON Web Token the client needs to create and sign with the private key of the Assertion Signing Key.
+          # @see https://developers.line.biz/en/reference/messaging-api/#issue-channel-access-token-v2-1
+          # @return [Line::Bot::V2::ChannelAccessToken::IssueChannelAccessTokenResponse] when HTTP status code is 200
+          # @return [String, nil] when other HTTP status code is returned. This String is HTTP response body itself.
+          def issue_channel_token_by_jwt: (
+            grant_type: String, 
+            client_assertion_type: String, 
+            client_assertion: String
+          ) -> (
+            IssueChannelAccessTokenResponse # when HTTP status code is 200
+            | String? # otherwise
+          )
+
+          # Issues a new stateless channel access token, which doesn't have max active token limit unlike the other token types. The newly issued token is only valid for 15 minutes but can not be revoked until it naturally expires. 
+          # This requests to <code>POST https://api.line.me/oauth2/v3/token</code>
+          # This returns an array containing response, HTTP status code, and header in order. Please specify all header keys in lowercase.
+          #
+          # @param grant_type [String, nil] `client_credentials`
+          # @param client_assertion_type [String, nil] URL-encoded value of `urn:ietf:params:oauth:client-assertion-type:jwt-bearer`
+          # @param client_assertion [String, nil] A JSON Web Token the client needs to create and sign with the private key of the Assertion Signing Key.
+          # @param client_id [String, nil] Channel ID.
+          # @param client_secret [String, nil] Channel secret.
+          # @see https://developers.line.biz/en/reference/messaging-api/#issue-stateless-channel-access-token
+          # @return [Array(Line::Bot::V2::ChannelAccessToken::IssueStatelessChannelAccessTokenResponse, Integer, Hash{String => String})] when HTTP status code is 200
+          # @return [Array((String|nil), Integer, Hash{String => String})] when other HTTP status code is returned. String is HTTP response body itself.
+          def issue_stateless_channel_token_with_http_info: (
+            ?grant_type: String?, 
+            ?client_assertion_type: String?, 
+            ?client_assertion: String?, 
+            ?client_id: String?, 
+            ?client_secret: String?
+          ) -> (
+            [IssueStatelessChannelAccessTokenResponse, 200, Hash[untyped, untyped]] # when HTTP status code is 200
+            | [String?, Integer, Hash[untyped, untyped]] # otherwise
+          )
+
+          # Issues a new stateless channel access token, which doesn't have max active token limit unlike the other token types. The newly issued token is only valid for 15 minutes but can not be revoked until it naturally expires. 
+          # This requests to <code>POST https://api.line.me/oauth2/v3/token</code>
+          # When you want to get HTTP status code or response headers, use {#issue_stateless_channel_token_with_http_info} instead of this.
+          #
+          # @param grant_type [String, nil] `client_credentials`
+          # @param client_assertion_type [String, nil] URL-encoded value of `urn:ietf:params:oauth:client-assertion-type:jwt-bearer`
+          # @param client_assertion [String, nil] A JSON Web Token the client needs to create and sign with the private key of the Assertion Signing Key.
+          # @param client_id [String, nil] Channel ID.
+          # @param client_secret [String, nil] Channel secret.
+          # @see https://developers.line.biz/en/reference/messaging-api/#issue-stateless-channel-access-token
+          # @return [Line::Bot::V2::ChannelAccessToken::IssueStatelessChannelAccessTokenResponse] when HTTP status code is 200
+          # @return [String, nil] when other HTTP status code is returned. This String is HTTP response body itself.
+          def issue_stateless_channel_token: (
+            ?grant_type: String?, 
+            ?client_assertion_type: String?, 
+            ?client_assertion: String?, 
+            ?client_id: String?, 
+            ?client_secret: String?
+          ) -> (
+            IssueStatelessChannelAccessTokenResponse # when HTTP status code is 200
+            | String? # otherwise
+          )
+
+          # Revoke short-lived or long-lived channel access token
+          # This requests to <code>POST https://api.line.me/v2/oauth/revoke</code>
+          # This returns an array containing response, HTTP status code, and header in order. Please specify all header keys in lowercase.
+          #
+          # @param access_token [String] Channel access token
+          # @see https://developers.line.biz/en/reference/messaging-api/#revoke-longlived-or-shortlived-channel-access-token
+          # @return [Array((String|nil), Integer, Hash{String => String})] when HTTP status code is 200
+          # @return [Array((String|nil), Integer, Hash{String => String})] when other HTTP status code is returned. String is HTTP response body itself.
+          def revoke_channel_token_with_http_info: (
+            access_token: String
+          ) -> (
+            [String?, 200, Hash[untyped, untyped]] # when HTTP status code is 200
+            | [String?, Integer, Hash[untyped, untyped]] # otherwise
+          )
+
+          # Revoke short-lived or long-lived channel access token
+          # This requests to <code>POST https://api.line.me/v2/oauth/revoke</code>
+          # When you want to get HTTP status code or response headers, use {#revoke_channel_token_with_http_info} instead of this.
+          #
+          # @param access_token [String] Channel access token
+          # @see https://developers.line.biz/en/reference/messaging-api/#revoke-longlived-or-shortlived-channel-access-token
+          # @return [String, nil] when HTTP status code is 200
+          # @return [String, nil] when other HTTP status code is returned. This String is HTTP response body itself.
+          def revoke_channel_token: (
+            access_token: String
+          ) -> (
+            String? # when HTTP status code is 200
+            | String? # otherwise
+          )
+
+          # Revoke channel access token v2.1
+          # This requests to <code>POST https://api.line.me/oauth2/v2.1/revoke</code>
+          # This returns an array containing response, HTTP status code, and header in order. Please specify all header keys in lowercase.
+          #
+          # @param client_id [String] Channel ID
+          # @param client_secret [String] Channel Secret
+          # @param access_token [String] Channel access token
+          # @see https://developers.line.biz/en/reference/messaging-api/#revoke-channel-access-token-v2-1
+          # @return [Array((String|nil), Integer, Hash{String => String})] when HTTP status code is 200
+          # @return [Array((String|nil), Integer, Hash{String => String})] when other HTTP status code is returned. String is HTTP response body itself.
+          def revoke_channel_token_by_jwt_with_http_info: (
+            client_id: String, 
+            client_secret: String, 
+            access_token: String
+          ) -> (
+            [String?, 200, Hash[untyped, untyped]] # when HTTP status code is 200
+            | [String?, Integer, Hash[untyped, untyped]] # otherwise
+          )
+
+          # Revoke channel access token v2.1
+          # This requests to <code>POST https://api.line.me/oauth2/v2.1/revoke</code>
+          # When you want to get HTTP status code or response headers, use {#revoke_channel_token_by_jwt_with_http_info} instead of this.
+          #
+          # @param client_id [String] Channel ID
+          # @param client_secret [String] Channel Secret
+          # @param access_token [String] Channel access token
+          # @see https://developers.line.biz/en/reference/messaging-api/#revoke-channel-access-token-v2-1
+          # @return [String, nil] when HTTP status code is 200
+          # @return [String, nil] when other HTTP status code is returned. This String is HTTP response body itself.
+          def revoke_channel_token_by_jwt: (
+            client_id: String, 
+            client_secret: String, 
+            access_token: String
+          ) -> (
+            String? # when HTTP status code is 200
+            | String? # otherwise
+          )
+
+          # Verify the validity of short-lived and long-lived channel access tokens
+          # This requests to <code>POST https://api.line.me/v2/oauth/verify</code>
+          # This returns an array containing response, HTTP status code, and header in order. Please specify all header keys in lowercase.
+          #
+          # @param access_token [String] A short-lived or long-lived channel access token.
+          # @see https://developers.line.biz/en/reference/messaging-api/#verify-channel-access-token
+          # @return [Array(Line::Bot::V2::ChannelAccessToken::VerifyChannelAccessTokenResponse, Integer, Hash{String => String})] when HTTP status code is 200
+          # @return [Array((String|nil), Integer, Hash{String => String})] when other HTTP status code is returned. String is HTTP response body itself.
+          def verify_channel_token_with_http_info: (
+            access_token: String
+          ) -> (
+            [VerifyChannelAccessTokenResponse, 200, Hash[untyped, untyped]] # when HTTP status code is 200
+            | [String?, Integer, Hash[untyped, untyped]] # otherwise
+          )
+
+          # Verify the validity of short-lived and long-lived channel access tokens
+          # This requests to <code>POST https://api.line.me/v2/oauth/verify</code>
+          # When you want to get HTTP status code or response headers, use {#verify_channel_token_with_http_info} instead of this.
+          #
+          # @param access_token [String] A short-lived or long-lived channel access token.
+          # @see https://developers.line.biz/en/reference/messaging-api/#verify-channel-access-token
+          # @return [Line::Bot::V2::ChannelAccessToken::VerifyChannelAccessTokenResponse] when HTTP status code is 200
+          # @return [String, nil] when other HTTP status code is returned. This String is HTTP response body itself.
+          def verify_channel_token: (
+            access_token: String
+          ) -> (
+            VerifyChannelAccessTokenResponse # when HTTP status code is 200
+            | String? # otherwise
+          )
+
+          # You can verify whether a Channel access token with a user-specified expiration (Channel Access Token v2.1) is valid.
+          # This requests to <code>GET https://api.line.me/oauth2/v2.1/verify</code>
+          # This returns an array containing response, HTTP status code, and header in order. Please specify all header keys in lowercase.
+          #
+          # @param access_token [String] Channel access token with a user-specified expiration (Channel Access Token v2.1).
+          # @see https://developers.line.biz/en/reference/messaging-api/#verify-channel-access-token-v2-1
+          # @return [Array(Line::Bot::V2::ChannelAccessToken::VerifyChannelAccessTokenResponse, Integer, Hash{String => String})] when HTTP status code is 200
+          # @return [Array((String|nil), Integer, Hash{String => String})] when other HTTP status code is returned. String is HTTP response body itself.
+          def verify_channel_token_by_jwt_with_http_info: (
+            access_token: String
+          ) -> (
+            [VerifyChannelAccessTokenResponse, 200, Hash[untyped, untyped]] # when HTTP status code is 200
+            | [String?, Integer, Hash[untyped, untyped]] # otherwise
+          )
+
+          # You can verify whether a Channel access token with a user-specified expiration (Channel Access Token v2.1) is valid.
+          # This requests to <code>GET https://api.line.me/oauth2/v2.1/verify</code>
+          # When you want to get HTTP status code or response headers, use {#verify_channel_token_by_jwt_with_http_info} instead of this.
+          #
+          # @param access_token [String] Channel access token with a user-specified expiration (Channel Access Token v2.1).
+          # @see https://developers.line.biz/en/reference/messaging-api/#verify-channel-access-token-v2-1
+          # @return [Line::Bot::V2::ChannelAccessToken::VerifyChannelAccessTokenResponse] when HTTP status code is 200
+          # @return [String, nil] when other HTTP status code is returned. This String is HTTP response body itself.
+          def verify_channel_token_by_jwt: (
+            access_token: String
+          ) -> (
+            VerifyChannelAccessTokenResponse # when HTTP status code is 200
+            | String? # otherwise
+          )
+        end
+      end
+    end
+  end
+end