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.

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.
  • REGISTRATION: The app is being modified.
  • SALE: The app is for sale in Galaxy Store.

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.

  • ENABLE_ROLLOUT: Set the default rollout rate and optionally, the country-specific rollout rates.
  • DISABLE_ROLLOUT: Stop the staged rollout and deploy the app to all users globally.

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.