Class: Line::Bot::Client

Inherits:
Object
  • Object
show all
Defined in:
lib/line/bot/client.rb

Overview

API Client of LINE Bot SDK Ruby

@client ||= Line::Bot::Client.new do |config|
  config.channel_id = ENV["LINE_CHANNEL_ID"]
  config.channel_secret = ENV["LINE_CHANNEL_SECRET"]
  config.channel_token = ENV["LINE_CHANNEL_TOKEN"]
end

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(options = {}) {|_self| ... } ⇒ Line::Bot::Client

Initialize a new client.

Parameters:

  • options (Hash) (defaults to: {})

Yields:

  • (_self)

Yield Parameters:



43
44
45
46
47
48
 
# File 'lib/line/bot/client.rb', line 43

def initialize(options = {})
  options.each do |key, value|
    instance_variable_set("@#{key}", value)
  end
  yield(self) if block_given?
end

Instance Attribute Details

#blob_endpoint ⇒ Object

@return [String]



31
32
33
 
# File 'lib/line/bot/client.rb', line 31

def blob_endpoint
  @blob_endpoint
end

#channel_id ⇒ Object

@return [String]



31
32
33
 
# File 'lib/line/bot/client.rb', line 31

def channel_id
  @channel_id
end

#channel_secret ⇒ Object

@return [String]



31
32
33
 
# File 'lib/line/bot/client.rb', line 31

def channel_secret
  @channel_secret
end

#channel_token ⇒ Object

@return [String]



31
32
33
 
# File 'lib/line/bot/client.rb', line 31

def channel_token
  @channel_token
end

#endpoint ⇒ Object

@return [String]



31
32
33
 
# File 'lib/line/bot/client.rb', line 31

def endpoint
  @endpoint
end

#http_options ⇒ Hash

Returns:

  • (Hash) 


37
38
39
 
# File 'lib/line/bot/client.rb', line 37

def http_options
  @http_options
end

#httpclient ⇒ Object

Returns:

  • (Object) 


34
35
36
 
# File 'lib/line/bot/client.rb', line 34

def httpclient
  @httpclient
end

Instance Method Details

#broadcast(messages, headers: {}) ⇒ Net::HTTPResponse

Send messages to all friends.

Parameters:

  • messages (Hash or Array) —

    Message Objects

  • headers (Hash) (defaults to: {}) —

    HTTP Headers

Returns:

  • (Net::HTTPResponse) 


282
283
284
285
286
287
288
289
290
 
# File 'lib/line/bot/client.rb', line 282

def broadcast(messages, headers: {})
  channel_token_required

  messages = [messages] if messages.is_a?(Hash)

  endpoint_path = '/bot/message/broadcast'
  payload = { messages: messages }.to_json
  post(endpoint, endpoint_path, payload, credentials.merge(headers))
end

#bulk_link_rich_menus(user_ids, rich_menu_id) ⇒ Net::HTTPResponse

To link a rich menu to multiple users at a time

Parameters:

  • user_ids (Array) —

    ID of the user

  • rich_menu_id (String) —

    ID of the uploaded rich menu

Returns:

  • (Net::HTTPResponse) 


700
701
702
703
704
705
 
# File 'lib/line/bot/client.rb', line 700

def bulk_link_rich_menus(user_ids, rich_menu_id)
  channel_token_required

  endpoint_path = "/bot/richmenu/bulk/link"
  post(endpoint, endpoint_path, { richMenuId: rich_menu_id, userIds: user_ids }.to_json, credentials)
end

#bulk_unlink_rich_menus(user_ids) ⇒ Net::HTTPResponse

To unlink a rich menu from multiple users at a time

Parameters:

  • user_ids (Array) —

    ID of the user

Returns:

  • (Net::HTTPResponse) 


712
713
714
715
716
717
 
# File 'lib/line/bot/client.rb', line 712

def bulk_unlink_rich_menus(user_ids)
  channel_token_required

  endpoint_path = "/bot/richmenu/bulk/unlink"
  post(endpoint, endpoint_path, { userIds: user_ids }.to_json, credentials)
end

#create_click_audience(params) ⇒ Net::HTTPResponse

Create an audience group of users that clicked a URL in a message sent in the past

Parameters are described here. developers.line.biz/en/reference/messaging-api/#create-click-audience-group

Parameters:

  • params (Hash) —

    options

Returns:

  • (Net::HTTPResponse) —

    This response includes an audience_group_id.



939
940
941
942
943
944
 
# File 'lib/line/bot/client.rb', line 939

def create_click_audience(params)
  channel_token_required

  endpoint_path = '/bot/audienceGroup/click'
  post(endpoint, endpoint_path, params.to_json, credentials)
end

#create_impression_audience(params) ⇒ Net::HTTPResponse

Create an audience group of users that opened a message sent in the past

Parameters are described here. developers.line.biz/en/reference/messaging-api/#create-imp-audience-group

Parameters:

  • params (Hash) —

    options

Returns:

  • (Net::HTTPResponse) —

    This response includes an audience_group_id.



954
955
956
957
958
959
 
# File 'lib/line/bot/client.rb', line 954

def create_impression_audience(params)
  channel_token_required

  endpoint_path = '/bot/audienceGroup/imp'
  post(endpoint, endpoint_path, params.to_json, credentials)
end

#create_liff_app(app) ⇒ Object 



880
881
882
883
884
885
 
# File 'lib/line/bot/client.rb', line 880

def create_liff_app(app)
  channel_token_required

  endpoint_path = '/apps'
  post(liff_endpoint, endpoint_path, app.to_json, credentials)
end

#create_link_token(user_id) ⇒ Net::HTTPResponse

Issue a link token to a user

Parameters:

  • user_id (String) —

    ID of the user

Returns:

  • (Net::HTTPResponse) 


750
751
752
753
754
755
 
# File 'lib/line/bot/client.rb', line 750

def create_link_token(user_id)
  channel_token_required

  endpoint_path = "/bot/user/#{user_id}/linkToken"
  post(endpoint, endpoint_path, nil, credentials)
end

#create_rich_menu(rich_menu) ⇒ Net::HTTPResponse

Create a rich menu

Parameters:

  • rich_menu (Hash) —

    The rich menu represented as a rich menu object

Returns:

  • (Net::HTTPResponse) 


543
544
545
546
547
548
 
# File 'lib/line/bot/client.rb', line 543

def create_rich_menu(rich_menu)
  channel_token_required

  endpoint_path = '/bot/richmenu'
  post(endpoint, endpoint_path, rich_menu.to_json, credentials)
end

#create_rich_menu_image(rich_menu_id, file) ⇒ Net::HTTPResponse

Upload and attaches an image to a rich menu

Parameters:

  • rich_menu_id (String) —

    The ID of the rich menu to attach the image to

  • file (File) —

    Image file to attach rich menu

Returns:

  • (Net::HTTPResponse) 


737
738
739
740
741
742
743
 
# File 'lib/line/bot/client.rb', line 737

def create_rich_menu_image(rich_menu_id, file)
  channel_token_required

  endpoint_path = "/bot/richmenu/#{rich_menu_id}/content"
  headers = credentials.merge('Content-Type' => content_type(file))
  post(blob_endpoint, endpoint_path, file.rewind && file.read, headers)
end

#create_user_id_audience(params) ⇒ Net::HTTPResponse

Create an audience group by uploading user_ids

Parameters are described here. developers.line.biz/en/reference/messaging-api/#create-upload-audience-group

Parameters:

  • params (Hash) —

    options

Returns:

  • (Net::HTTPResponse) —

    This response includes an audience_group_id.



909
910
911
912
913
914
 
# File 'lib/line/bot/client.rb', line 909

def create_user_id_audience(params)
  channel_token_required

  endpoint_path = '/bot/audienceGroup/upload'
  post(endpoint, endpoint_path, params.to_json, credentials)
end

#credentials ⇒ Hash

Returns:

  • (Hash) 


78
79
80
81
82
 
# File 'lib/line/bot/client.rb', line 78

def credentials
  {
    "Authorization" => "Bearer #{channel_token}",
  }
end

#delete(endpoint_base, endpoint_path, headers = {}) ⇒ Net::HTTPResponse

Delete content of specified URL.

Parameters:

  • endpoint_base (String)
  • endpoint_path (String)
  • headers (Hash) (defaults to: {})

Returns:

  • (Net::HTTPResponse) 


1133
1134
1135
1136
 
# File 'lib/line/bot/client.rb', line 1133

def delete(endpoint_base, endpoint_path, headers = {})
  headers = API::DEFAULT_HEADERS.merge(headers)
  httpclient.delete(endpoint_base + endpoint_path, headers)
end

#delete_audience(audience_group_id) ⇒ Net::HTTPResponse

Delete an existing audience group

Parameters are described here. developers.line.biz/en/reference/messaging-api/#delete-audience-group

Parameters:

  • audience_group_id (Integer)

Returns:

  • (Net::HTTPResponse) 


983
984
985
986
987
988
 
# File 'lib/line/bot/client.rb', line 983

def delete_audience(audience_group_id)
  channel_token_required

  endpoint_path = "/bot/audienceGroup/#{audience_group_id}"
  delete(endpoint, endpoint_path, credentials)
end

#delete_liff_app(liff_id) ⇒ Object 



894
895
896
897
898
899
 
# File 'lib/line/bot/client.rb', line 894

def delete_liff_app(liff_id)
  channel_token_required

  endpoint_path = "/apps/#{liff_id}"
  delete(liff_endpoint, endpoint_path, credentials)
end

#delete_rich_menu(rich_menu_id) ⇒ Net::HTTPResponse

Delete a rich menu

Parameters:

  • rich_menu_id (String) —

    ID of an uploaded rich menu

Returns:

  • (Net::HTTPResponse) 


555
556
557
558
559
560
 
# File 'lib/line/bot/client.rb', line 555

def delete_rich_menu(rich_menu_id)
  channel_token_required

  endpoint_path = "/bot/richmenu/#{rich_menu_id}"
  delete(endpoint, endpoint_path, credentials)
end

#get(endpoint_base, endpoint_path, headers = {}) ⇒ Net::HTTPResponse

Fetch data, get content of specified URL.

Parameters:

  • endpoint_base (String)
  • endpoint_path (String)
  • headers (Hash) (defaults to: {})

Returns:

  • (Net::HTTPResponse) 


1095
1096
1097
1098
 
# File 'lib/line/bot/client.rb', line 1095

def get(endpoint_base, endpoint_path, headers = {})
  headers = API::DEFAULT_HEADERS.merge(headers)
  httpclient.get(endpoint_base + endpoint_path, headers)
end

#get_aggregation_info ⇒ Net::HTTPResponse

Get the number of aggregation units used this month.

Returns:

  • (Net::HTTPResponse) 


1067
1068
1069
1070
1071
1072
 
# File 'lib/line/bot/client.rb', line 1067

def get_aggregation_info
  channel_token_required

  endpoint_path = "/bot/message/aggregation/info"
  get(endpoint, endpoint_path, credentials)
end

#get_aggregation_list(limit: nil, start: nil) ⇒ Net::HTTPResponse

Get the name list of units used this month for statistics aggregation.

Parameters:

  • limit (Integer) (defaults to: nil) —

    Maximum number of aggregation units per request. Maximum: 100, Default: 100.

  • start (String) (defaults to: nil) —

    Value of the continuation token found in the ‘next` property of the JSON object returned in the response.

Returns:

  • (Net::HTTPResponse) 


1080
1081
1082
1083
1084
1085
1086
 
# File 'lib/line/bot/client.rb', line 1080

def get_aggregation_list(limit: nil, start: nil)
  channel_token_required

  params = {limit: limit, start: start}.compact
  endpoint_path = "/bot/message/aggregation/list?" + URI.encode_www_form(params)
  get(endpoint, endpoint_path, credentials)
end

#get_audience(audience_group_id) ⇒ Net::HTTPResponse

Get audience group data

Parameters are described here. developers.line.biz/en/reference/messaging-api/#get-audience-group

Parameters:

  • audience_group_id (Integer)

Returns:

  • (Net::HTTPResponse) 


998
999
1000
1001
1002
1003
 
# File 'lib/line/bot/client.rb', line 998

def get_audience(audience_group_id)
  channel_token_required

  endpoint_path = "/bot/audienceGroup/#{audience_group_id}"
  get(endpoint, endpoint_path, credentials)
end

#get_audience_authority_level ⇒ Net::HTTPResponse

Get the authority level of the audience

Parameters are described here. developers.line.biz/en/reference/messaging-api/#get-authority-level

Returns:

  • (Net::HTTPResponse) 


1026
1027
1028
1029
1030
1031
 
# File 'lib/line/bot/client.rb', line 1026

def get_audience_authority_level
  channel_token_required

  endpoint_path = "/bot/audienceGroup/authorityLevel"
  get(endpoint, endpoint_path, credentials)
end

#get_audiences(params) ⇒ Net::HTTPResponse

Get data for more than one audience group

Parameters are described here. developers.line.biz/en/reference/messaging-api/#get-audience-groups

Parameters:

  • params (Hash) —

    key name ‘page` is required

Returns:

  • (Net::HTTPResponse) 


1013
1014
1015
1016
1017
1018
 
# File 'lib/line/bot/client.rb', line 1013

def get_audiences(params)
  channel_token_required

  endpoint_path = "/bot/audienceGroup/list?" + URI.encode_www_form(params)
  get(endpoint, endpoint_path, credentials)
end

#get_bot_info ⇒ Net::HTTPResponse

Gets a bot’s basic information.

Returns:

  • (Net::HTTPResponse) 


826
827
828
829
830
831
 
# File 'lib/line/bot/client.rb', line 826

def get_bot_info
  channel_token_required

  endpoint_path = '/bot/info'
  get(endpoint, endpoint_path, credentials)
end

#get_channel_access_token_key_ids_jwt(jwt) ⇒ Net::HTTPResponse

Get all valid channel access token key IDs v2.1

Parameters:

  • jwt (String)

Returns:

  • (Net::HTTPResponse) 


187
188
189
190
191
192
193
194
195
196
 
# File 'lib/line/bot/client.rb', line 187

def get_channel_access_token_key_ids_jwt(jwt)
  payload = URI.encode_www_form(
    client_assertion_type: 'urn:ietf:params:oauth:client-assertion-type:jwt-bearer',
    client_assertion: jwt
  )
  endpoint_path = "/oauth2/v2.1/tokens/kid?#{payload}"

  headers = { 'Content-Type' => 'application/x-www-form-urlencoded' }
  get(oauth_endpoint, endpoint_path, headers)
end

#get_default_rich_menu ⇒ Net::HTTPResponse

Get default rich menu

Returns:

  • (Net::HTTPResponse) 


577
578
579
580
581
582
 
# File 'lib/line/bot/client.rb', line 577

def get_default_rich_menu
  channel_token_required

  endpoint_path = '/bot/user/all/richmenu'
  get(endpoint, endpoint_path, credentials)
end

#get_follower_ids(deprecated_continuation_token = nil, start: nil, limit: nil) ⇒ Net::HTTPResponse

Get user IDs of who added your LINE Official Account as a friend

Parameters:

  • start (String) (defaults to: nil) —

    Identifier to return next page (next property to be included in the response)

  • limit (Integer) (defaults to: nil) —

    The maximum number of user IDs to retrieve in a single request

Returns:

  • (Net::HTTPResponse) 


387
388
389
390
391
392
393
394
395
396
397
398
399
400
 
# File 'lib/line/bot/client.rb', line 387

def get_follower_ids(deprecated_continuation_token = nil, start: nil, limit: nil)
  channel_token_required

  if deprecated_continuation_token
    warn "continuation_token as the first argument is deprecated. Please use :start instead."
    start = deprecated_continuation_token
  end

  params = { start: start, limit: limit }.compact

  endpoint_path = "/bot/followers/ids"
  endpoint_path += "?" + URI.encode_www_form(params) unless params.empty?
  get(endpoint, endpoint_path, credentials)
end

#get_friend_demographics ⇒ Net::HTTPResponse

Get the demographic attributes for a bot’s friends.

Returns:

  • (Net::HTTPResponse) 


816
817
818
819
820
821
 
# File 'lib/line/bot/client.rb', line 816

def get_friend_demographics
  channel_token_required

  endpoint_path = '/bot/insight/demographic'
  get(endpoint, endpoint_path, credentials)
end

#get_group_member_ids(group_id, continuation_token = nil) ⇒ Net::HTTPResponse

Get user IDs of a group

Parameters:

  • group_id (String) —

    Group’s identifier

  • continuation_token (String) (defaults to: nil) —

    Identifier to return next page (next property to be included in the response)

Returns:

  • (Net::HTTPResponse) 


409
410
411
412
413
414
415
 
# File 'lib/line/bot/client.rb', line 409

def get_group_member_ids(group_id, continuation_token = nil)
  channel_token_required

  endpoint_path = "/bot/group/#{group_id}/members/ids"
  endpoint_path += "?start=#{continuation_token}" if continuation_token
  get(endpoint, endpoint_path, credentials)
end

#get_group_member_profile(group_id, user_id) ⇒ Net::HTTPResponse

Get an user’s profile of a group.

Parameters:

  • group_id (String) —

    Group’s identifier

  • user_id (String) —

    User Id user_id

Returns:

  • (Net::HTTPResponse) 


361
362
363
364
365
366
 
# File 'lib/line/bot/client.rb', line 361

def get_group_member_profile(group_id, user_id)
  channel_token_required

  endpoint_path = "/bot/group/#{group_id}/member/#{user_id}"
  get(endpoint, endpoint_path, credentials)
end

#get_group_members_count(group_id) ⇒ Net::HTTPResponse

Gets the user IDs of the members of a group that the bot is in.

Parameters:

  • group_id (String) —

    Group’s identifier

Returns:

  • (Net::HTTPResponse) 


449
450
451
452
453
454
 
# File 'lib/line/bot/client.rb', line 449

def get_group_members_count(group_id)
  channel_token_required

  endpoint_path = "/bot/group/#{group_id}/members/count"
  get(endpoint, endpoint_path, credentials)
end

#get_group_summary(group_id) ⇒ Net::HTTPResponse

Gets the group ID, group name, and group icon URL of a group where the LINE Official Account is a member.

Parameters:

  • group_id (String) —

    Group’s identifier

Returns:

  • (Net::HTTPResponse) 


437
438
439
440
441
442
 
# File 'lib/line/bot/client.rb', line 437

def get_group_summary(group_id)
  channel_token_required

  endpoint_path = "/bot/group/#{group_id}/summary"
  get(endpoint, endpoint_path, credentials)
end

#get_liff_apps ⇒ Object 



873
874
875
876
877
878
 
# File 'lib/line/bot/client.rb', line 873

def get_liff_apps
  channel_token_required

  endpoint_path = '/apps'
  get(liff_endpoint, endpoint_path, credentials)
end

#get_message_content(identifier) ⇒ Net::HTTPResponse

Get message content.

Parameters:

  • identifier (String) —

    Message’s identifier

Returns:

  • (Net::HTTPResponse) 


337
338
339
340
341
342
 
# File 'lib/line/bot/client.rb', line 337

def get_message_content(identifier)
  channel_token_required

  endpoint_path = "/bot/message/#{identifier}/content"
  get(blob_endpoint, endpoint_path, credentials)
end

#get_message_delivery_broadcast(date) ⇒ Net::HTTPResponse

Gets the number of messages sent with the /bot/message/multicast endpoint.

Parameters:

  • date (String) —

    Date the messages were sent (format: yyyyMMdd)

Returns:

  • (Net::HTTPResponse) 


531
532
533
534
535
536
 
# File 'lib/line/bot/client.rb', line 531

def get_message_delivery_broadcast(date)
  channel_token_required

  endpoint_path = "/bot/message/delivery/broadcast?date=#{date}"
  get(endpoint, endpoint_path, credentials)
end

#get_message_delivery_multicast(date) ⇒ Net::HTTPResponse

Gets the number of messages sent with the /bot/message/multicast endpoint.

Parameters:

  • date (String) —

    Date the messages were sent (format: yyyyMMdd)

Returns:

  • (Net::HTTPResponse) 


519
520
521
522
523
524
 
# File 'lib/line/bot/client.rb', line 519

def get_message_delivery_multicast(date)
  channel_token_required

  endpoint_path = "/bot/message/delivery/multicast?date=#{date}"
  get(endpoint, endpoint_path, credentials)
end

#get_message_delivery_push(date) ⇒ Net::HTTPResponse

Gets the number of messages sent with the /bot/message/push endpoint.

Parameters:

  • date (String) —

    Date the messages were sent (format: yyyyMMdd)

Returns:

  • (Net::HTTPResponse) 


507
508
509
510
511
512
 
# File 'lib/line/bot/client.rb', line 507

def get_message_delivery_push(date)
  channel_token_required

  endpoint_path = "/bot/message/delivery/push?date=#{date}"
  get(endpoint, endpoint_path, credentials)
end

#get_message_delivery_reply(date) ⇒ Net::HTTPResponse

Gets the number of messages sent with the /bot/message/reply endpoint.

Parameters:

  • date (String) —

    Date the messages were sent (format: yyyyMMdd)

Returns:

  • (Net::HTTPResponse) 


495
496
497
498
499
500
 
# File 'lib/line/bot/client.rb', line 495

def get_message_delivery_reply(date)
  channel_token_required

  endpoint_path = "/bot/message/delivery/reply?date=#{date}"
  get(endpoint, endpoint_path, credentials)
end

#get_number_of_followers(date) ⇒ Net::HTTPResponse

Returns the number of followers

Parameters:

  • date (String) —

    (Format:yyyyMMdd, Example:20191231)

Returns:

  • (Net::HTTPResponse) 


806
807
808
809
810
811
 
# File 'lib/line/bot/client.rb', line 806

def get_number_of_followers(date)
  channel_token_required

  endpoint_path = "/bot/insight/followers?date=#{date}"
  get(endpoint, endpoint_path, credentials)
end

#get_number_of_message_deliveries(date) ⇒ Net::HTTPResponse

Returns the number of messages sent on a specified day

Parameters:

  • date (String) —

    (Format:yyyyMMdd, Example:20191231)

Returns:

  • (Net::HTTPResponse) 


782
783
784
785
786
787
 
# File 'lib/line/bot/client.rb', line 782

def get_number_of_message_deliveries(date)
  channel_token_required

  endpoint_path = "/bot/insight/message/delivery?date=#{date}"
  get(endpoint, endpoint_path, credentials)
end

#get_profile(user_id) ⇒ Net::HTTPResponse

Get an user’s profile.

Parameters:

  • user_id (String) —

    User Id user_id

Returns:

  • (Net::HTTPResponse) 


348
349
350
351
352
353
 
# File 'lib/line/bot/client.rb', line 348

def get_profile(user_id)
  channel_token_required

  endpoint_path = "/bot/profile/#{user_id}"
  get(endpoint, endpoint_path, credentials)
end

#get_profile_by_access_token(access_token) ⇒ Net::HTTPResponse

Get user profile by access token

Parameters:

  • access_token (String) —

    access token

Returns:

  • (Net::HTTPResponse) 


203
204
205
206
207
208
209
 
# File 'lib/line/bot/client.rb', line 203

def get_profile_by_access_token(access_token)
  headers = {
    "Authorization" => "Bearer #{access_token}",
  }
  endpoint_path = "/v2/profile"
  get(oauth_endpoint, endpoint_path, headers)
end

#get_quota ⇒ Net::HTTPResponse

Get the target limit for additional messages

Returns:

  • (Net::HTTPResponse) 


760
761
762
763
764
765
 
# File 'lib/line/bot/client.rb', line 760

def get_quota
  channel_token_required

  endpoint_path = "/bot/message/quota"
  get(endpoint, endpoint_path, credentials)
end

#get_quota_consumption ⇒ Net::HTTPResponse

Get number of messages sent this month

Returns:

  • (Net::HTTPResponse) 


770
771
772
773
774
775
 
# File 'lib/line/bot/client.rb', line 770

def get_quota_consumption
  channel_token_required

  endpoint_path = "/bot/message/quota/consumption"
  get(endpoint, endpoint_path, credentials)
end

#get_rich_menu(rich_menu_id) ⇒ Net::HTTPResponse

Get a rich menu via a rich menu ID

Parameters:

  • rich_menu_id (String) —

    ID of an uploaded rich menu

Returns:

  • (Net::HTTPResponse) 


483
484
485
486
487
488
 
# File 'lib/line/bot/client.rb', line 483

def get_rich_menu(rich_menu_id)
  channel_token_required

  endpoint_path = "/bot/richmenu/#{rich_menu_id}"
  get(endpoint, endpoint_path, credentials)
end

#get_rich_menu_image(rich_menu_id) ⇒ Net::HTTPResponse

Download an image associated with a rich menu

Parameters:

  • rich_menu_id (String) —

    ID of an uploaded rich menu

Returns:

  • (Net::HTTPResponse) 


724
725
726
727
728
729
 
# File 'lib/line/bot/client.rb', line 724

def get_rich_menu_image(rich_menu_id)
  channel_token_required

  endpoint_path = "/bot/richmenu/#{rich_menu_id}/content"
  get(blob_endpoint, endpoint_path, credentials)
end

#get_rich_menus ⇒ Net::HTTPResponse

Get a list of all uploaded rich menus

Returns:

  • (Net::HTTPResponse) 


471
472
473
474
475
476
 
# File 'lib/line/bot/client.rb', line 471

def get_rich_menus
  channel_token_required

  endpoint_path = '/bot/richmenu/list'
  get(endpoint, endpoint_path, credentials)
end

#get_rich_menus_alias(rich_menu_alias_id) ⇒ Net::HTTPResponse

Get a rich menu alias via a rich menu alias ID

Parameters:

  • rich_menu_alias_id (String) —

    string of alias words rich menu

Returns:

  • (Net::HTTPResponse) 


649
650
651
652
653
654
 
# File 'lib/line/bot/client.rb', line 649

def get_rich_menus_alias(rich_menu_alias_id)
  channel_token_required

  endpoint_path = "/bot/richmenu/alias/#{rich_menu_alias_id}"
  get(endpoint, endpoint_path, credentials)
end

#get_rich_menus_alias_list ⇒ Net::HTTPResponse

Get a list of all uploaded rich menus alias

Returns:

  • (Net::HTTPResponse) 


659
660
661
662
663
664
 
# File 'lib/line/bot/client.rb', line 659

def get_rich_menus_alias_list
  channel_token_required

  endpoint_path = "/bot/richmenu/alias/list"
  get(endpoint, endpoint_path, credentials)
end

#get_room_member_ids(room_id, continuation_token = nil) ⇒ Net::HTTPResponse

Get user IDs of a room

Parameters:

  • room_id (String) —

    Room’s identifier

  • continuation_token (String) (defaults to: nil) —

    Identifier to return next page (next property to be included in the response)

Returns:

  • (Net::HTTPResponse) 


424
425
426
427
428
429
430
 
# File 'lib/line/bot/client.rb', line 424

def get_room_member_ids(room_id, continuation_token = nil)
  channel_token_required

  endpoint_path = "/bot/room/#{room_id}/members/ids"
  endpoint_path += "?start=#{continuation_token}" if continuation_token
  get(endpoint, endpoint_path, credentials)
end

#get_room_member_profile(room_id, user_id) ⇒ Net::HTTPResponse

Get an user’s profile of a room.

Parameters:

  • room_id (String) —

    Room’s identifier

  • user_id (String) —

    User Id user_id

Returns:

  • (Net::HTTPResponse) 


374
375
376
377
378
379
 
# File 'lib/line/bot/client.rb', line 374

def get_room_member_profile(room_id, user_id)
  channel_token_required

  endpoint_path = "/bot/room/#{room_id}/member/#{user_id}"
  get(endpoint, endpoint_path, credentials)
end

#get_room_members_count(room_id) ⇒ Net::HTTPResponse

Gets the count of members in a room.

Parameters:

  • room_id (String) —

    Room’s identifier

Returns:

  • (Net::HTTPResponse) 


461
462
463
464
465
466
 
# File 'lib/line/bot/client.rb', line 461

def get_room_members_count(room_id)
  channel_token_required

  endpoint_path = "/bot/room/#{room_id}/members/count"
  get(endpoint, endpoint_path, credentials)
end

#get_statistics_per_unit(unit:, from:, to:) ⇒ Net::HTTPResponse

Get the per-unit statistics of how users interact with push messages and multicast messages.

Parameters:

  • unit (String) —

    Case-sensitive name of aggregation unit specified when sending the message.

  • from (String) —

    Start date of aggregation period in UTC+9 with ‘yyyyMMdd` format

  • to (String) —

    End date of aggregation period in UTC+9 with ‘yyyyMMdd` format.

Returns:

  • (Net::HTTPResponse) 


1056
1057
1058
1059
1060
1061
1062
 
# File 'lib/line/bot/client.rb', line 1056

def get_statistics_per_unit(unit:, from:, to:)
  channel_token_required

  params = {customAggregationUnit: unit, from: from, to: to}
  endpoint_path = "/bot/insight/message/event/aggregation?" + URI.encode_www_form(params)
  get(endpoint, endpoint_path, credentials)
end

#get_user_interaction_statistics(request_id) ⇒ Net::HTTPResponse

Returns statistics about how users interact with narrowcast messages or broadcast messages sent from your LINE Official Account.

Parameters:

  • request_id (String)

Returns:

  • (Net::HTTPResponse) 


794
795
796
797
798
799
 
# File 'lib/line/bot/client.rb', line 794

def get_user_interaction_statistics(request_id)
  channel_token_required

  endpoint_path = "/bot/insight/message/event?requestId=#{request_id}"
  get(endpoint, endpoint_path, credentials)
end

#get_user_rich_menu(user_id) ⇒ Net::HTTPResponse

Get the ID of the rich menu linked to a user

Parameters:

  • user_id (String) —

    ID of the user

Returns:

  • (Net::HTTPResponse) 


567
568
569
570
571
572
 
# File 'lib/line/bot/client.rb', line 567

def get_user_rich_menu(user_id)
  channel_token_required

  endpoint_path = "/bot/user/#{user_id}/richmenu"
  get(endpoint, endpoint_path, credentials)
end

#get_webhook_endpoint ⇒ Net::HTTPResponse

Gets information on a webhook endpoint.

Returns:

  • (Net::HTTPResponse) 


836
837
838
839
840
841
 
# File 'lib/line/bot/client.rb', line 836

def get_webhook_endpoint
  channel_token_required

  endpoint_path = '/bot/channel/webhook/endpoint'
  get(endpoint, endpoint_path, credentials)
end

#issue_channel_access_token_jwt(jwt) ⇒ Net::HTTPResponse

Issue channel access token v2.1

Parameters:

  • jwt (String)

Returns:

  • (Net::HTTPResponse) 


118
119
120
121
122
123
124
125
126
127
 
# File 'lib/line/bot/client.rb', line 118

def issue_channel_access_token_jwt(jwt)
  endpoint_path = '/oauth2/v2.1/token'
  payload = URI.encode_www_form(
    grant_type: 'client_credentials',
    client_assertion_type: 'urn:ietf:params:oauth:client-assertion-type:jwt-bearer',
    client_assertion: jwt
  )
  headers = { 'Content-Type' => 'application/x-www-form-urlencoded' }
  post(oauth_endpoint, endpoint_path, payload, headers)
end

#issue_channel_token(grant_type = 'client_credentials') ⇒ Net::HTTPResponse

Issue channel access token

Parameters:

  • grant_type (String) (defaults to: 'client_credentials') —

    Grant type

Returns:

  • (Net::HTTPResponse) 


89
90
91
92
93
94
95
96
97
98
99
100
101
 
# File 'lib/line/bot/client.rb', line 89

def issue_channel_token(grant_type = 'client_credentials')
  channel_id_required
  channel_secret_required

  endpoint_path = '/oauth/accessToken'
  payload = URI.encode_www_form(
    grant_type:    grant_type,
    client_id:     channel_id,
    client_secret: channel_secret
  )
  headers = { 'Content-Type' => 'application/x-www-form-urlencoded' }
  post(endpoint, endpoint_path, payload, headers)
end

#leave_group(group_id) ⇒ Object 



319
320
321
322
323
324
 
# File 'lib/line/bot/client.rb', line 319

def leave_group(group_id)
  channel_token_required

  endpoint_path = "/bot/group/#{group_id}/leave"
  post(endpoint, endpoint_path, nil, credentials)
end

#leave_room(room_id) ⇒ Object 



326
327
328
329
330
331
 
# File 'lib/line/bot/client.rb', line 326

def leave_room(room_id)
  channel_token_required

  endpoint_path = "/bot/room/#{room_id}/leave"
  post(endpoint, endpoint_path, nil, credentials)
end

#liff_endpoint ⇒ Object 



73
74
75
 
# File 'lib/line/bot/client.rb', line 73

def liff_endpoint
  @liff_endpoint ||= API::DEFAULT_LIFF_ENDPOINT
end

#link_user_rich_menu(user_id, rich_menu_id) ⇒ Net::HTTPResponse

Link a rich menu to a user

If you want to link a rich menu to multiple users, please consider to use bulk_link_rich_menus.

Parameters:

  • user_id (String) —

    ID of the user

  • rich_menu_id (String) —

    ID of an uploaded rich menu

Returns:

  • (Net::HTTPResponse) 


675
676
677
678
679
680
 
# File 'lib/line/bot/client.rb', line 675

def link_user_rich_menu(user_id, rich_menu_id)
  channel_token_required

  endpoint_path = "/bot/user/#{user_id}/richmenu/#{rich_menu_id}"
  post(endpoint, endpoint_path, nil, credentials)
end

#multicast(to, messages, headers: {}, payload: {}) ⇒ Net::HTTPResponse

Send messages to multiple users using userIds.

Parameters:

  • to (Array or String) —

    Array of userIds

  • messages (Hash or Array) —

    Message Objects

  • headers (Hash) (defaults to: {}) —

    HTTP Headers

  • payload (Hash) (defaults to: {}) —

    Additional request body

Returns:

  • (Net::HTTPResponse) 


265
266
267
268
269
270
271
272
273
274
 
# File 'lib/line/bot/client.rb', line 265

def multicast(to, messages, headers: {}, payload: {})
  channel_token_required

  to = [to] if to.is_a?(String)
  messages = [messages] if messages.is_a?(Hash)

  endpoint_path = '/bot/message/multicast'
  payload = payload.merge({ to: to, messages: messages }).to_json
  post(endpoint, endpoint_path, payload, credentials.merge(headers))
end

#narrowcast(messages, recipient: nil, filter: nil, limit: nil, headers: {}) ⇒ Net::HTTPResponse

Narrowcast messages to users

API Documentation is here. developers.line.biz/en/reference/messaging-api/#send-narrowcast-message

Parameters:

  • messages (Hash or Array)
  • recipient (Hash) (defaults to: nil)
  • filter (Hash) (defaults to: nil)
  • limit (Hash) (defaults to: nil)
  • headers (Hash) (defaults to: {}) —

    HTTP Headers

Returns:

  • (Net::HTTPResponse) 


304
305
306
307
308
309
310
311
312
313
314
315
316
317
 
# File 'lib/line/bot/client.rb', line 304

def narrowcast(messages, recipient: nil, filter: nil, limit: nil, headers: {})
  channel_token_required

  messages = [messages] if messages.is_a?(Hash)

  endpoint_path = '/bot/message/narrowcast'
  payload = {
    messages: messages,
    recipient: recipient,
    filter: filter,
    limit: limit
  }.to_json
  post(endpoint, endpoint_path, payload, credentials.merge(headers))
end

#oauth_endpoint ⇒ Object 



58
59
60
 
# File 'lib/line/bot/client.rb', line 58

def oauth_endpoint
  @oauth_endpoint ||= API::DEFAULT_OAUTH_ENDPOINT
end

#parse_events_from(request_body) ⇒ Array<Line::Bot::Event::Class>

Parse events from request.body

Parameters:

  • request_body (String)

Returns:

  • (Array<Line::Bot::Event::Class>) 


1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
 
# File 'lib/line/bot/client.rb', line 1143

def parse_events_from(request_body)
  json = JSON.parse(request_body)

  json['events'].map do |item|
    begin
      klass = Event.const_get(Util.camelize(item['type']))
      klass.new(item)
    rescue NameError
      Event::Base.new(item)
    end
  end
end

#post(endpoint_base, endpoint_path, payload = nil, headers = {}) ⇒ Net::HTTPResponse

Post data, get content of specified URL.

Parameters:

  • endpoint_base (String)
  • endpoint_path (String)
  • payload (String or NilClass) (defaults to: nil)
  • headers (Hash) (defaults to: {})

Returns:

  • (Net::HTTPResponse) 


1108
1109
1110
1111
 
# File 'lib/line/bot/client.rb', line 1108

def post(endpoint_base, endpoint_path, payload = nil, headers = {})
  headers = API::DEFAULT_HEADERS.merge(headers)
  httpclient.post(endpoint_base + endpoint_path, payload, headers)
end

#push_message(user_id, messages, headers: {}, payload: {}) ⇒ Net::HTTPResponse

Push messages to a user using user_id.

Parameters:

  • user_id (String) —

    User Id

  • messages (Hash or Array) —

    Message Objects

  • headers (Hash) (defaults to: {}) —

    HTTP Headers

  • payload (Hash) (defaults to: {}) —

    Additional request body

Returns:

  • (Net::HTTPResponse) 


218
219
220
221
222
223
224
225
226
 
# File 'lib/line/bot/client.rb', line 218

def push_message(user_id, messages, headers: {}, payload: {})
  channel_token_required

  messages = [messages] if messages.is_a?(Hash)

  endpoint_path = '/bot/message/push'
  payload = payload.merge({ to: user_id, messages: messages }).to_json
  post(endpoint, endpoint_path, payload, credentials.merge(headers))
end

#put(endpoint_base, endpoint_path, payload = nil, headers = {}) ⇒ Net::HTTPResponse

Put data, get content of specified URL.

Parameters:

  • endpoint_base (String)
  • endpoint_path (String)
  • payload (String or NilClass) (defaults to: nil)
  • headers (Hash) (defaults to: {})

Returns:

  • (Net::HTTPResponse) 


1121
1122
1123
1124
 
# File 'lib/line/bot/client.rb', line 1121

def put(endpoint_base, endpoint_path, payload = nil, headers = {})
  headers = API::DEFAULT_HEADERS.merge(headers)
  httpclient.put(endpoint_base + endpoint_path, payload, headers)
end

#rename_audience(audience_group_id, description) ⇒ Net::HTTPResponse

Rename an existing audience group

Parameters:

  • audience_group_id (Integer)
  • description (String)

Returns:

  • (Net::HTTPResponse) 


967
968
969
970
971
972
973
 
# File 'lib/line/bot/client.rb', line 967

def rename_audience(audience_group_id, description)
  channel_token_required

  endpoint_path = "/bot/audienceGroup/#{audience_group_id}/updateDescription"
  body = {description: description}
  put(endpoint, endpoint_path, body.to_json, credentials)
end

#reply_message(token, messages) ⇒ Net::HTTPResponse

Reply messages to a user using replyToken.

Examples:

Send a balloon to a user.

message = {
  type: 'text',
  text: 'Hello, World!'
}
client.reply_message(event['replyToken'], message)

Send multiple balloons to a user.


messages = [
 {type: 'text', text: 'Message1'},
 {type: 'text', text: 'Message2'}
]
client.reply_message(event['replyToken'], messages)

Parameters:

  • token (String) —

    Reply Token

  • messages (Hash or Array) —

    Message Objects

Returns:

  • (Net::HTTPResponse) 


248
249
250
251
252
253
254
255
256
 
# File 'lib/line/bot/client.rb', line 248

def reply_message(token, messages)
  channel_token_required

  messages = [messages] if messages.is_a?(Hash)

  endpoint_path = '/bot/message/reply'
  payload = { replyToken: token, messages: messages }.to_json
  post(endpoint, endpoint_path, payload, credentials)
end

#revoke_channel_access_token_jwt(access_token) ⇒ Net::HTTPResponse

Revoke channel access token v2.1

Parameters:

  • access_token (String)

Returns:

  • (Net::HTTPResponse) 


134
135
136
137
138
139
140
141
142
143
144
145
146
 
# File 'lib/line/bot/client.rb', line 134

def revoke_channel_access_token_jwt(access_token)
  channel_id_required
  channel_secret_required

  endpoint_path = '/oauth2/v2.1/revoke'
  payload = URI.encode_www_form(
    client_id: channel_id,
    client_secret: channel_secret,
    access_token: access_token
  )
  headers = { 'Content-Type' => 'application/x-www-form-urlencoded' }
  post(oauth_endpoint, endpoint_path, payload, headers)
end

#revoke_channel_token(access_token) ⇒ Net::HTTPResponse

Revoke channel access token

Returns:

  • (Net::HTTPResponse) 


106
107
108
109
110
111
 
# File 'lib/line/bot/client.rb', line 106

def revoke_channel_token(access_token)
  endpoint_path = '/oauth/revoke'
  payload = URI.encode_www_form(access_token: access_token)
  headers = { 'Content-Type' => 'application/x-www-form-urlencoded' }
  post(endpoint, endpoint_path, payload, headers)
end

#set_default_rich_menu(rich_menu_id) ⇒ Net::HTTPResponse

Set default rich menu (Link a rich menu to all user)

Parameters:

  • rich_menu_id (String) —

    ID of an uploaded rich menu

Returns:

  • (Net::HTTPResponse) 


589
590
591
592
593
594
 
# File 'lib/line/bot/client.rb', line 589

def set_default_rich_menu(rich_menu_id)
  channel_token_required

  endpoint_path = "/bot/user/all/richmenu/#{rich_menu_id}"
  post(endpoint, endpoint_path, nil, credentials)
end

#set_rich_menus_alias(rich_menu_id, rich_menu_alias_id) ⇒ Net::HTTPResponse

Set rich menu alias

Parameters:

  • rich_menu_id (String) —

    ID of an uploaded rich menu

  • rich_menu_alias_id (String) —

    string of alias words rich menu

Returns:

  • (Net::HTTPResponse) 


612
613
614
615
616
617
 
# File 'lib/line/bot/client.rb', line 612

def set_rich_menus_alias(rich_menu_id, rich_menu_alias_id)
  channel_token_required

  endpoint_path = '/bot/richmenu/alias'
  post(endpoint, endpoint_path, { richMenuId: rich_menu_id, richMenuAliasId: rich_menu_alias_id }.to_json, credentials)
end

#set_webhook_endpoint(webhook_endpoint) ⇒ Net::HTTPResponse

Sets the webhook endpoint URL.

Parameters:

  • webhook_endpoint (String)

Returns:

  • (Net::HTTPResponse) 


848
849
850
851
852
853
854
 
# File 'lib/line/bot/client.rb', line 848

def set_webhook_endpoint(webhook_endpoint)
  channel_token_required

  endpoint_path = '/bot/channel/webhook/endpoint'
  body = {endpoint: webhook_endpoint}
  put(endpoint, endpoint_path, body.to_json, credentials)
end

#test_webhook_endpoint(webhook_endpoint = nil) ⇒ Net::HTTPResponse

Checks if the configured webhook endpoint can receive a test webhook event.

Parameters:

  • webhook_endpoint (String) (defaults to: nil) —

    options

Returns:

  • (Net::HTTPResponse) 


861
862
863
864
865
866
867
868
869
870
871
 
# File 'lib/line/bot/client.rb', line 861

def test_webhook_endpoint(webhook_endpoint = nil)
  channel_token_required

  endpoint_path = '/bot/channel/webhook/test'
  body = if webhook_endpoint.nil?
           {}
         else
           {endpoint: webhook_endpoint}
         end
  post(endpoint, endpoint_path, body.to_json, credentials)
end

#unlink_user_rich_menu(user_id) ⇒ Net::HTTPResponse

Unlink a rich menu from a user

Parameters:

  • user_id (String) —

    ID of the user

Returns:

  • (Net::HTTPResponse) 


687
688
689
690
691
692
 
# File 'lib/line/bot/client.rb', line 687

def unlink_user_rich_menu(user_id)
  channel_token_required

  endpoint_path = "/bot/user/#{user_id}/richmenu"
  delete(endpoint, endpoint_path, credentials)
end

#unset_default_rich_menu ⇒ Net::HTTPResponse

Unset default rich menu (Unlink a rich menu from all user)

Returns:

  • (Net::HTTPResponse) 


599
600
601
602
603
604
 
# File 'lib/line/bot/client.rb', line 599

def unset_default_rich_menu
  channel_token_required

  endpoint_path = "/bot/user/all/richmenu"
  delete(endpoint, endpoint_path, credentials)
end

#unset_rich_menus_alias(rich_menu_alias_id) ⇒ Net::HTTPResponse

Unset rich menu alias

Parameters:

  • rich_menu_alias_id (String) —

    string of alias words rich menu

Returns:

  • (Net::HTTPResponse) 


624
625
626
627
628
629
 
# File 'lib/line/bot/client.rb', line 624

def unset_rich_menus_alias(rich_menu_alias_id)
  channel_token_required

  endpoint_path = "/bot/richmenu/alias/#{rich_menu_alias_id}"
  delete(endpoint, endpoint_path, credentials)
end

#update_audience_authority_level(authority_level) ⇒ Net::HTTPResponse

Change the authority level of the audience

Parameters are described here. developers.line.biz/en/reference/messaging-api/#change-authority-level

Parameters:

  • authority_level (String) —

    value must be ‘PUBLIC` or `PRIVATE`

Returns:

  • (Net::HTTPResponse) 


1041
1042
1043
1044
1045
1046
1047
 
# File 'lib/line/bot/client.rb', line 1041

def update_audience_authority_level(authority_level)
  channel_token_required

  endpoint_path = "/bot/audienceGroup/authorityLevel"
  body = {authorityLevel: authority_level}
  put(endpoint, endpoint_path, body.to_json, credentials)
end

#update_liff_app(liff_id, app) ⇒ Object 



887
888
889
890
891
892
 
# File 'lib/line/bot/client.rb', line 887

def update_liff_app(liff_id, app)
  channel_token_required

  endpoint_path = "/apps/#{liff_id}"
  put(liff_endpoint, endpoint_path, app.to_json, credentials)
end

#update_rich_menus_alias(rich_menu_id, rich_menu_alias_id) ⇒ Net::HTTPResponse

Update rich menu alias

Parameters:

  • rich_menu_id (String) —

    ID of an uploaded rich menu

  • rich_menu_alias_id (String) —

    string of alias words rich menu

Returns:

  • (Net::HTTPResponse) 


637
638
639
640
641
642
 
# File 'lib/line/bot/client.rb', line 637

def update_rich_menus_alias(rich_menu_id, rich_menu_alias_id)
  channel_token_required

  endpoint_path = "/bot/richmenu/alias/#{rich_menu_alias_id}"
  post(endpoint, endpoint_path, { richMenuId: rich_menu_id }.to_json, credentials)
end

#update_user_id_audience(params) ⇒ Net::HTTPResponse

Update an audience group

Parameters are described here. developers.line.biz/en/reference/messaging-api/#update-upload-audience-group

Parameters:

  • params (Hash) —

    options

Returns:

  • (Net::HTTPResponse) —

    This response includes an audience_group_id.



924
925
926
927
928
929
 
# File 'lib/line/bot/client.rb', line 924

def update_user_id_audience(params)
  channel_token_required

  endpoint_path = '/bot/audienceGroup/upload'
  put(endpoint, endpoint_path, params.to_json, credentials)
end

#validate_signature(content, channel_signature) ⇒ Boolean

Validate signature of a webhook event.

developers.line.biz/en/reference/messaging-api/#signature-validation

Parameters:

  • content (String) —

    Request’s body

  • channel_signature (String) —

    Request’header ‘X-LINE-Signature’ # HTTP_X_LINE_SIGNATURE

Returns:

  • (Boolean) 


1164
1165
1166
1167
1168
1169
1170
1171
 
# File 'lib/line/bot/client.rb', line 1164

def validate_signature(content, channel_signature)
  return false if !channel_signature || !channel_secret

  hash = OpenSSL::HMAC.digest(OpenSSL::Digest.new('SHA256'), channel_secret, content)
  signature = Base64.strict_encode64(hash)

  variable_secure_compare(channel_signature, signature)
end

#verify_access_token(access_token) ⇒ Net::HTTPResponse

Verify access token v2.1

Parameters:

  • access_token (String) —

    access token

Returns:

  • (Net::HTTPResponse) 


174
175
176
177
178
179
180
 
# File 'lib/line/bot/client.rb', line 174

def verify_access_token(access_token)
  payload = URI.encode_www_form(
    access_token: access_token
  )
  endpoint_path = "/oauth2/v2.1/verify?#{payload}"
  get(oauth_endpoint, endpoint_path)
end

#verify_id_token(id_token, nonce: nil, user_id: nil) ⇒ Net::HTTPResponse

Verify ID token

Parameters:

  • id_token (String) —

    ID token

  • nonce (String) (defaults to: nil) —

    Expected nonce value. Use the nonce value provided in the authorization request. Omit if the nonce value was not specified in the authorization request.

  • user_id (String) (defaults to: nil) —

    Expected user ID.

Returns:

  • (Net::HTTPResponse) 


155
156
157
158
159
160
161
162
163
164
165
166
167
 
# File 'lib/line/bot/client.rb', line 155

def verify_id_token(id_token, nonce: nil, user_id: nil)
  channel_id_required

  endpoint_path = '/oauth2/v2.1/verify'
  payload = URI.encode_www_form({
    client_id: channel_id,
    id_token: id_token,
    nonce: nonce,
    user_id: user_id
  }.compact)
  headers = { 'Content-Type' => 'application/x-www-form-urlencoded' }
  post(oauth_endpoint, endpoint_path, payload, headers)
end