update

Changes feed parameters.

  1. Restrictions
  2. Request
  3. Response

Restrictions

Maximum of 50 feeds per method call.

Changing the business type and source type is not allowed.

Request

Request structure in JSON format:

{
  "method": "update",
  "params": { /* params */
    "Feeds": [{ /* FeedUpdateItem */
      "Id": (long), /* required */
      "Name": (string),
      "UrlFeed": { /* UrlFeedUpdate */
        "Url": (string),
        "Login": (string), /* nillable */
        "Password": (string), /* nillable */
        "RemoveUtmTags": ( "YES" | "NO" )
      },
      "FileFeed": { /* FileFeedUpdate */
        "Data": (base64Binary), /* required */
        "Filename": (string) /* required */
      }
    }, ... ] /* required */
  } 
} 
Parameter Type Description Required
Params structure (for JSON) / UpdateRequest structure (for SOAP)
Feeds array of FeedUpdateItem Feeds to change. Yes
FeedUpdateItem structure
Id long The feed ID. Yes
Name string The name of the feed. Maximum of 255 characters. No
UrlFeed UrlFeedUpdate Parameters of the feed that is available at the URL. No
FileFeed FileFeedUpdate Parameters of the feed that is passed in the request. No
UrlFeedUpdate structure
Url string Feed URL. Maximum of 1024 characters. It must include the protocol and domain name. No
Login string, nillable Login for accessing the feed (if required). Maximum of 255 characters. No
Password string, nillable Password for accessing the feed (if required). Maximum of 255 characters. No
RemoveUtmTags YesNoEnum Automatically delete UTM tags from links in the feed. The default value is NO. No
FileFeedUpdate structure
Data base64Binary

A base64-encoded feed to upload. The feed size is limited by the total request size — maximum of 50 MB.

Note.

When using the SOAP library, place the feed file directly in this field, and the library automatically encodes it as base64 during transmission.

When using JSON format, first encode the binary data in base64, then pass it as a string.

Yes
Filename string Name of the feed file. Maximum of 255 characters. Yes
Parameter Type Description Required
Params structure (for JSON) / UpdateRequest structure (for SOAP)
Feeds array of FeedUpdateItem Feeds to change. Yes
FeedUpdateItem structure
Id long The feed ID. Yes
Name string The name of the feed. Maximum of 255 characters. No
UrlFeed UrlFeedUpdate Parameters of the feed that is available at the URL. No
FileFeed FileFeedUpdate Parameters of the feed that is passed in the request. No
UrlFeedUpdate structure
Url string Feed URL. Maximum of 1024 characters. It must include the protocol and domain name. No
Login string, nillable Login for accessing the feed (if required). Maximum of 255 characters. No
Password string, nillable Password for accessing the feed (if required). Maximum of 255 characters. No
RemoveUtmTags YesNoEnum Automatically delete UTM tags from links in the feed. The default value is NO. No
FileFeedUpdate structure
Data base64Binary

A base64-encoded feed to upload. The feed size is limited by the total request size — maximum of 50 MB.

Note.

When using the SOAP library, place the feed file directly in this field, and the library automatically encodes it as base64 during transmission.

When using JSON format, first encode the binary data in base64, then pass it as a string.

Yes
Filename string Name of the feed file. Maximum of 255 characters. Yes

Response

Response structure in JSON format:

{
  "result": {  /* result */
    "UpdateResults": [{  /* ActionResult */
      "Id": (long),
      "Warnings": [{  /* ExceptionNotification */
        "Code": (int), /* required */
        "Message": (string), /* required */
        "Details": (string)
       }, ...
      ],
      "Errors": [{  /* ExceptionNotification */
        "Code": (int), /* required */
        "Message": (string), /* required */
        "Details": (string)
       }, ...
      ] 
    }, ... ] /* required */
  }
}
Parameter Type Description
Result structure (for JSON) / UpdateResponse structure (for SOAP)
UpdateResults array of ActionResult Results of changing the feed parameters.
ActionResult structure
Id long The feed ID. Returned if there aren't any errors. See the section Operations on object arrays.
Warnings array of ExceptionNotification

Warnings that occurred during the operation.

Errors array of ExceptionNotification

Errors that occurred during the operation.

Parameter Type Description
Result structure (for JSON) / UpdateResponse structure (for SOAP)
UpdateResults array of ActionResult Results of changing the feed parameters.
ActionResult structure
Id long The feed ID. Returned if there aren't any errors. See the section Operations on object arrays.
Warnings array of ExceptionNotification

Warnings that occurred during the operation.

Errors array of ExceptionNotification

Errors that occurred during the operation.