- [Resource: Advertiser](https://developers.google.com/display-video/api/reference/rest/v4/advertisers#Advertiser)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers#Advertiser.SCHEMA_REPRESENTATION)
- [AdvertiserGeneralConfig](https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserGeneralConfig)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserGeneralConfig.SCHEMA_REPRESENTATION)
- [AdvertiserAdServerConfig](https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserAdServerConfig)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserAdServerConfig.SCHEMA_REPRESENTATION)
- [ThirdPartyOnlyConfig](https://developers.google.com/display-video/api/reference/rest/v4/advertisers#ThirdPartyOnlyConfig)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers#ThirdPartyOnlyConfig.SCHEMA_REPRESENTATION)
- [CmHybridConfig](https://developers.google.com/display-video/api/reference/rest/v4/advertisers#CmHybridConfig)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers#CmHybridConfig.SCHEMA_REPRESENTATION)
- [AdvertiserCreativeConfig](https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserCreativeConfig)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserCreativeConfig.SCHEMA_REPRESENTATION)
- [AdvertiserDataAccessConfig](https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserDataAccessConfig)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserDataAccessConfig.SCHEMA_REPRESENTATION)
- [AdvertiserSdfConfig](https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserSdfConfig)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserSdfConfig.SCHEMA_REPRESENTATION)
- [AdvertiserTargetingConfig](https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserTargetingConfig)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserTargetingConfig.SCHEMA_REPRESENTATION)
- [AdvertiserBillingConfig](https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserBillingConfig)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserBillingConfig.SCHEMA_REPRESENTATION)
- [Methods](https://developers.google.com/display-video/api/reference/rest/v4/advertisers#METHODS_SUMMARY)

## Resource: Advertiser

A single advertiser in Display \& Video 360 (DV360).

| JSON representation |
|---|
| ``` { "name": string, "advertiserId": string, "partnerId": string, "displayName": string, "entityStatus": enum (`https://developers.google.com/display-video/api/reference/rest/v4/EntityStatus`), "updateTime": string, "generalConfig": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserGeneralConfig`) }, "adServerConfig": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserAdServerConfig`) }, "creativeConfig": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserCreativeConfig`) }, "dataAccessConfig": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserDataAccessConfig`) }, "integrationDetails": { object (`https://developers.google.com/display-video/api/reference/rest/v4/IntegrationDetails`) }, "servingConfig": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserTargetingConfig`) }, "prismaEnabled": boolean, "billingConfig": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserBillingConfig`) }, "containsEuPoliticalAds": enum (`https://developers.google.com/display-video/api/reference/rest/v4/EuPoliticalAdvertisingStatus`), "defaultBusinessName": string, "defaultLogoAssetId": string } ``` |

| Fields ||
|---|---|
| `name` | `string` Output only. The resource name of the advertiser. |
| `advertiserId` | `string (https://developers.google.com/discovery/v1/type-format format)` Output only. The unique ID of the advertiser. Assigned by the system. |
| `partnerId` | `string (https://developers.google.com/discovery/v1/type-format format)` Required. Immutable. The unique ID of the partner that the advertiser belongs to. |
| `displayName` | `string` Required. The display name of the advertiser. Must be UTF-8 encoded with a maximum size of 240 bytes. |
| `entityStatus` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v4/EntityStatus`)`` Required. Controls whether or not insertion orders and line items of the advertiser can spend their budgets and bid on inventory. - Accepted values are `ENTITY_STATUS_ACTIVE`, `ENTITY_STATUS_PAUSED` and `ENTITY_STATUS_SCHEDULED_FOR_DELETION`. - If set to `ENTITY_STATUS_SCHEDULED_FOR_DELETION`, the advertiser will be deleted 30 days from when it was first scheduled for deletion. |
| `updateTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The timestamp when the advertiser was last updated. Assigned by the system. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `generalConfig` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserGeneralConfig`)`` Required. General settings of the advertiser. |
| `adServerConfig` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserAdServerConfig`)`` Required. Immutable. Ad server related settings of the advertiser. |
| `creativeConfig` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserCreativeConfig`)`` Required. Creative related settings of the advertiser. |
| `dataAccessConfig` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserDataAccessConfig`)`` Settings that control how advertiser data may be accessed. |
| `integrationDetails` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/IntegrationDetails`)`` Integration details of the advertiser. Only `https://developers.google.com/display-video/api/reference/rest/v4/IntegrationDetails#FIELDS.integration_code` is currently applicable to advertiser. Other fields of `https://developers.google.com/display-video/api/reference/rest/v4/IntegrationDetails` are not supported and will be ignored if provided. |
| `servingConfig` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserTargetingConfig`)`` Targeting settings related to ad serving of the advertiser. |
| `prismaEnabled` | `boolean` Whether integration with Mediaocean (Prisma) is enabled. By enabling this, you agree to the following: On behalf of my company, I authorize Mediaocean (Prisma) to send budget segment plans to Google, and I authorize Google to send corresponding reporting and invoices from DV360 to Mediaocean for the purposes of budget planning, billing, and reconciliation for this advertiser. |
| `billingConfig` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserBillingConfig`)`` Required. Billing related settings of the advertiser. |
| `containsEuPoliticalAds` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v4/EuPoliticalAdvertisingStatus`)`` Optional. Whether this advertiser contains line items that serve European Union political ads. If this field is set to `DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING`, then the following will happen: - Any new line items created under this advertiser will be assigned `DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING` if not otherwise specified. - Any existing line items under this advertiser that do not have a set value be updated to `DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING` within a day. |
| `defaultBusinessName` | `string` Optional. The default business name for the advertiser. This is the value used by YouTube and Demand Gen ads under this advertiser if a business name is not provided. |
| `defaultLogoAssetId` | `string (https://developers.google.com/discovery/v1/type-format format)` Optional. The asset ID of the default logo image for the advertiser. This is the asset ID that will be used by YouTube and Demand ads under this advertiser if a logo asset is not provided. You must use `https://developers.google.com/display-video/api/reference/rest/v4/advertisers.adAssets/upload#google.ads.displayvideo.v4.AdAssetService.UploadAdAsset` to upload this asset using the API. |

## AdvertiserGeneralConfig

General settings of an advertiser.

| JSON representation |
|---|
| ``` { "domainUrl": string, "timeZone": string, "currencyCode": string } ``` |

| Fields ||
|---|---|
| `domainUrl` | `string` Required. The domain URL of the advertiser's primary website. The system will send this information to publishers that require website URL to associate a campaign with an advertiser. Provide a URL with no path or query string, beginning with `http:` or `https:`. For example, <http://www.example.com> |
| `timeZone` | `string` Output only. The standard TZ database name of the advertiser's time zone. For example, `America/New_York`. See more at: <https://en.wikipedia.org/wiki/List_of_tz_database_time_zones> For CM360 hybrid advertisers, the time zone is the same as that of the associated CM360 account; for third-party only advertisers, the time zone is the same as that of the parent partner. |
| `currencyCode` | `string` Required. Immutable. Advertiser's currency in ISO 4217 format. Accepted codes and the currencies they represent are: Currency Code : Currency Name - `ARS` : Argentine Peso - `AUD` : Australian Dollar - `BRL` : Brazilian Real - `CAD` : Canadian Dollar - `CHF` : Swiss Franc - `CLP` : Chilean Peso - `CNY` : Chinese Yuan - `COP` : Colombian Peso - `CZK` : Czech Koruna - `DKK` : Danish Krone - `EGP` : Egyption Pound - `EUR` : Euro - `GBP` : British Pound - `HKD` : Hong Kong Dollar - `HUF` : Hungarian Forint - `IDR` : Indonesian Rupiah - `ILS` : Israeli Shekel - `INR` : Indian Rupee - `JPY` : Japanese Yen - `KRW` : South Korean Won - `MXN` : Mexican Pesos - `MYR` : Malaysian Ringgit - `NGN` : Nigerian Naira - `NOK` : Norwegian Krone - `NZD` : New Zealand Dollar - `PEN` : Peruvian Nuevo Sol - `PLN` : Polish Zloty - `RON` : New Romanian Leu - `RUB` : Russian Ruble - `SEK` : Swedish Krona - `TRY` : Turkish Lira - `TWD` : New Taiwan Dollar - `USD` : US Dollar - `ZAR` : South African Rand |

## AdvertiserAdServerConfig

Ad server related settings of an advertiser.

| JSON representation |
|---|
| ``` { // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "thirdPartyOnlyConfig": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers#ThirdPartyOnlyConfig`) }, "cmHybridConfig": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers#CmHybridConfig`) } // End of mutually exclusive fields. } ``` |

| Fields ||
|---|---|
| Required. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response: ||
| `thirdPartyOnlyConfig` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers#ThirdPartyOnlyConfig`)`` The configuration for advertisers that use third-party ad servers only. |
| `cmHybridConfig` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers#CmHybridConfig`)`` The configuration for advertisers that use both Campaign Manager 360 (CM360) and third-party ad servers. |
| End of mutually exclusive fields. ||

## ThirdPartyOnlyConfig

Settings for advertisers that use third-party ad servers only.

| JSON representation |
|---|
| ``` { "pixelOrderIdReportingEnabled": boolean } ``` |

| Fields ||
|---|---|
| `pixelOrderIdReportingEnabled` | `boolean` Whether or not order ID reporting for pixels is enabled. This value cannot be changed once set to `true`. |

## CmHybridConfig

Settings for advertisers that use both Campaign Manager 360 (CM360) and third-party ad servers.

| JSON representation |
|---|
| ``` { "cmAccountId": string, "cmFloodlightConfigId": string, "cmAdvertiserIds": [ string ], "cmSyncableSiteIds": [ string ], "dv360ToCmDataSharingEnabled": boolean, "dv360ToCmCostReportingEnabled": boolean, "cmFloodlightLinkingAuthorized": boolean } ``` |

| Fields ||
|---|---|
| `cmAccountId` | `string (https://developers.google.com/discovery/v1/type-format format)` Required. Immutable. Account ID of the CM360 Floodlight configuration linked with the DV360 advertiser. |
| `cmFloodlightConfigId` | `string (https://developers.google.com/discovery/v1/type-format format)` Required. Immutable. ID of the CM360 Floodlight configuration linked with the DV360 advertiser. |
| `cmAdvertiserIds[]` | `string (https://developers.google.com/discovery/v1/type-format format)` Output only. The set of CM360 Advertiser IDs sharing the CM360 Floodlight configuration. |
| `cmSyncableSiteIds[]` | `string (https://developers.google.com/discovery/v1/type-format format)` A list of CM360 sites whose placements will be synced to DV360 as creatives. If absent or empty in `https://developers.google.com/display-video/api/reference/rest/v4/advertisers/create#google.ads.displayvideo.v4.AdvertiserService.CreateAdvertiser` method, the system will automatically create a CM360 site. Removing sites from this list may cause DV360 creatives synced from CM360 to be deleted. At least one site must be specified. |
| `dv360ToCmDataSharingEnabled` | `boolean` Whether or not to include DV360 data in CM360 data transfer reports. |
| `dv360ToCmCostReportingEnabled` | `boolean` Whether or not to report DV360 cost to CM360. |
| `cmFloodlightLinkingAuthorized` | `boolean` Required. Immutable. By setting this field to `true`, you, on behalf of your company, authorize the sharing of information from the given Floodlight configuration to this Display \& Video 360 advertiser. |

## AdvertiserCreativeConfig

Creatives related settings of an advertiser.

| JSON representation |
|---|
| ``` { "iasClientId": string, "obaComplianceDisabled": boolean, "dynamicCreativeEnabled": boolean, "videoCreativeDataSharingAuthorized": boolean } ``` |

| Fields ||
|---|---|
| `iasClientId` | `string (https://developers.google.com/discovery/v1/type-format format)` An ID for configuring campaign monitoring provided by Integral Ad Service (IAS). The DV360 system will append an IAS "Campaign Monitor" tag containing this ID to the creative tag. |
| `obaComplianceDisabled` | `boolean` Whether or not to disable Google's About this Ad feature that adds badging (to identify the content as an ad) and transparency information (on interaction with About this Ad) to your ads for Online Behavioral Advertising (OBA) and regulatory requirements. About this Ad gives users greater control over the ads they see and helps you explain why they're seeing your ad. [Learn more](https://support.google.com/displayvideo/answer/14315795). If you choose to set this field to `true`, note that ads served through Display \& Video 360 must comply to the following: - Be Online Behavioral Advertising (OBA) compliant, as per your contract with Google Marketing Platform. - In the European Economic Area (EEA), include transparency information and a mechanism for users to report illegal content in ads. If using an alternative ad badging, transparency, and reporting solution, you must ensure it includes the required transparency information and illegal content flagging mechanism and that you notify Google of any illegal content reports using the appropriate [form](https://support.google.com/legal/troubleshooter/1114905?sjid=6787484030557261960-EU#ts=2981967%2C2982031%2C12980091). |
| `dynamicCreativeEnabled` | `boolean` Whether or not the advertiser is enabled for dynamic creatives. |
| `videoCreativeDataSharingAuthorized` | `boolean` By setting this field to `true`, you, on behalf of your company, authorize Google to use video creatives associated with this Display \& Video 360 advertiser to provide reporting and features related to the advertiser's television campaigns. Applicable only when the advertiser has a `https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserAdServerConfig.FIELDS.cm_hybrid_config` ad server configuration. |

## AdvertiserDataAccessConfig

Settings that control how advertiser related data may be accessed.

| JSON representation |
|---|
| ``` { "sdfConfig": { object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserSdfConfig`) } } ``` |

| Fields ||
|---|---|
| `sdfConfig` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserSdfConfig`)`` Structured Data Files (SDF) settings for the advertiser. If not specified, the SDF settings of the parent partner are used. |

## AdvertiserSdfConfig

Structured Data Files (SDF) settings of an advertiser.

| JSON representation |
|---|
| ``` { "overridePartnerSdfConfig": boolean, "sdfConfig": { object (`https://developers.google.com/display-video/api/reference/rest/v4/SdfConfig`) } } ``` |

| Fields ||
|---|---|
| `overridePartnerSdfConfig` | `boolean` Whether or not this advertiser overrides the SDF configuration of its parent partner. By default, an advertiser inherits the SDF configuration from the parent partner. To override the partner configuration, set this field to `true` and provide the new configuration in `https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserSdfConfig.FIELDS.sdf_config`. |
| `sdfConfig` | ``object (`https://developers.google.com/display-video/api/reference/rest/v4/SdfConfig`)`` The SDF configuration for the advertiser. - Required when `https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserSdfConfig.FIELDS.override_partner_sdf_config` is `true`. - Output only when `https://developers.google.com/display-video/api/reference/rest/v4/advertisers#AdvertiserSdfConfig.FIELDS.override_partner_sdf_config` is `false`. |

## AdvertiserTargetingConfig

Targeting settings related to ad serving of an advertiser.

| JSON representation |
|---|
| ``` { "exemptTvFromViewabilityTargeting": boolean } ``` |

| Fields ||
|---|---|
| `exemptTvFromViewabilityTargeting` | `boolean` Whether or not connected TV devices are exempt from viewability targeting for all video line items under the advertiser. |

## AdvertiserBillingConfig

Billing related settings of an advertiser.

| JSON representation |
|---|
| ``` { "billingProfileId": string } ``` |

| Fields ||
|---|---|
| `billingProfileId` | `string (https://developers.google.com/discovery/v1/type-format format)` Required. The ID of a billing profile assigned to the advertiser. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/display-video/api/reference/rest/v4/advertisers/audit` | Audits an advertiser. |
| ### `https://developers.google.com/display-video/api/reference/rest/v4/advertisers/create` | Creates a new advertiser. |
| ### `https://developers.google.com/display-video/api/reference/rest/v4/advertisers/delete` | Deletes an advertiser. |
| ### `https://developers.google.com/display-video/api/reference/rest/v4/advertisers/editAssignedTargetingOptions` | Edits targeting options under a single advertiser. |
| ### `https://developers.google.com/display-video/api/reference/rest/v4/advertisers/get` | Gets an advertiser. |
| ### `https://developers.google.com/display-video/api/reference/rest/v4/advertisers/list` | Lists advertisers that are accessible to the current user. |
| ### `https://developers.google.com/display-video/api/reference/rest/v4/advertisers/listAssignedTargetingOptions` | Lists assigned targeting options of an advertiser across targeting types. |
| ### `https://developers.google.com/display-video/api/reference/rest/v4/advertisers/patch` | Updates an existing advertiser. |