Class: Nylas::Messages

Inherits:
Resource show all
Includes:
ApiOperations::Delete, ApiOperations::Get, ApiOperations::Post, ApiOperations::Put
Defined in:
lib/nylas/resources/messages.rb

Overview

Nylas Messages API

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(sdk_instance) ⇒ Messages

Initializes the messages resource.

Parameters:

  • sdk_instance (Nylas::API)

    The API instance to which the resource is bound.



20
21
22
23
# File 'lib/nylas/resources/messages.rb', line 20

def initialize(sdk_instance)
  super(sdk_instance)
  @smart_compose = SmartCompose.new(sdk_instance)
end

Instance Attribute Details

#smart_composeObject (readonly)

Returns the value of attribute smart_compose.



16
17
18
# File 'lib/nylas/resources/messages.rb', line 16

def smart_compose
  @smart_compose
end

Instance Method Details

#clean_messages(identifier:, request_body:) ⇒ Array(Hash)

Clean a message.

Parameters:

  • identifier (String)

    Grant ID or email account from which to clean a message.

  • request_body (Hash)

    The options to clean a message with

Returns:

  • (Array(Hash))

    The list of clean messages.



83
84
85
86
87
88
# File 'lib/nylas/resources/messages.rb', line 83

def clean_messages(identifier:, request_body:)
  put(
    path: "#{api_uri}/v3/grants/#{identifier}/messages/clean",
    request_body: request_body
  )
end

#destroy(identifier:, message_id:) ⇒ Array(TrueClass, String)

Delete a message.

Parameters:

  • identifier (String)

    Grant ID or email account from which to delete an object.

  • message_id (String)

    The id of the message to delete.

Returns:

  • (Array(TrueClass, String))

    True and the API Request ID for the delete operation.



70
71
72
73
74
75
76
# File 'lib/nylas/resources/messages.rb', line 70

def destroy(identifier:, message_id:)
  _, request_id = delete(
    path: "#{api_uri}/v3/grants/#{identifier}/messages/#{message_id}"
  )

  [true, request_id]
end

#find(identifier:, message_id:, query_params: nil) ⇒ Array(Hash, String)

Return a message.

Parameters:

  • identifier (String)

    Grant ID or email account to query.

  • message_id (String)

    The id of the message to return.

  • query_params (Hash, nil) (defaults to: nil)

    Query params to pass to the request.

Returns:

  • (Array(Hash, String))

    The message and API request ID.



43
44
45
46
47
48
# File 'lib/nylas/resources/messages.rb', line 43

def find(identifier:, message_id:, query_params: nil)
  get(
    path: "#{api_uri}/v3/grants/#{identifier}/messages/#{message_id}",
    query_params: query_params
  )
end

#find_scheduled_messages(identifier:, schedule_id:) ⇒ Array(Hash, String)

Retrieve your scheduled messages.

Parameters:

  • identifier (String)

    Grant ID or email account from which to list the scheduled messages from.

  • schedule_id (String)

    The id of the scheduled message to stop.

Returns:

  • (Array(Hash, String))

    The scheduled message and the API Request ID.



126
127
128
129
130
# File 'lib/nylas/resources/messages.rb', line 126

def find_scheduled_messages(identifier:, schedule_id:)
  get(
    path: "#{api_uri}/v3/grants/#{identifier}/messages/schedules/#{schedule_id}"
  )
end

#list(identifier:, query_params: nil) ⇒ Array(Array(Hash), String, String)

Return all messages.

Parameters:

  • identifier (String)

    Grant ID or email account to query.

  • query_params (Hash, nil) (defaults to: nil)

    Query params to pass to the request.

Returns:

  • (Array(Array(Hash), String, String))

    The list of messages, API Request ID, and next cursor.



30
31
32
33
34
35
# File 'lib/nylas/resources/messages.rb', line 30

def list(identifier:, query_params: nil)
  get_list(
    path: "#{api_uri}/v3/grants/#{identifier}/messages",
    query_params: query_params
  )
end

#list_scheduled_messages(identifier:) ⇒ Array(Array(Hash), String)

Retrieve your scheduled messages.

Parameters:

  • identifier (String)

    Grant ID or email account from which to find the scheduled message from.

Returns:

  • (Array(Array(Hash), String))

    The list of scheduled messages and the API Request ID.



115
116
117
118
119
# File 'lib/nylas/resources/messages.rb', line 115

def list_scheduled_messages(identifier:)
  get(
    path: "#{api_uri}/v3/grants/#{identifier}/messages/schedules"
  )
end

#send(identifier:, request_body:) ⇒ Array(Hash, String)

Send a message.

Parameters:

  • identifier (String)

    Grant ID or email account from which to delete an object.

  • request_body (Hash)

    The values to create the message with. If you're attaching files, you must pass an array of [File] objects, or you can pass in base64 encoded strings if the total attachment size is less than 3mb. You can also use FileUtils::attach_file_request_builder to build each object attach.

Returns:

  • (Array(Hash, String))

    The sent message and the API Request ID.



98
99
100
101
102
103
104
105
106
107
108
109
# File 'lib/nylas/resources/messages.rb', line 98

def send(identifier:, request_body:)
  payload, opened_files = FileUtils.handle_message_payload(request_body)

  response = post(
    path: "#{api_uri}/v3/grants/#{identifier}/messages/send",
    request_body: payload
  )

  opened_files.each(&:close)

  response
end

#stop_scheduled_messages(identifier:, schedule_id:) ⇒ Array(Hash, String)

Stop a scheduled message.

Parameters:

  • identifier (String)

    Grant ID or email account from which to list the scheduled messages from.

  • schedule_id (String)

    The id of the scheduled message to stop..

Returns:

  • (Array(Hash, String))

    The scheduled message and the API Request ID.



137
138
139
140
141
# File 'lib/nylas/resources/messages.rb', line 137

def stop_scheduled_messages(identifier:, schedule_id:)
  delete(
    path: "#{api_uri}/v3/grants/#{identifier}/messages/schedules/#{schedule_id}"
  )
end

#update(identifier:, message_id:, request_body:, query_params: nil) ⇒ Array(Hash, String)

Update a message.

Parameters:

  • identifier (String)

    Grant ID or email account in which to update an object.

  • message_id (String)

    The id of the message to update.

  • request_body (Hash)

    The values to update the message with

  • query_params (Hash, nil) (defaults to: nil)

    Query params to pass to the request.

Returns:

  • (Array(Hash, String))

    The updated message and API Request ID.



57
58
59
60
61
62
63
# File 'lib/nylas/resources/messages.rb', line 57

def update(identifier:, message_id:, request_body:, query_params: nil)
  put(
    path: "#{api_uri}/v3/grants/#{identifier}/messages/#{message_id}",
    request_body: request_body,
    query_params: query_params
  )
end