135 Release API Changes

From $1

    Table of contents
    1. 1. Key Topics for 135.4 Release
      1. 1.1. Manage Reply Mail Management
    2. 2. Key Topics for 135.3 Release
      1. 2.1. Send Profile and Delivery Profiles for Send Definitions
      2. 2.2. Retrieve Audience of Send Definition
      3. 2.3. Schedule a Send Definition
    3. 3. Key Topics for 135.2 Release
      1. 3.1. API Support for Decimal Data Type
      2. 3.2. ImportDefinition Calls Support DateTimeLocale Property
      3. 3.3. Changes in API Objects and Properties
        1. 3.3.1. Account
        2. 3.3.2. AccountUser
        3. 3.3.3. AsyncResponseType
        4. 3.3.4. BusinessUnit
        5. 3.3.5. Certficate (New Object)
        6. 3.3.6. ClickEvent
        7. 3.3.7. ContentValidation
        8. 3.3.8. DataExtensionFieldType
        9. 3.3.9. DeliveryProfile
        10. 3.3.10. EmailSendDefinition
        11. 3.3.11. ImportDefinition
        12. 3.3.12. ImportDefinitionSubscriberImportType
        13. 3.3.13. Link
        14. 3.3.14. MinutelyRecurrence (New Object)
        15. 3.3.15. MinutelyRecurrencePatternTypeEnum (New Object)
        16. 3.3.16. MessagingConfiguration
        17. 3.3.17. PropertyType
        18. 3.3.18. SecurityObject (New Object)
        19. 3.3.19. Send
        20. 3.3.20. SubscriberAddressStatus
        21. 3.3.21. SubscriberSendResult
        22. 3.3.22. TriggeredSendDefinition
        23. 3.3.23. TriggeredSendStatusEnum
        24. 3.3.24. UsernameAuthentication
    4. 4. Key Topics for 135 Release
      1. 4.1. Respect of UTC and Time Zone Date Formats for Inbound Web Service Operations
      2. 4.2. Enterprise 2.0 Account Management Features (beta)
      3. 4.3. Email Content Enhancements
      4. 4.4. Publication and Suppression List Support using ListClassification
      5. 4.5. Import Definition Enhancements
      6. 4.6. Data Extension Imports using DataExtensionObjects
    5. 5. Other Important Changes
      1. 5.1. Customer Key Allowed on the List and Account objects
      2. 5.2. File Triggers (beta)
      3. 5.3. Web Service Authentication
      4. 5.4. Changes in API Objects and Properties
        1. 5.4.1. AccountUser
        2. 5.4.2. TimeZone (New Object)
        3. 5.4.3. Account
        4. 5.4.4. BusinessUnit (New Object)
        5. 5.4.5. TriggeredSendDefinition
        6. 5.4.6. TriggeredSendStatusEnum
        7. 5.4.7. List
        8. 5.4.8. ListClassificationEnum (New Object)
        9. 5.4.9. DataExtensionFieldType
        10. 5.4.10. ImportDefinition
        11. 5.4.11. ImportDefinitionSubscriberImportType
        12. 5.4.12. ImportDefinitionUpdateType
        13. 5.4.13. ImportDefinitionAutoGenerateDestination (New Object)
        14. 5.4.14. ImportDefinitionColumnBasedActionType (New Object)
        15. 5.4.15. ImportDefinitionColumnBasedAction (New Object)
        16. 5.4.16. EmailSendDefinition
        17. 5.4.17. LandingPage (New Object)
        18. 5.4.18. UnsubscribeBehaviorEnum (New Object)
        19. 5.4.19. Role (New Object)
        20. 5.4.20. PermissionSet (New Object)
        21. 5.4.21. Permission (New Object)
        22. 5.4.22. ExtractTemplate
        23. 5.4.23. ExtractDefinition
        24. 5.4.24. ProgramManifestTemplate (New Object)
        25. 5.4.25. FileTriggerTypeLastPull (New Object)
        26. 5.4.26. FileTriggerExternalReferenceLastPull (New Object)
        27. 5.4.27. FileTrigger (New Object)
        28. 5.4.28. Layout (New Object)
        29. 5.4.29. MessagingConfiguration
        30. 5.4.30. SubscriberSendResult
        31. 5.4.31. Send
        32. 5.4.32. ContentValidation
    Doc-Wiki-BannerHK.png

    (Click the banner to go to the related Docs.Code.ExactTarget.com page.)

    ExactTarget is excited to announce that we are enhancing the ExactTarget Web Service API as part of the 135 Release. Because these enhancements only add functionality - no functionality is being changed or removed - we do not expect this enhancement to affect your implementation as it currently exists. See a summary below of the use cases that will be supported by the enhancements.

    To provide more technical detail about the enhancements, ExactTarget maintains API documentation at http://wiki.memberlandingpages.com/A..._Service_Guide. This online resource contains information and sample code regarding the applicable methods, objects, and properties, as well as technical articles and other support material. You can also join the ExactTarget 3sixty developer's community at https://3sixty.exacttarget.com to interact with other ExactTarget API developers and help each other build better code.

    Key Topics for 135.4 Release

    The API enhancements will allow you to use the API to accomplish the following tasks:

    Manage Reply Mail Management

    The API exposes all aspect of reply mail management to the API. You can create and update RMM settings from the web service API.

    Key Topics for 135.3 Release

    The API enhancements will allow you to use the API to accomplish the following tasks:

    Send Profile and Delivery Profiles for Send Definitions

    The API now exposes the sender profile and delivery profile as part of a send definition.

    Retrieve Audience of Send Definition

    You can now retrieve the audience of a send definition using the API.

    Schedule a Send Definition

    You can now schedule a send definition for a future time using the API.

    Key Topics for 135.2 Release

    The API enhancements will allow you to use the API to accomplish the following tasks:

    API Support for Decimal Data Type

    You can now create decimal data type fields via the API. The API also retains the decimal data type during retrieve calls.

    ImportDefinition Calls Support DateTimeLocale Property

    When making calls using the ImportDefinition object, you can specify a value for the DateFormattingLocale property. Using a Retrieve call, you can also determine which DateFormattingLocale value was set for the ImportDefinition object.

    Changes in API Objects and Properties

    Account

    AccountUser

    AsyncResponseType

    BusinessUnit

    Certficate (New Object)

    ClickEvent

    • Url (New Property)

    ContentValidation

    DataExtensionFieldType

    DeliveryProfile

    EmailSendDefinition

    ImportDefinition

    ImportDefinitionSubscriberImportType

    Link

    • Url (New Property)

    MinutelyRecurrence (New Object)

    MinutelyRecurrencePatternTypeEnum (New Object)

    MessagingConfiguration

    PropertyType

    SecurityObject (New Object)

    Send

    SubscriberAddressStatus

    SubscriberSendResult

    TriggeredSendDefinition

    TriggeredSendStatusEnum

    UsernameAuthentication

    Key Topics for 135 Release

    The API enhancements will allow you to use the API to accomplish the following tasks:

    Respect of UTC and Time Zone Date Formats for Inbound Web Service Operations

    The web service API now normalizes all incoming dates and times to server time. This includes the UTC time format. You can set time zone information in your account and have it resolve correctly with the ExactTarget application.

    Enterprise 2.0 Account Management Features (beta)

    The new API enhancements allow you to manage business units, account users, roles, and permission sets via the API. You can use API calls to create, retrieve, update, or delete these entities. Note that you can only manage permission sets at this time; granular control of individual permissions will be introduced in future updates.

    Email Content Enhancements

    You can use the API to retrieve content areas from the ExactTarget application. This allows you to create a content editing interface for use by your company or account users. This enhancement supports retrieval of static content areas associated with an email. You can do this by adding the ContentArea property to the SimpleFilterPart object. This enhancement does not work with dynamic content, and you cannot affect email layout types with this property.

    The API also allows you to send text-only emails. These emails override subscriber preferences and send only text emails with no HTML formatting to all subscribers on a list. Dynamic content does not work with text-only emails, although you can use AMPscript to insert personalization strings and other content.

    Publication and Suppression List Support using ListClassification

    You can use the API to create, retrieve, update, or delete publication and suppression lists for your email sends. This allows you greater control over who receives your messages and uses the flexibility of the API service to better manage your subscribers. You cannot add individual subscribers to suppression lists using the API.

    Import Definition Enhancements

    The API enhancements also introduce a new type of import called ColumnBased. A column-based import has a control column that determines if records are added, updated and deleted. This flexibility makes it easy to support delta file processes.

    Other enhancements that allow data of different formats to be imported include the ability to change the end-of-line representation of a file. You can set this representation using the EndOfLineRepresentation property on the EmailSendDefinition object. You can either set this property globally or per send. You cannot use slashes in this character, and this property does not support subscriber lists.

    You can change the value of the representation of what NULL data is. You can set this at a global level or on a per-import-definition basis. Set this using the NullRepresentation on the ImportDefinition object. This does not function on subscriber lists.

    Finally, you can force your imports activities to import double quotes. 

    Data Extension Imports using DataExtensionObjects

    The API now handles over-the-wire imports of data into a data extension in a more efficient manner. Batches of DataExtensionObjects are batched upon import and process more quickly, improving the response time of the API call.

    Other Important Changes

    The API enhancements also allow you to perform the following actions:

    Customer Key Allowed on the List and Account objects

    You can now use a customer key to work with marketing lists via the API when used . You can create, retrieve, update, and delete using the customer key. 

    File Triggers (beta)

    You can use file triggers (FileTrigger) to cause the API to take action by placing files with manifests on an FTP location. These file triggers look for the presence of new files and take the appropriate action once the files have been located. File triggers are available in limited release and require authorization by ExactTarget to use.

    Web Service Authentication

    Currently, the ExactTarget application uses plaintext SOAP username tokens over SSL for API calls. The API enhancements allow you to encrypt the username token using a certificate. You can use this encryption to secure your SOAP messages at the message level.

    Changes in API Objects and Properties

    The following new objects, properties, and relationships have been added since the last API release:

    AccountUser

    TimeZone (New Object)

    Account

    BusinessUnit (New Object)

    TriggeredSendDefinition

    TriggeredSendStatusEnum

    List

    ListClassificationEnum (New Object)

    DataExtensionFieldType

    ImportDefinition

    ImportDefinitionSubscriberImportType

    ImportDefinitionUpdateType

    ImportDefinitionAutoGenerateDestination (New Object)

    ImportDefinitionColumnBasedActionType (New Object)

    ImportDefinitionColumnBasedAction (New Object)

    EmailSendDefinition

    LandingPage (New Object)

    UnsubscribeBehaviorEnum (New Object)

    Role (New Object)

    PermissionSet (New Object)

    Permission (New Object)

    ExtractTemplate

    ExtractDefinition

    ProgramManifestTemplate (New Object)

    FileTriggerTypeLastPull (New Object)

    FileTriggerExternalReferenceLastPull (New Object)

    FileTrigger (New Object)

    Layout (New Object)

    MessagingConfiguration

    SubscriberSendResult

    Send

    ContentValidation


    This page was last updated by Ryan Williams on Fri, 06 Jan 2012 21:26:44 GMT.

    If you require assistance with the ExactTarget application, please contact Global Support. If you wish to send Ryan direct feedback, fill out the form below:

     


    Was This Page Helpful?
    Suggestions or Comments:
    Name (optional):
    Email Address (optional):
    Enter 18095 backwards:
       
    Tags: (Edit tags)
    • No tags
     
    Comments (0)
    You must login to post a comment.

     
    Powered by MindTouch 2010
    Admin