Constant Contact encourages the use of asynchronous background jobs
to manage large collections of data. The Bulk Activity collection is
used to create and manage those jobs, called Activities.
Currently, the collection allows you to create jobs to add, remove and
download contacts from contact lists. It also allows you to check the
status of a customer's activities and to see when an activity is
completed and whether it succeeded or failed. A single "call" to the
"Activities" resource generally operates on a set of contacts. The data
for that set of contacts is held in a formatted file, described below.
The Activities resource is designed to be used only with large sets
of contacts (ie. 25 or more). (As discussed in the Constant Contact API Terms and Conditions,
intentional and unintentional misuse of this bulk API to frequently
manage individual contacts or small sets of contacts is subject to API
access or account termination).
The response is made up of a feed element which contains some metadata about the feed followed by a series of entry elements. Each entry is made up of some metadata followed by a content element. Inside the content element is a Activity element which describes the attributes of a particular activity. The structure of the Activity element is described below.
Retrieving the Details of an Individual Activity
An individual activity entry may be retrieved by issuing an HTTP GET to
the entry's URI. The URI may be obtained from the Location header after
creating a new entry or from the link element with rel="edit" attribute in an existing entry. A typical entry looks like this: