Update Staged Rollout Rate
Enable/Update or disable staged rollout of an application. When enabling a staged rollout, set a default rollout rate and optionally set country-specific rollout rates. When updating a rollout rate, if appStatus is SALE or you are updating an app that was previously deployed, the rollout rate must be set higher than the previously default rollout rate. Disabling a staged rollout releases the app to all users globally.
In Seller Portal, the app must have a status of Registering, Updating, Re-Registering, Ready for Sale, or For Sale. See App Status Information in the Seller Portal online guide for more information about Seller Portal stages and statuses.
For the contentStatus value returned by the Content Publish API, this is the same as REGISTERING, UPDATING, RE_REGISTERING, READY_FOR_SALE, or FOR_SALE statuses.
For a mapping of status values among Seller Portal, contentStatus, and appStatus, see Status Parameters Mapping.
For more information about staged rollouts, see Set a staged rollout in the Seller Portal online guide.
Request
PUT /seller/v2/content/stagedRolloutRate
Parameters
Name | Type | In | Description |
---|---|---|---|
contentId | string | body | Required. The unique 12-digit identifier of the app. |
appStatus | string | body | Required. The status of the app.
For a mapping of status values among Seller Portal, contentStatus, and appStatus, see Status Parameters Mapping. |
function | string[] | body | Required. Enable or disable staged rollout.
|
rolloutRate | Integer | body | Required if enabling a staged rollout. The default percentage of users to which your app is released in a country if a specific rollout rate is not set for the country. If appStatus is SALE or you are updating an app that was previously deployed, the rollout rate must be higher than the previously set default rollout rate.
|
countries[].countryCode | string | body | Optional. Country code of the country for which you want to set a specific rollout rate. |
countries[].rolloutRate | integer | body | Required if you specify a countryCode. The percentage of users to which your app is released in the specified country. If this rollout rate is set higher than the default rollout rate, the staged rollout cannot be disabled. If appStatus is SALE or you are updating an app that was previously deployed, the rollout rate must be higher than the previously set rollout rate and the default rollout rate (set in rolloutRate ).
|
curl -i -X PUT \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <your-access-token>" \
-H "service-account-id: <your-service-account-id>" \
-d '{
"contentId": "000007654321",
"function": "ENABLE_ROLLOUT",
"appStatus": "SALE",
"rolloutRate": 35,
"countries": [{
"countryCode": "USA",
"rolloutRate": 40
},
{
"countryCode": "KOR",
"rolloutRate": 45
}]
}
{
"contentId": "123456789012",
"function": "DISABLE_ROLLOUT",
"appStatus": "REGISTRATION"
}
}' \
"https://devapi.samsungapps.com/seller/v2/content/stagedRolloutRate"
See Authorization Header Parameters for more information about the authorization header requirements for the Content Publish API (which is part of the Galaxy Store Developer API).
Response
Success
"resultCode": "0000",
"resultMessage": "Ok"
See Failure response codes for a list of possible response codes when a request fails.