APNSMessage (AWS Java SDK :: Services :: Amazon Pinpoint 2.7.6 API)

java.lang.Object
- software.amazon.awssdk.services.pinpoint.model.APNSMessage

All Implemented Interfaces:

Serializable, SdkPojo, ToCopyableBuilder<APNSMessage.Builder,APNSMessage>
```
@Generated(value="software.amazon.awssdk:codegen")
public final class APNSMessage
extends Object
implements SdkPojo, Serializable, ToCopyableBuilder<APNSMessage.Builder,APNSMessage>
```
Specifies the settings for a one-time message that's sent directly to an endpoint through the APNs (Apple Push Notification service) channel.

See Also:

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static interface APNSMessage.Builder

Nested Classes
Modifier and Type	Class and Description
`static interface`	`APNSMessage.Builder`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Action`	`action()` The action to occur if the recipient taps the push notification.
`String`	`actionAsString()` The action to occur if the recipient taps the push notification.
`Integer`	`badge()` The key that indicates whether and how to modify the badge of your app's icon when the recipient receives the push notification.
`String`	`body()` The body of the notification message.
`static APNSMessage.Builder`	`builder()`
`String`	`category()` The key that indicates the notification type for the push notification.
`String`	`collapseId()` An arbitrary identifier that, if assigned to multiple messages, APNs uses to coalesce the messages into a single push notification instead of delivering each message individually.
`Map<String,String>`	`data()` The JSON payload to use for a silent push notification.
`boolean`	`equals(Object obj)`
`boolean`	`equalsBySdkFields(Object obj)`
`<T> Optional<T>`	`getValueForField(String fieldName, Class<T> clazz)`
`int`	`hashCode()`
`String`	`mediaUrl()` The URL of an image or video to display in the push notification.
`String`	`preferredAuthenticationMethod()` The authentication method that you want Amazon Pinpoint to use when authenticating with Apple Push Notification service (APNs), CERTIFICATE or TOKEN.
`String`	`priority()` para>5 - Low priority, the notification might be delayed, delivered as part of a group, or throttled.
`String`	`rawContent()` The raw, JSON-formatted string to use as the payload for the notification message.
`List<SdkField<?>>`	`sdkFields()`
`static Class<? extends APNSMessage.Builder>`	`serializableBuilderClass()`
`Boolean`	`silentPush()` Specifies whether the notification is a silent push notification, which is a push notification that doesn't display on a recipient's device.
`String`	`sound()` The key for the sound to play when the recipient receives the push notification.
`Map<String,List<String>>`	`substitutions()` The default message variables to use in the notification message.
`String`	`threadId()` The key that represents your app-specific identifier for grouping notifications.
`Integer`	`timeToLive()` The amount of time, in seconds, that APNs should store and attempt to deliver the push notification, if the service is unable to deliver the notification the first time.
`String`	`title()` The title to display above the notification message on the recipient's device.
`APNSMessage.Builder`	`toBuilder()`
`String`	`toString()` Returns a string representation of this object.
`String`	`url()` 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.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy

- Method Detail
  - action
```
public Action action()
```
    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 setting uses the deep-linking features of the iOS platform.
    - URL - The default mobile browser on the recipient's device opens and loads the web page at a URL that you specify.
    If the service returns an enum value that is not available in the current SDK version, action will return Action.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from actionAsString().
    Returns:
    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 setting uses the deep-linking features of the iOS platform.
    
    URL - The default mobile browser on the recipient's device opens and loads the web page at a URL that you specify.
    See Also:
    
    Action
  - actionAsString
```
public String actionAsString()
```
    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 setting uses the deep-linking features of the iOS platform.
    - URL - The default mobile browser on the recipient's device opens and loads the web page at a URL that you specify.
    If the service returns an enum value that is not available in the current SDK version, action will return Action.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from actionAsString().
    Returns:
    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 setting uses the deep-linking features of the iOS platform.
    
    URL - The default mobile browser on the recipient's device opens and loads the web page at a URL that you specify.
    See Also:
    
    Action
  - badge
```
public Integer badge()
```
    The key that indicates whether and how to modify the badge of your app's icon when the recipient receives the push notification. If this key isn't included in the dictionary, the badge doesn't change. To remove the badge, set this value to 0.
    
    Returns:
    
    The key that indicates whether and how to modify the badge of your app's icon when the recipient receives the push notification. If this key isn't included in the dictionary, the badge doesn't change. To remove the badge, set this value to 0.
  - body
```
public String body()
```
    The body of the notification message.
    
    Returns:
    
    The body of the notification message.
  - category
```
public String category()
```
    The key that indicates the notification type for the push notification. This key is a value that's defined by the identifier property of one of your app's registered categories.
    
    Returns:
    
    The key that indicates the notification type for the push notification. This key is a value that's defined by the identifier property of one of your app's registered categories.
  - collapseId
```
public String collapseId()
```
    An arbitrary identifier that, if assigned to multiple messages, APNs uses to coalesce the messages into a single push notification instead of delivering each message individually. This value can't exceed 64 bytes.
    
    Amazon Pinpoint specifies this value in the apns-collapse-id request header when it sends the notification message to APNs.
    
    Returns:
    
    An arbitrary identifier that, if assigned to multiple messages, APNs uses to coalesce the messages into a single push notification instead of delivering each message individually. This value can't exceed 64 bytes.
    
    Amazon Pinpoint specifies this value in the apns-collapse-id request header when it sends the notification message to APNs.
  - data
```
public Map<String,String> data()
```
    The JSON payload to use for a silent push notification. This payload is added to the data.pinpoint.jsonBody object of the notification.
    
    Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
    
    Returns:
    
    The JSON payload to use for a silent push notification. This payload is added to the data.pinpoint.jsonBody object of the notification.
  - mediaUrl
```
public String mediaUrl()
```
    The URL of an image or video to display in the push notification.
    
    Returns:
    
    The URL of an image or video to display in the push notification.
  - preferredAuthenticationMethod
```
public String preferredAuthenticationMethod()
```
    The authentication method that you want Amazon Pinpoint to use when authenticating with Apple Push Notification service (APNs), CERTIFICATE or TOKEN.
    
    Returns:
    
    The authentication method that you want Amazon Pinpoint to use when authenticating with Apple Push Notification service (APNs), CERTIFICATE or TOKEN.
  - priority
```
public String priority()
```
    para>5 - Low priority, the notification might be delayed, delivered as part of a group, or throttled.
    /listitem>
  - 10 - High priority, the notification is sent immediately. This is the default value. A high priority notification should trigger an alert, play a sound, or badge your app's icon on the recipient's device.

Returns:

para>5 - Low priority, the notification might be delayed, delivered as part of a group, or throttled.

/listitem>

10 - High priority, the notification is sent immediately. This is the default value. A high priority notification should trigger an alert, play a sound, or badge your app's icon on the recipient's device.

/para>

Amazon Pinpoint specifies this value in the apns-priority request header when it sends the notification message to APNs.

The equivalent values for Firebase Cloud Messaging (FCM), formerly Google Cloud Messaging (GCM), are normal, for 5, and high, for 10. If you specify an FCM value for this property, Amazon Pinpoint accepts and converts the value to the corresponding APNs value.

rawContent
```
public String rawContent()
```
The raw, JSON-formatted string to use as the payload for the notification message. This value overrides the message.

Returns:

The raw, JSON-formatted string to use as the payload for the notification message. This value overrides the message.

silentPush
```
public Boolean silentPush()
```
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, displaying messages in an in-app message center, or supporting phone home functionality.

Returns:

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, displaying messages in an in-app message center, or supporting phone home functionality.

sound
```
public String sound()
```
The key for the sound to play when the recipient receives the push notification. The value of this key is the name of a sound file in your app's main bundle or the Library/Sounds folder in your app's data container. If the sound file can't be found or you specify default for the value, the system plays the default alert sound.

Returns:

The key for the sound to play when the recipient receives the push notification. The value of this key is the name of a sound file in your app's main bundle or the Library/Sounds folder in your app's data container. If the sound file can't be found or you specify default for the value, the system plays the default alert sound.

substitutions
```
public Map<String,List<String>> substitutions()
```
The default message variables to use in the notification message. You can override these default variables with individual address variables.

Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

Returns:

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

threadId
```
public String threadId()
```
The key that represents your app-specific identifier for grouping notifications. If you provide a Notification Content app extension, you can use this value to group your notifications together.

Returns:

The key that represents your app-specific identifier for grouping notifications. If you provide a Notification Content app extension, you can use this value to group your notifications together.

timeToLive
```
public Integer timeToLive()
```
The amount of time, in seconds, that APNs should store and attempt to deliver the push notification, if the service is unable to deliver the notification the first time. If this value is 0, APNs treats the notification as if it expires immediately and the service doesn't store or try to deliver the notification again.

Amazon Pinpoint specifies this value in the apns-expiration request header when it sends the notification message to APNs.

Returns:

The amount of time, in seconds, that APNs should store and attempt to deliver the push notification, if the service is unable to deliver the notification the first time. If this value is 0, APNs treats the notification as if it expires immediately and the service doesn't store or try to deliver the notification again.

Amazon Pinpoint specifies this value in the apns-expiration request header when it sends the notification message to APNs.

title
```
public String title()
```
The title to display above the notification message on the recipient's device.

Returns:

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

url
```
public String url()
```
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:

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.

toBuilder
```
public APNSMessage.Builder toBuilder()
```
Specified by:

toBuilder in interface ToCopyableBuilder<APNSMessage.Builder,APNSMessage>

builder

public static APNSMessage.Builder builder()

serializableBuilderClass

public static Class<? extends APNSMessage.Builder> serializableBuilderClass()

hashCode
```
public int hashCode()
```
Overrides:

hashCode in class Object

equals
```
public boolean equals(Object obj)
```
Overrides:

equals in class Object

equalsBySdkFields
```
public boolean equalsBySdkFields(Object obj)
```
Specified by:

equalsBySdkFields in interface SdkPojo

toString
```
public String toString()
```
Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.

Overrides:

toString in class Object

getValueForField

public <T> Optional<T> getValueForField(String fieldName,
                                        Class<T> clazz)

sdkFields
```
public List<SdkField<?>> sdkFields()
```
Specified by:

sdkFields in interface SdkPojo

Class APNSMessage

Nested Class Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder

Method Detail

action

actionAsString

badge

body

category

collapseId

data

mediaUrl

preferredAuthenticationMethod

priority

rawContent

silentPush

sound

substitutions

threadId

timeToLive

title

url

toBuilder

builder

serializableBuilderClass

hashCode

equals

equalsBySdkFields

toString

getValueForField

sdkFields