- [Resource: Advertiser](https://developers.google.com/doubleclick-advertisers/rest/v5/advertisers#Advertiser) - [JSON representation](https://developers.google.com/doubleclick-advertisers/rest/v5/advertisers#Advertiser.SCHEMA_REPRESENTATION) - [AdvertiserStatus](https://developers.google.com/doubleclick-advertisers/rest/v5/advertisers#AdvertiserStatus) - [MeasurementPartnerAdvertiserLink](https://developers.google.com/doubleclick-advertisers/rest/v5/advertisers#MeasurementPartnerAdvertiserLink) - [JSON representation](https://developers.google.com/doubleclick-advertisers/rest/v5/advertisers#MeasurementPartnerAdvertiserLink.SCHEMA_REPRESENTATION) - [EuPoliticalAdsDeclaration](https://developers.google.com/doubleclick-advertisers/rest/v5/advertisers#EuPoliticalAdsDeclaration) - [Methods](https://developers.google.com/doubleclick-advertisers/rest/v5/advertisers#METHODS_SUMMARY) ## Resource: Advertiser Contains properties of a Campaign Manager [advertiser](https://support.google.com/dcm/answer/2829356). | JSON representation | |---| | ``` { "id": string, "name": string, "accountId": string, "subaccountId": string, "floodlightConfigurationId": string, "advertiserGroupId": string, "status": enum (`https://developers.google.com/doubleclick-advertisers/rest/v5/advertisers#AdvertiserStatus`), "defaultEmail": string, "clickThroughUrlSuffix": string, "defaultClickThroughEventTagId": string, "idDimensionValue": { object (`https://developers.google.com/doubleclick-advertisers/rest/v5/DimensionValue`) }, "floodlightConfigurationIdDimensionValue": { object (`https://developers.google.com/doubleclick-advertisers/rest/v5/DimensionValue`) }, "originalFloodlightConfigurationId": string, "kind": string, "suspended": boolean, "measurementPartnerLink": { object (`https://developers.google.com/doubleclick-advertisers/rest/v5/advertisers#MeasurementPartnerAdvertiserLink`) }, "euPoliticalAdsDeclaration": enum (`https://developers.google.com/doubleclick-advertisers/rest/v5/advertisers#EuPoliticalAdsDeclaration`) } ``` | | Fields || |---|---| | `id` | `string (https://developers.google.com/discovery/v1/type-format format)` ID of this advertiser. This is a read-only, auto-generated field. | | `name` | `string` Name of this advertiser. This is a required field and must be less than 256 characters long and unique among advertisers of the same account. | | `accountId` | `string (https://developers.google.com/discovery/v1/type-format format)` Account ID of this advertiser.This is a read-only field that can be left blank. | | `subaccountId` | `string (https://developers.google.com/discovery/v1/type-format format)` Subaccount ID of this advertiser.This is a read-only field that can be left blank. | | `floodlightConfigurationId` | `string (https://developers.google.com/discovery/v1/type-format format)` Floodlight configuration ID of this advertiser. The floodlight configuration ID will be created automatically, so on insert this field should be left blank. This field can be set to another advertiser's floodlight configuration ID in order to share that advertiser's floodlight configuration with this advertiser, so long as: - This advertiser's original floodlight configuration is not already associated with floodlight activities or floodlight activity groups. - This advertiser's original floodlight configuration is not already shared with another advertiser.
| | `advertiserGroupId` | `string (https://developers.google.com/discovery/v1/type-format format)` ID of the advertiser group this advertiser belongs to. You can group advertisers for reporting purposes, allowing you to see aggregated information for all advertisers in each group. | | `status` | ``enum (`https://developers.google.com/doubleclick-advertisers/rest/v5/advertisers#AdvertiserStatus`)`` Status of this advertiser. | | `defaultEmail` | `string` Default email address used in sender field for tag emails. | | `clickThroughUrlSuffix` | `string` Suffix added to click-through URL of ad creative associations under this advertiser. Must be less than 129 characters long. | | `defaultClickThroughEventTagId` | `string (https://developers.google.com/discovery/v1/type-format format)` ID of the click-through event tag to apply by default to the landing pages of this advertiser's campaigns. | | `idDimensionValue` | ``object (`https://developers.google.com/doubleclick-advertisers/rest/v5/DimensionValue`)`` Dimension value for the ID of this advertiser. This is a read-only, auto-generated field. | | `floodlightConfigurationIdDimensionValue` | ``object (`https://developers.google.com/doubleclick-advertisers/rest/v5/DimensionValue`)`` Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field. | | `originalFloodlightConfigurationId` | `string (https://developers.google.com/discovery/v1/type-format format)` Original floodlight configuration before any sharing occurred. Set the `floodlightConfigurationId` of this advertiser to `originalFloodlightConfigurationId` to unshare the advertiser's current floodlight configuration. You cannot unshare an advertiser's floodlight configuration if the shared configuration has activities associated with any campaign or placement. | | `kind` | `string` Identifies what kind of resource this is. Value: the fixed string `"dfareporting#advertiser"`. | | `suspended` | `boolean` Suspension status of this advertiser. | | `measurementPartnerLink` | ``object (`https://developers.google.com/doubleclick-advertisers/rest/v5/advertisers#MeasurementPartnerAdvertiserLink`)`` Measurement partner advertiser link for tag wrapping. | | `euPoliticalAdsDeclaration` | ``enum (`https://developers.google.com/doubleclick-advertisers/rest/v5/advertisers#EuPoliticalAdsDeclaration`)`` Optional. Whether the advertiser plans to serve EU political ads. | ## AdvertiserStatus Advertiser approval status | Enums || |---|---| | `APPROVED` | Approved (ads can deliver) | | `ON_HOLD` | On-hold (all ads are stopped) | ## MeasurementPartnerAdvertiserLink | JSON representation | |---| | ``` { "measurementPartner": enum (`https://developers.google.com/doubleclick-advertisers/rest/v5/MeasurementPartner`), "linkStatus": enum (`https://developers.google.com/doubleclick-advertisers/rest/v5/MeasurementPartnerLinkStatus`), "partnerAdvertiserId": string } ``` | | Fields || |---|---| | `measurementPartner` | ``enum (`https://developers.google.com/doubleclick-advertisers/rest/v5/MeasurementPartner`)`` Measurement partner used for tag wrapping. | | `linkStatus` | ``enum (`https://developers.google.com/doubleclick-advertisers/rest/v5/MeasurementPartnerLinkStatus`)`` Status of the partner link. | | `partnerAdvertiserId` | `string` partner Advertiser Id. | ## EuPoliticalAdsDeclaration Options for EU political ads declaration. | Enums || |---|---| | `ADVERTISER_PLANS_TO_SERVE_EU_POLITICAL_ADS` | You'll need to confirm if your campaign contains EU political advertising. | | `ADVERTISER_DOES_NOT_PLAN_TO_SERVE_EU_POLITICAL_ADS` | All new campaigns will have "No" selected for the question that asks if your campaign has EU political ads. You can change this for any campaign at any time. | | ## Methods || |---|---| | ### `https://developers.google.com/doubleclick-advertisers/rest/v5/advertisers/get` | Gets one advertiser by ID. | | ### `https://developers.google.com/doubleclick-advertisers/rest/v5/advertisers/insert` | Inserts a new advertiser. | | ### `https://developers.google.com/doubleclick-advertisers/rest/v5/advertisers/list` | Retrieves a list of advertisers, possibly filtered. | | ### `https://developers.google.com/doubleclick-advertisers/rest/v5/advertisers/patch` | Updates an existing advertiser. | | ### `https://developers.google.com/doubleclick-advertisers/rest/v5/advertisers/update` | Updates an existing advertiser. |