start_rollout
Roll out a release — this IS Android's publish action for the release. Not simply reversible; always confirm with the user, especially on production. Preconditions it cannot satisfy itself: the release needs an artifact attached (attach_artifact_to_release — promote_release does NOT attach one), and the track needs at least one EXPLICITLY selected country (target_rest_of_world alone is not a selection — see update_track_countries). A bare FAILED_PRECONDITION here names nothing: open the Console's release review page (.../tracks/{track}/releases/{release}/review) and expand its errors, which is read-only and states the cause in one sentence. Production additionally requires the app to have passed review once.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| track_id | Yes | Numeric track id (e.g. the long digits in the Play Console URL's .../tracks/<this>/..., not the human alias like "internal"). Call list_tracks first to find it. | |
| release_id | Yes | Release id on this track, from create_release/get_track. | |
| play_app_id | Yes | Numeric Play app id from the Play Console URL (.../app/<this>/...). NOT the package name. | |
| developer_id | Yes | Numeric Play Console developer id (from the Play Console URL). | |
| rollout_percentage | No | Percentage of users to roll out to, 0-100. Defaults to 100 (full rollout) if omitted. | |
| targeted_countries | No | Comma-separated ISO 3166-1 alpha-2 codes, e.g. "NG,GH,KE". NOTE: on a track that has no country targeting of its own this does NOT work — tested live, Play still refuses. Use update_track_countries to set the track's countries first; this parameter only narrows a rollout on a track that is already targeted. Nothing is defaulted — ask the user. | |
| google_account_email | Yes | The signed-in Google account email that owns this Play Console developer account. Call list_accounts first and confirm with the user — do not guess. | |
| notification_message | No | Short user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names. | |
| target_rest_of_world | No | "true" serves every country/region Play allows; "false" serves only targeted_countries. Omitted is NOT the same as "false" — it keeps whatever the track already targets. Same caveat as targeted_countries: it cannot stand in for update_track_countries on an untargeted track. |