Action

When sending data in incremental updates, specifiying an action is required so DV knows how it should handle the mutation. DV accepts three types of actions: add, update and delete.

• add
  Used to add a new object to the inventory of an advertiser. If the object already exists (based upon the advertiser identifier and object identifier), the mutation will not fail, but instead the action will automatically be converted to an update.
• update
  Used to modify an existing object. If the object cannot be found the mutation will not fail, but instead the action will automatically be converted to an add.
  It is necessary to send all object information, not just the changed fields.
• delete
  Used to delete an existing object. It will automatically be deselected for the sites where the object is currently published, thus removing the listings.
  Only the advertiser identifier, object identifier and action fields are necessary for a delete action.

This field is not applicable to bulk transfers since they always contain the complete set of objects to be advertised. Deletes are achieved by excluding an object from the bulk transfer.

Advertising sold objects

Sold (yes/no) is just another object property. Usually, when an object is sold a delete action is used to make sure the object gets removed from all sites. However, if so desired, an update action can be used to set the sold property to yes. This will keep the object advertised until a delete action is performed. Please note that not all sites allow listing sold objects. The advertiser should check the feedback and deselect the sold object for those sites (thus removing the object from those sites), leaving the sold object advertised on other sites.