pause_creative_ads
Pause the platform ads running one creative — the “stop this creative” action. Each ad goes through the same status write as update_ad_status and gets its own DecisionLogEntry; one ad failing does not stop the others.
Preview first. preview defaults to true: the call lists the ads that would pause and any per-ad refusal (a platform without ad-level writes, an ad whose ad group is not known yet) without calling the platform. Call again with preview: false to pause. Requires the can_publish_ads permission.
Which ads: every ad of the creative that may still be live (its linked_ads from list_creative_library whose status is not inactive), or only the ad_ids you pass.
Parameters#
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
creative_id | string | yes | AdCreative id, from list_creative_library | |
ad_ids | string[] | no | Only these ads of the creative; each must be one of its linked_ads | |
preview | boolean | no | true | true lists without calling the platform; false pauses |
Returns#
{
"creative_id": "ad_crtv_abc123",
"ad_account_id": "ad_acct_abc123",
"platform": "google_ads",
"preview": false,
"applied": true,
"ok_count": 1,
"failed_count": 1,
"ads": [
{ "ad_id": "9001", "ad_group_id": "77", "campaign_id": "5", "status": "active",
"ok": true, "error": null, "error_type": null, "decision_id": "obs_abc123" },
{ "ad_id": "9002", "ad_group_id": null, "campaign_id": "5", "status": null,
"ok": false, "error": "google_ads ad status updates require ad_group_id.",
"error_type": "validation_error", "decision_id": null }
],
"source": "adlyse.ads_writes@v1"
}Errors#
error_type | When |
|---|---|
auth_error | Missing / invalid credential, or no can_publish_ads |
not_found | The creative doesn’t belong to your org |
validation_error | The creative runs in no ad account, or an ad_ids entry isn’t one of its ads |
no_live_ads | Every ad of the creative is already inactive |
Per-ad failures (unsupported_for_platform, credentials_missing, platform_error, …) come back on that ad’s row, as for update_ad_status.