Class: Aws::Pinpoint::Types::ADMMessage

Inherits:
Struct
  • Object
show all
Defined in:
gems/aws-sdk-pinpoint/lib/aws-sdk-pinpoint/types.rb

Overview

Note:

When making an API call, you may pass ADMMessage data as a hash:

{
  action: "OPEN_APP", # accepts OPEN_APP, DEEP_LINK, URL
  body: "__string",
  consolidation_key: "__string",
  data: {
    "__string" => "__string",
  },
  expires_after: "__string",
  icon_reference: "__string",
  image_icon_url: "__string",
  image_url: "__string",
  md5: "__string",
  raw_content: "__string",
  silent_push: false,
  small_image_icon_url: "__string",
  sound: "__string",
  substitutions: {
    "__string" => ["__string"],
  },
  title: "__string",
  url: "__string",
}

Specifies the settings for a one-time message that's sent directly to an endpoint through the ADM (Amazon Device Messaging) channel.

Constant Summary collapse

SENSITIVE =
[]

Instance Attribute Summary collapse

Instance Attribute Details

#actionString

The action to occur if the recipient taps the push notification. Valid values are:

  • OPEN_APP - Your app opens or it becomes the foreground app if it was sent to the background. This is the default action.

  • DEEP_LINK - Your app opens and displays a designated user interface in the app. This action uses the deep-linking features of the Android platform.

  • URL - The default mobile browser on the recipient's device opens and loads the web page at a URL that you specify.

Returns:

  • (String)


244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
# File 'gems/aws-sdk-pinpoint/lib/aws-sdk-pinpoint/types.rb', line 244

class ADMMessage < Struct.new(
  :action,
  :body,
  :consolidation_key,
  :data,
  :expires_after,
  :icon_reference,
  :image_icon_url,
  :image_url,
  :md5,
  :raw_content,
  :silent_push,
  :small_image_icon_url,
  :sound,
  :substitutions,
  :title,
  :url)
  SENSITIVE = []
  include Aws::Structure
end

#bodyString

The body of the notification message.

Returns:

  • (String)


244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
# File 'gems/aws-sdk-pinpoint/lib/aws-sdk-pinpoint/types.rb', line 244

class ADMMessage < Struct.new(
  :action,
  :body,
  :consolidation_key,
  :data,
  :expires_after,
  :icon_reference,
  :image_icon_url,
  :image_url,
  :md5,
  :raw_content,
  :silent_push,
  :small_image_icon_url,
  :sound,
  :substitutions,
  :title,
  :url)
  SENSITIVE = []
  include Aws::Structure
end

#consolidation_keyString

An arbitrary string that indicates that multiple messages are logically the same and that Amazon Device Messaging (ADM) can drop previously enqueued messages in favor of this message.

Returns:

  • (String)


244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
# File 'gems/aws-sdk-pinpoint/lib/aws-sdk-pinpoint/types.rb', line 244

class ADMMessage < Struct.new(
  :action,
  :body,
  :consolidation_key,
  :data,
  :expires_after,
  :icon_reference,
  :image_icon_url,
  :image_url,
  :md5,
  :raw_content,
  :silent_push,
  :small_image_icon_url,
  :sound,
  :substitutions,
  :title,
  :url)
  SENSITIVE = []
  include Aws::Structure
end

#dataHash<String,String>

The JSON data payload to use for the push notification, if the notification is a silent push notification. This payload is added to the data.pinpoint.jsonBody object of the notification.

Returns:

  • (Hash<String,String>)


244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
# File 'gems/aws-sdk-pinpoint/lib/aws-sdk-pinpoint/types.rb', line 244

class ADMMessage < Struct.new(
  :action,
  :body,
  :consolidation_key,
  :data,
  :expires_after,
  :icon_reference,
  :image_icon_url,
  :image_url,
  :md5,
  :raw_content,
  :silent_push,
  :small_image_icon_url,
  :sound,
  :substitutions,
  :title,
  :url)
  SENSITIVE = []
  include Aws::Structure
end

#expires_afterString

The amount of time, in seconds, that ADM should store the message if the recipient's device is offline. Amazon Pinpoint specifies this value in the expiresAfter parameter when it sends the notification message to ADM.

Returns:

  • (String)


244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
# File 'gems/aws-sdk-pinpoint/lib/aws-sdk-pinpoint/types.rb', line 244

class ADMMessage < Struct.new(
  :action,
  :body,
  :consolidation_key,
  :data,
  :expires_after,
  :icon_reference,
  :image_icon_url,
  :image_url,
  :md5,
  :raw_content,
  :silent_push,
  :small_image_icon_url,
  :sound,
  :substitutions,
  :title,
  :url)
  SENSITIVE = []
  include Aws::Structure
end

#icon_referenceString

The icon image name of the asset saved in your app.

Returns:

  • (String)


244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
# File 'gems/aws-sdk-pinpoint/lib/aws-sdk-pinpoint/types.rb', line 244

class ADMMessage < Struct.new(
  :action,
  :body,
  :consolidation_key,
  :data,
  :expires_after,
  :icon_reference,
  :image_icon_url,
  :image_url,
  :md5,
  :raw_content,
  :silent_push,
  :small_image_icon_url,
  :sound,
  :substitutions,
  :title,
  :url)
  SENSITIVE = []
  include Aws::Structure
end

#image_icon_urlString

The URL of the large icon image to display in the content view of the push notification.

Returns:

  • (String)


244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
# File 'gems/aws-sdk-pinpoint/lib/aws-sdk-pinpoint/types.rb', line 244

class ADMMessage < Struct.new(
  :action,
  :body,
  :consolidation_key,
  :data,
  :expires_after,
  :icon_reference,
  :image_icon_url,
  :image_url,
  :md5,
  :raw_content,
  :silent_push,
  :small_image_icon_url,
  :sound,
  :substitutions,
  :title,
  :url)
  SENSITIVE = []
  include Aws::Structure
end

#image_urlString

The URL of an image to display in the push notification.

Returns:

  • (String)


244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
# File 'gems/aws-sdk-pinpoint/lib/aws-sdk-pinpoint/types.rb', line 244

class ADMMessage < Struct.new(
  :action,
  :body,
  :consolidation_key,
  :data,
  :expires_after,
  :icon_reference,
  :image_icon_url,
  :image_url,
  :md5,
  :raw_content,
  :silent_push,
  :small_image_icon_url,
  :sound,
  :substitutions,
  :title,
  :url)
  SENSITIVE = []
  include Aws::Structure
end

#md5String

The base64-encoded, MD5 checksum of the value specified by the Data property. ADM uses the MD5 value to verify the integrity of the data.

Returns:

  • (String)


244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
# File 'gems/aws-sdk-pinpoint/lib/aws-sdk-pinpoint/types.rb', line 244

class ADMMessage < Struct.new(
  :action,
  :body,
  :consolidation_key,
  :data,
  :expires_after,
  :icon_reference,
  :image_icon_url,
  :image_url,
  :md5,
  :raw_content,
  :silent_push,
  :small_image_icon_url,
  :sound,
  :substitutions,
  :title,
  :url)
  SENSITIVE = []
  include Aws::Structure
end

#raw_contentString

The raw, JSON-formatted string to use as the payload for the notification message. If specified, this value overrides all other content for the message.

Returns:

  • (String)


244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
# File 'gems/aws-sdk-pinpoint/lib/aws-sdk-pinpoint/types.rb', line 244

class ADMMessage < Struct.new(
  :action,
  :body,
  :consolidation_key,
  :data,
  :expires_after,
  :icon_reference,
  :image_icon_url,
  :image_url,
  :md5,
  :raw_content,
  :silent_push,
  :small_image_icon_url,
  :sound,
  :substitutions,
  :title,
  :url)
  SENSITIVE = []
  include Aws::Structure
end

#silent_pushBoolean

Specifies whether the notification is a silent push notification, which is a push notification that doesn't display on a recipient's device. Silent push notifications can be used for cases such as updating an app's configuration or supporting phone home functionality.

Returns:

  • (Boolean)


244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
# File 'gems/aws-sdk-pinpoint/lib/aws-sdk-pinpoint/types.rb', line 244

class ADMMessage < Struct.new(
  :action,
  :body,
  :consolidation_key,
  :data,
  :expires_after,
  :icon_reference,
  :image_icon_url,
  :image_url,
  :md5,
  :raw_content,
  :silent_push,
  :small_image_icon_url,
  :sound,
  :substitutions,
  :title,
  :url)
  SENSITIVE = []
  include Aws::Structure
end

#small_image_icon_urlString

The URL of the small icon image to display in the status bar and the content view of the push notification.

Returns:

  • (String)


244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
# File 'gems/aws-sdk-pinpoint/lib/aws-sdk-pinpoint/types.rb', line 244

class ADMMessage < Struct.new(
  :action,
  :body,
  :consolidation_key,
  :data,
  :expires_after,
  :icon_reference,
  :image_icon_url,
  :image_url,
  :md5,
  :raw_content,
  :silent_push,
  :small_image_icon_url,
  :sound,
  :substitutions,
  :title,
  :url)
  SENSITIVE = []
  include Aws::Structure
end

#soundString

The sound to play when the recipient receives the push notification. You can use the default stream or specify the file name of a sound resource that's bundled in your app. On an Android platform, the sound file must reside in /res/raw/.

Returns:

  • (String)


244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
# File 'gems/aws-sdk-pinpoint/lib/aws-sdk-pinpoint/types.rb', line 244

class ADMMessage < Struct.new(
  :action,
  :body,
  :consolidation_key,
  :data,
  :expires_after,
  :icon_reference,
  :image_icon_url,
  :image_url,
  :md5,
  :raw_content,
  :silent_push,
  :small_image_icon_url,
  :sound,
  :substitutions,
  :title,
  :url)
  SENSITIVE = []
  include Aws::Structure
end

#substitutionsHash<String,Array<String>>

The default message variables to use in the notification message. You can override the default variables with individual address variables.

Returns:

  • (Hash<String,Array<String>>)


244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
# File 'gems/aws-sdk-pinpoint/lib/aws-sdk-pinpoint/types.rb', line 244

class ADMMessage < Struct.new(
  :action,
  :body,
  :consolidation_key,
  :data,
  :expires_after,
  :icon_reference,
  :image_icon_url,
  :image_url,
  :md5,
  :raw_content,
  :silent_push,
  :small_image_icon_url,
  :sound,
  :substitutions,
  :title,
  :url)
  SENSITIVE = []
  include Aws::Structure
end

#titleString

The title to display above the notification message on the recipient's device.

Returns:

  • (String)


244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
# File 'gems/aws-sdk-pinpoint/lib/aws-sdk-pinpoint/types.rb', line 244

class ADMMessage < Struct.new(
  :action,
  :body,
  :consolidation_key,
  :data,
  :expires_after,
  :icon_reference,
  :image_icon_url,
  :image_url,
  :md5,
  :raw_content,
  :silent_push,
  :small_image_icon_url,
  :sound,
  :substitutions,
  :title,
  :url)
  SENSITIVE = []
  include Aws::Structure
end

#urlString

The URL to open in the recipient's default mobile browser, if a recipient taps the push notification and the value of the Action property is URL.

Returns:

  • (String)


244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
# File 'gems/aws-sdk-pinpoint/lib/aws-sdk-pinpoint/types.rb', line 244

class ADMMessage < Struct.new(
  :action,
  :body,
  :consolidation_key,
  :data,
  :expires_after,
  :icon_reference,
  :image_icon_url,
  :image_url,
  :md5,
  :raw_content,
  :silent_push,
  :small_image_icon_url,
  :sound,
  :substitutions,
  :title,
  :url)
  SENSITIVE = []
  include Aws::Structure
end