bidders

POST /v1/bidders/{biddersId}/pretargetingConfigs/{pretargetingConfigsId}:removeTargetedPublishers

Removes targeted publishers from the pretargeting config.

Request

Base URL
https://realtimebidding.googleapis.com
Auth
OAuth 2 and OAuth 2
Implicithttps://accounts.google.com/o/oauth2/auth
Scopeshttps://www.googleapis.com/auth/realtime-bidding
Authorization codehttps://accounts.google.com/o/oauth2/auth
Token URLhttps://accounts.google.com/o/oauth2/token
Scopeshttps://www.googleapis.com/auth/realtime-bidding
TypeScript
https://skmtc.dev/google/apis/realtimebidding/docs/v1/bidders/:biddersId/pretargetingConfigs/:pretargetingConfigsId:removeTargetedPublishers/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

biddersIdstring required

pretargetingConfigsIdstring required

Request body

publisherIdsstring[]

A list of publisher IDs to stop targeting in the pretargeting configuration. These values will be removed from the list of targeted publisher IDs in PretargetingConfig.publisherTargeting.values. Publishers are identified by their publisher ID from ads.txt / app-ads.txt. See https://iabtechlab.com/ads-txt/ and https://iabtechlab.com/app-ads-txt/ for more details.

Response

Successful response

allowedUserTargetingModesstring[]

Deprecated: The value of this field no longer has any effect. Targeting modes included by this config. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.

billingIdstring int64

Output only. The identifier that corresponds to this pretargeting config that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one config, the buyer chooses which billing_id to attribute each of their bids.

displayNamestring

The diplay name associated with this config. This name must be unique among all the pretargeting configs a bidder has.

excludedContentLabelIdsstring[]

The sensitive content category label IDs excluded in this config. Bid requests for inventory with any of the specified content label IDs will not be sent. Refer to this file https://storage.googleapis.com/adx-rtb-dictionaries/content-labels.txt for category IDs.

includedEnvironmentsstring[]

Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.

includedFormatsstring[]

Creative formats included by this config. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.

includedLanguagesstring[]

The languages included in this config, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.

includedMobileOperatingSystemIdsstring[]

The mobile operating systems included in this config as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv

includedPlatformsstring[]

The platforms included by this config. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.

includedUserIdTypesstring[]

User identifier types included in this config. At least one of the user identifier types specified in this list must be available for the bid request to be sent.

interstitialTargeting'INTERSTITIAL_TARGETING_UNSPECIFIED' | 'ONLY_INTERSTITIAL_REQUESTS' | 'ONLY_NON_INTERSTITIAL_REQUESTS'

The interstitial targeting specified for this config. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.

invalidGeoIdsstring[]

Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.

maximumQpsstring int64

The maximum QPS threshold for this config. The bidder should receive no more than this number of bid requests matching this config per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide

minimumViewabilityDecileinteger

The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the config will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.

namestring

Output only. Name of the pretargeting config that must follow the pattern bidders/{bidder_account_id}/pretargetingConfigs/{config_id}

state'STATE_UNSPECIFIED' | 'ACTIVE' | 'SUSPENDED'

Output only. The state of this pretargeting config.

Changes

No recorded changes to this operation across all 5 revisions of this API.