Seller's ID of package to update
OptionalbudgetUpdated budget allocation for this package in the currency specified by the pricing option
OptionalpacingOptionalbid_Updated bid price for auction-based pricing options. This is the exact bid/price to honor unless selected pricing_option has max_bid=true, in which case bid_price is the buyer's maximum willingness to pay (ceiling).
OptionalimpressionsUpdated impression goal for this package
Optionalstart_Updated flight start date/time for this package in ISO 8601 format. Must fall within the media buy's date range.
Optionalend_Updated flight end date/time for this package in ISO 8601 format. Must fall within the media buy's date range.
OptionalpausedPause/resume specific package (true = paused, false = active)
OptionalcanceledCancel this specific package. Cancellation is irreversible — canceled packages stop delivery and cannot be reactivated. Sellers MAY reject with NOT_CANCELLABLE.
Optionalcancellation_Reason for canceling this package.
OptionalcatalogsReplace the catalogs this package promotes. Uses replacement semantics — the provided array replaces the current list. Omit to leave catalogs unchanged.
Optionaloptimization_Replace all optimization goals for this package. Uses replacement semantics — omit to leave goals unchanged.
Optionaltargeting_Optionalkeyword_Keyword targets to add or update on this package. Upserts by (keyword, match_type) identity: if the pair already exists, its bid_price is updated; if not, a new keyword target is added. Use targeting_overlay.keyword_targets in create_media_buy to set the initial list.
The keyword to target
Match type for this keyword
Optionalbid_price?: numberPer-keyword bid price. Inherits currency and max_bid interpretation from the package's pricing option.
Optionalkeyword_Keyword targets to remove from this package. Removes matching (keyword, match_type) pairs. If a specified pair is not present, sellers SHOULD treat it as a no-op for that entry.
The keyword to stop targeting
Match type to remove
Optionalnegative_Negative keywords to add to this package. Appends to the existing negative keyword list — does not replace it. If a keyword+match_type pair already exists, sellers SHOULD treat it as a no-op for that entry. Use targeting_overlay.negative_keywords in create_media_buy to set the initial list.
The keyword to exclude
Match type for exclusion
Optionalnegative_Negative keywords to remove from this package. Removes matching keyword+match_type pairs from the existing list. If a specified pair is not present, sellers SHOULD treat it as a no-op for that entry.
The keyword to stop excluding
Match type to remove
Optionalcreative_Replace creative assignments for this package with optional weights and placement targeting. Uses replacement semantics - omit to leave assignments unchanged.
OptionalcreativesUpload new creative assets and assign to this package (creatives will be added to library). Use creative_assignments instead for existing library creatives.
OptionalcontextOptionalext
Package update configuration for update_media_buy. Identifies package by package_id and specifies fields to modify. Fields not present are left unchanged. Note: product_id, format_ids, and pricing_option_id cannot be changed after creation.