updateMultiCurrencyRentalOffer()


Update different offers for different countries using localizedData array. Plase note, that you are unable to edit currency.

Parameters:

Name Type Description
publisherToken string You can find your publisher token at api-keys page.
multiCurrencyOfferId string E.g. if you create multicurrency offer and you get couple of ids: A767351455_FR, A767351455_US, A767351455_GB. multiCurrencyOfferId is just A767351455
offerData object No description
-price floatOffer price (in publisher's currency), value between 0.14 and 99.99
-title stringTitle of the offer, up to 70 chars.
-period string
-url stringAdditional offer description, up to 110 chars
-description stringAdditional offer description, up to 110 chars
-tags arrayTags attached to offer. Read more.
-countrystring2-letter country code
-currency stringChoose one: USD, EUR, GBP, CAD, AUD, NZD, SEK, DKK, NOK, TRL, ZAR, XOF
-price floatvalue between 0.14 and 99.99
-title stringTitle of the offer, up to 70 chars.
-url stringUrl to content
-description stringAdditional offer description, up to 110 chars
-videoId stringLink offer with unique video asset id
-contentExternalId stringThis parameter is for your own usage. You can put here id of article or video, anything what can make your offer clearer for you.
-contentExternalData stringIf you want to store a few extra elements related to the sale you can use this string to store additional data.
-geoRestrictionEnabled boolSet "true" to enable geo-restriction on this offer
-geoRestrictionType stringChoose type of geo-restriction: whitelist / blacklist
-geoRestrictionCountries arrayBased on geoRestrictionType, set the array of whitelisted/blacklisted countries.
localizedData array No description
-price floatOffer price (in publisher's currency), value between 0.14 and 99.99
-title stringTitle of the offer, up to 70 chars.
-period string
-url stringAdditional offer description, up to 110 chars
-description stringAdditional offer description, up to 110 chars
-tags arrayTags attached to offer. Read more.
-countrystring2-letter country code
-currency stringChoose one: USD, EUR, GBP, CAD, AUD, NZD, SEK, DKK, NOK, TRL, ZAR, XOF
-price floatvalue between 0.14 and 99.99
-title stringTitle of the offer, up to 70 chars.
-url stringUrl to content
-description stringAdditional offer description, up to 110 chars
-videoId stringLink offer with unique video asset id
-contentExternalId stringThis parameter is for your own usage. You can put here id of article or video, anything what can make your offer clearer for you.
-contentExternalData stringIf you want to store a few extra elements related to the sale you can use this string to store additional data.
-geoRestrictionEnabled boolSet "true" to enable geo-restriction on this offer
-geoRestrictionType stringChoose type of geo-restriction: whitelist / blacklist
-geoRestrictionCountries arrayBased on geoRestrictionType, set the array of whitelisted/blacklisted countries.

- required parameter


Request:

[
    {
        "method": "updateMultiCurrencyRentalOffer",
        "params": {
            "publisherToken": "klj_nerb324sPLhmzLtp4mDmdc8slwNNyALt-1Xn2Hy0Icfay",
            "multiCurrencyOfferId": "R841924054",
            "offerData": {
                "price": "10",
                "tags": []
            },
            "localizedData": [
                {
                    "country": "US",
                    "currency": "USD",
                    "price": "11",
                    "title": "Test offer for US customers"
                },
                {
                    "country": "FR",
                    "currency": "EUR",
                    "price": "9"
                }
            ]
        },
        "jsonrpc": "2.0",
        "id": 1
    }
]

Response:

[
    {
        "result": {
            "multiCurrencyOfferId": "R841924054",
            "offers": [
                {
                    "id": "R841924054_US",
                    "publisherEmail": "associate@email.com",
                    "url": "http:\/\/www.testoffer.com",
                    "title": "Test offer for US customers",
                    "description": "Test offer description",
                    "currency": "USD",
                    "averageRating": 4,
                    "active": true,
                    "createdAt": 1384260473,
                    "updatedAt": 1384265819,
                    "price": 11,
                    "applicableTaxRate": "0.21",
                    "tags": [],
                    "period": "24",
                    "videoId": "",
                    "contentExternalId": "0",
                    "contentExternalData": null
                },
                {
                    "id": "R841924054_FR",
                    "publisherEmail": "associate@email.com",
                    "url": "http:\/\/testoffer.com\/fr",
                    "title": "Test offer for French customers",
                    "description": "Test offer description",
                    "currency": "EUR",
                    "averageRating": 4,
                    "active": true,
                    "createdAt": 1384260473,
                    "updatedAt": 1384265820,
                    "price": 9,
                    "applicableTaxRate": "0.21",
                    "tags": [],
                    "period": "24",
                    "videoId": "",
                    "contentExternalId": "0",
                    "contentExternalData": null
                }
            ]
        },
        "id": "1",
        "error": null,
        "jsonrpc": "2.0"
    }
]

Remember! you can always check it by yourself using API Console - updateMultiCurrencyRentalOffer()

Back to Rental Offers