deactivate_campaign_asset
async
¶
deactivate_campaign_asset(
catalog: Catalog,
campaign_identifier: CampaignIdentifier,
campaign_asset_identifier: CampaignAssetId,
*,
config_overrides: Optional[AsyncPartnerCentralMarketingClientConfig] = None,
) -> DeactivateCampaignAssetResponse
Stops a live campaign asset: an email's scheduled send is withdrawn, a social post is removed before it publishes. On a completed campaign, it also removes a published document, banner or landing page. Synchronous, and safe to repeat. Does not delete the asset record, so a stopped email or social post can be started again. Not every asset can be stopped, and the reasons differ in kind. An email that has begun sending cannot be recalled: the send is gone. A document, a banner or a landing page is refused with ASSET_NOT_DEACTIVATABLE until the campaign has completed (the UTC date is after its EndOn). Until then the partner fixes one in place by updating it and activating it again, which keeps its URL, so every email that already linked to it keeps working. Once the campaign has completed, the removal is permanent, because a completed campaign can't activate anything again: - A document's published PDF is deleted. Its URL stops serving within about a minute (the CDN revalidates), and PublicUrl is no longer returned. Anything that linked to it, such as a landing page's download button or a sent email, reaches an error page. The export still contains the document. - A banner's or landing page's published object is taken down at the delivery platform, and the images the partner put on it are deleted. A landing page stops capturing leads, and its PublicUrl is no longer returned. A partner site that embedded a banner shows nothing there. The platform's own CDN can keep serving a copy a visitor already cached, which collects nothing. A landing page and a document it links to can be removed in either order.
Parameters:
-
catalog(Catalog) –The catalog (AWS or Sandbox).
-
campaign_identifier(CampaignIdentifier) –The campaign identifier.
-
campaign_asset_identifier(CampaignAssetId) –The asset identifier.
Raises:
-
AccessDeniedException–You do not have sufficient access to perform this action. An IAM denial carries no
Reason. A refusal for the caller's Partner Central state carries one, so a client tells the two apart by its presence. -
InternalServerException–An unexpected error occurred during the processing of the request.
-
ThrottlingException–The request was denied due to request throttling.
-
ValidationException–The input fails to satisfy the constraints specified by the service. A caller branches on
Reason, and where the rejection is attributable to particular fields it readsFieldListrather than parsingMessage, which is prose and may change. -
ConflictException–The request conflicts with the current state of the resource.
-
ResourceNotFoundException–The specified resource does not exist.
-
UnknownServiceError–The service returned an error code this client does not model.