reviseMultipleFixedPriceItems
reviseMultipleFixedPriceItems allows you to update details of up to 10 items listed on Bonanza (whether they are currently available for sale or not). This can be used to update many items with different changes, or many items with the same change
reviseMultipleFixedPriceItems input
Applying different changes to many items
Argument | Type | Occurrence | Meaning |
---|---|---|---|
Call-specific Input Fields | |||
items | Container | Optional, repeatable: [0..9] | Array of containers (max 10) for describing item changes. |
items.itemId | integer | Required | Specifies the Bonanza ID of the item to modify |
items.item | Container | Required | Specifies the properties of the item to modify. Allows the same item properties as addFixedPriceItem |
For example, you could post something like:
request_params = {'requesterCredentials' => { 'BonanzaAuthToken' => 'users_auth_token' }, 'items' => [{'itemId' => 1, 'item' => { 'title' => 'my new title' }}, {'itemId' => 2, 'item' => { 'quantity' => 17 }}]}.to_json @https.post("/api_requests/secure_request", "reviseMultipleFixedPriceItemsRequest=#{ request_params }, ...)
This would change item #1's title to "my new title" and item #2's quantity to 17, assuming that these items belonged to the user whose auth token you passed in.
Applying the same change to many items
Argument | Type | Occurrence | Meaning |
---|---|---|---|
Call-specific Input Fields | |||
itemIds | Array | Required | Array of Bonanza item IDs (max 10) |
item | Container | Required | Specifies the properties of the item to modify. Allows the same item properties as addFixedPriceItem |
The format for this call is identical to addFixedPriceItem, except you add an "itemIds" => [array of item ids] in the input parameters to specify the items that you want to revise.
For example, you could post something like:
request_params = {'requesterCredentials' => { 'BonanzaAuthToken' => 'users_auth_token' }, 'itemIds' => [1,2], 'item' => { 'title' => 'my revised item title' }}.to_json @https.post("/api_requests/secure_request", "reviseMultipleFixedPriceItemsRequest=#{ request_params }, ...)
This would change item #1 and item #2's title to "my revised item title," assuming that these items belonged to the user whose auth token you passed in.
reviseMultipleFixedPriceItems output
The response for this call is the same as for addFixedPriceItem, except that the response is in the form of an array that corresponds to the result of the revision for each item that you passed in.