Usage
Use GetUpdated to get the IDs of individual objects that have been updated or created during the specified time for the specified object.
Basic Steps
- Call GetUpdated, passing in the object and time span for which to retrieve data.
- Iterate through the returned array of IDs. For each ID element in the array, call Retrieve to obtain the latest information you want from the associated object. Your client application must then take the appropriate action on the local data, such as inserting new rows or updating existing ones with the latest information.
- Optionally, the client application saves the request timestamp for future reference.
General Syntax
GetUpdatedResultArray = cventapi.GetUpdated(CvObjectType ObjectType, dateTime StartDate, dateTime EndDate)Input
| Name | Type | Description |
|---|---|---|
| ObjectType | CvObject Type | Object from which to retrieve data. |
| StartDate | DateTime | Starting date/time (GMT – not local time zone) of the time span for which to retrieve the data. The Cvent Web service ignores the seconds portion of the specified dateTime value. For example, 12:30:15 is interpreted as 12:30:00 GMT. |
| EndDate | DateTime | Ending date/time (GMT – not local time zone) of the time span for which to retrieve the data. The Cvent Web service ignores the seconds portion of the specified dateTime value. For example, 12:30:15 is interpreted as 12:30:00 GMT. |
Output
| Name | Type | Description |
|---|---|---|
| Id | ID Array | Array of one or more Object IDs that have been updated or created in the given time span. |
Notes
Updates to any object take, on average, under a minute before they are available in a GetUpdated call.
The GetUpdated call does not support the following object types:
- Budget
- Respondent
- UserGroup
- UserRole
- ConversionRate
- AdvancedLogic
- EventCard
Last updated on