NAME

eBay::API::XML::DataType::ApplicationDeliveryPreferencesType

DESCRIPTION

Specifies preferences describing how notifications are delivered to an application. Note that notifications are subject to Anti-Spam rules. See Anti-Spam Rules in the eBay Web Services Guide for more information about these rules.

SYNOPSIS

INHERITANCE

eBay::API::XML::DataType::ApplicationDeliveryPreferencesType inherits from the eBay::API::XML::BaseDataType class

Subroutines:

setAlertEmail()

The email address where eBay sends all application markup and markdown event notifications. When setting the email address, input must be in the format mailto://youremailaddress@yoursite.com (with the mailto:// prefix). The application has to subscribe to recieve these events using the AlertEnable field.

MaxLength: Length of valid email ids

  Calls: SetNotificationPreferences
  RequiredInput: No

# Argument: 'xs:anyURI'

getAlertEmail()

  Calls: GetNotificationPreferences
  Returned: Conditionally

# Returns: 'xs:anyURI'

setAlertEnable()

A token indicating whether markup and markdown alerts are enabled or disabled.

  Calls: SetNotificationPreferences
  RequiredInput: No

# Argument: 'ns:EnableCodeType'

getAlertEnable()

  Calls: GetNotificationPreferences
  Returned: Conditionally

# Returns: 'ns:EnableCodeType'

setApplicationEnable()

Indicates whether notifications and alerts are enabled or disabled. If you disable notifications, the application does not receive them, but notification preferences are not erased.

  Calls: SetNotificationPreferences
  RequiredInput: No

# Argument: 'ns:EnableCodeType'

getApplicationEnable()

  Calls: GetNotificationPreferences
  Returned: Conditionally

# Returns: 'ns:EnableCodeType'

setApplicationURL()

The URL where eBay delivers all notifications sent to the application. For delivery to a server, the URL begins with http:// or https:// and must be well formed. Use a URL that is functional at the time of the call. For delivery to an email address, the URL begins with mailto: and specifies a valid email address.

  Calls: SetNotificationPreferences
  RequiredInput: No

# Argument: 'xs:anyURI'

getApplicationURL()

  Calls: GetNotificationPreferences
  Returned: Conditionally

# Returns: 'xs:anyURI'

setDeliveryURLDetails()

Defines settings for a notification URL (including the URL name in DeliveryURLName). You define settings for a notification URL (including the URL name in DeliveryURLName) in the DeliveryURLDetails container. You associate a user token with a notification URL by using the token in a SetNotificationPreferences request that specifies the URL name in SetNotificationPreferencesRequest.DeliveryURLName. If you associate a single user token to multiple URL names, each URL name overwrites the previous name associated with the token. You can specify up to 10 notification URLs for an application. Note that Notifications will not be sent to any URL(s) if ApplicationDeliveryPreferencesType.ApplicationEnable is set to Disable.

  Calls: SetNotificationPreferences
  RequiredInput: No

# Argument: reference to an array of 'ns:DeliveryURLDetailType'

getDeliveryURLDetails()

  Calls: GetNotificationPreferences
  Returned: Conditionally

# Returns: reference to an array of 'ns:DeliveryURLDetailType'

setDeviceType()

Do not test Client Alerts in production if you are currently using Platform Notifications. The means of receipt of notification. In most cases, it is Platform (typical API calls and web interaction), so this is the default, if not specified. For wireless applications, use SMS.

  Calls: SetNotificationPreferences
  RequiredInput: No

# Argument: 'ns:DeviceTypeCodeType'

getDeviceType()

  Calls: GetNotificationPreferences
  Returned: Conditionally

# Returns: 'ns:DeviceTypeCodeType'

setNotificationPayloadType()

If this field is specified, the value must be eBLSchemaSOAP.

  Calls: SetNotificationPreferences
  RequiredInput: No

# Argument: 'ns:NotificationPayloadTypeCodeType'

getNotificationPayloadType()

  Calls: GetNotificationPreferences
  Returned: Conditionally

# Returns: 'ns:NotificationPayloadTypeCodeType'

setPayloadVersion()

If you are using SetNotificationPreferences, you can use the PayloadVersion field to specify the API version for all notifications for the calling application. If you are using GetNotificationPreferences, this field contains the API version for all notifications for the calling application. If you do not specify PayloadVersion in SetNotificationPreferences, the behavior of notifications is the same as it was before the PayloadVersion field was added to the schema. Before the PayloadVersion field was added to the schema, the API version for notifications was based on the API version specified as part of your SetNotificationPreferences call. Now, you can use PayloadVersion to override the API version specified as part of your SetNotificationPreferences call.

  Calls: SetNotificationPreferences
  RequiredInput: No

# Argument: 'xs:string'

getPayloadVersion()

  Calls: GetNotificationPreferences
  Returned: Conditionally

# Returns: 'xs:string'