late-sdk 0.0.1316 → 0.0.1317

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a919072b50f8b830e9a4fa5e528a20043107f7d89a88cb8df923d4480d86f028
-  data.tar.gz: 5f52533434f404820e2333b1f7c3f3fe1d0c23b8597d01e562bec0c4b2daa451
+  metadata.gz: 72b2db3eaed4145c4eaf6a64a99b855d639c506c0898a4b052d561e0a60fb0c1
+  data.tar.gz: ecfe30bb9f42496754271def6b65003fa9be770761c8a379d9196096939b7627
 SHA512:
-  metadata.gz: e66f5929fbbb16bfb40792951a5e2cd4f099779fdf2ed5ff7ba74977f0e96a99e90bab376c6ab80dbd005c45cb260f1062141803bef330b5199c2d2c9bfb9eb0
-  data.tar.gz: 4b2ae0bdcaf92791c5306e332709f674bfe8addfa95c0f5c9a7aa229f9a53218e23ab33cc8dde5da875704f5e09e598c3b00bdb7d4005819bda999cd6379d794
+  metadata.gz: f3b1495f07b84eb30174b9981d5cd8fee3ad3eb5bc5390ebefe9ae27791be2a8251fb9b590dd9dfeae554f859c5f50867de93095522c541a0d86daa43ff1c024
+  data.tar.gz: 141f307bacf4c8ac0303f7316199eb1342db8921be02545f8943642fbec2a2f9158d17d53d7f70352e8fa09fe568af0d565a3a20c4ffbf376535e3d529f7659f

data/README.md

@@ -222,7 +222,7 @@ Class | Method | HTTP request | Description
 *Zernio::AdCampaignsApi* | [**get_campaign_ad_schedule**](docs/AdCampaignsApi.md#get_campaign_ad_schedule) | **GET** /v1/ads/campaigns/{campaignId}/ad-schedule | Read a campaign's ad schedule (dayparting)
 *Zernio::AdCampaignsApi* | [**get_campaign_bidding**](docs/AdCampaignsApi.md#get_campaign_bidding) | **GET** /v1/ads/campaigns/{campaignId}/bidding | Read a campaign's current bidding
 *Zernio::AdCampaignsApi* | [**get_campaign_conversion_goals**](docs/AdCampaignsApi.md#get_campaign_conversion_goals) | **GET** /v1/ads/campaigns/{campaignId}/conversion-goals | Get campaign conversion goals
-*Zernio::AdCampaignsApi* | [**get_campaign_targeting**](docs/AdCampaignsApi.md#get_campaign_targeting) | **GET** /v1/ads/campaigns/{campaignId}/targeting | Read a Google campaign's device, location, and language targeting
+*Zernio::AdCampaignsApi* | [**get_campaign_targeting**](docs/AdCampaignsApi.md#get_campaign_targeting) | **GET** /v1/ads/campaigns/{campaignId}/targeting | Read a Google campaign's device, location, excluded location, and language targeting
 *Zernio::AdCampaignsApi* | [**get_google_asset_group**](docs/AdCampaignsApi.md#get_google_asset_group) | **GET** /v1/ads/campaigns/{campaignId}/asset-groups/{assetGroupId} | Get a Performance Max asset group
 *Zernio::AdCampaignsApi* | [**list_ad_campaigns**](docs/AdCampaignsApi.md#list_ad_campaigns) | **GET** /v1/ads/campaigns | List campaigns
 *Zernio::AdCampaignsApi* | [**list_ad_group_assets**](docs/AdCampaignsApi.md#list_ad_group_assets) | **GET** /v1/ads/ad-sets/{adSetId}/assets | List ad-group assets
@@ -254,7 +254,7 @@ Class | Method | HTTP request | Description
 *Zernio::AdCampaignsApi* | [**update_campaign_ad_schedule**](docs/AdCampaignsApi.md#update_campaign_ad_schedule) | **PUT** /v1/ads/campaigns/{campaignId}/ad-schedule | Replace a campaign's ad schedule (dayparting)
 *Zernio::AdCampaignsApi* | [**update_campaign_assets**](docs/AdCampaignsApi.md#update_campaign_assets) | **PUT** /v1/ads/campaigns/{campaignId}/assets | Update campaign assets
 *Zernio::AdCampaignsApi* | [**update_campaign_conversion_goals**](docs/AdCampaignsApi.md#update_campaign_conversion_goals) | **PATCH** /v1/ads/campaigns/{campaignId}/conversion-goals | Update campaign conversion goals
-*Zernio::AdCampaignsApi* | [**update_campaign_targeting**](docs/AdCampaignsApi.md#update_campaign_targeting) | **PUT** /v1/ads/campaigns/{campaignId}/targeting | Edit a Google campaign's device, location, or language targeting
+*Zernio::AdCampaignsApi* | [**update_campaign_targeting**](docs/AdCampaignsApi.md#update_campaign_targeting) | **PUT** /v1/ads/campaigns/{campaignId}/targeting | Edit a Google campaign's device, location, excluded location, or language targeting
 *Zernio::AdCampaignsApi* | [**update_google_asset_group**](docs/AdCampaignsApi.md#update_google_asset_group) | **PATCH** /v1/ads/campaigns/{campaignId}/asset-groups/{assetGroupId} | Update a Performance Max asset group
 *Zernio::AdCreativesApi* | [**create_ad_creative**](docs/AdCreativesApi.md#create_ad_creative) | **POST** /v1/ads/creatives | Create a standalone creative
 *Zernio::AdCreativesApi* | [**delete_ad_creative**](docs/AdCreativesApi.md#delete_ad_creative) | **DELETE** /v1/ads/creatives/{creativeId} | Delete a creative
@@ -1914,6 +1914,7 @@ Class | Method | HTTP request | Description
  - [Zernio::GetCampaignConversionGoals200Response](docs/GetCampaignConversionGoals200Response.md)
  - [Zernio::GetCampaignTargeting200Response](docs/GetCampaignTargeting200Response.md)
  - [Zernio::GetCampaignTargeting200ResponseDevicesInner](docs/GetCampaignTargeting200ResponseDevicesInner.md)
+ - [Zernio::GetCampaignTargeting200ResponseExcludedLocationsInner](docs/GetCampaignTargeting200ResponseExcludedLocationsInner.md)
  - [Zernio::GetCampaignTargeting200ResponseLanguagesInner](docs/GetCampaignTargeting200ResponseLanguagesInner.md)
  - [Zernio::GetCampaignTargeting200ResponseLocationsInner](docs/GetCampaignTargeting200ResponseLocationsInner.md)
  - [Zernio::GetCommentAutomation200Response](docs/GetCommentAutomation200Response.md)
@@ -3306,12 +3307,15 @@ Class | Method | HTTP request | Description
  - [Zernio::UpdateCampaignConversionGoalsRequest](docs/UpdateCampaignConversionGoalsRequest.md)
  - [Zernio::UpdateCampaignTargeting200Response](docs/UpdateCampaignTargeting200Response.md)
  - [Zernio::UpdateCampaignTargeting200ResponseDevicesInner](docs/UpdateCampaignTargeting200ResponseDevicesInner.md)
+ - [Zernio::UpdateCampaignTargeting200ResponseExcludedLocationsInner](docs/UpdateCampaignTargeting200ResponseExcludedLocationsInner.md)
  - [Zernio::UpdateCampaignTargeting200ResponseLanguagesInner](docs/UpdateCampaignTargeting200ResponseLanguagesInner.md)
  - [Zernio::UpdateCampaignTargeting200ResponseLocationsInner](docs/UpdateCampaignTargeting200ResponseLocationsInner.md)
  - [Zernio::UpdateCampaignTargetingRequest](docs/UpdateCampaignTargetingRequest.md)
  - [Zernio::UpdateCampaignTargetingRequestTargeting](docs/UpdateCampaignTargetingRequestTargeting.md)
  - [Zernio::UpdateCampaignTargetingRequestTargetingDevicesInner](docs/UpdateCampaignTargetingRequestTargetingDevicesInner.md)
  - [Zernio::UpdateCampaignTargetingRequestTargetingDevicesInnerOneOf](docs/UpdateCampaignTargetingRequestTargetingDevicesInnerOneOf.md)
+ - [Zernio::UpdateCampaignTargetingRequestTargetingExcludedLocations](docs/UpdateCampaignTargetingRequestTargetingExcludedLocations.md)
+ - [Zernio::UpdateCampaignTargetingRequestTargetingExcludedLocationsOneOf](docs/UpdateCampaignTargetingRequestTargetingExcludedLocationsOneOf.md)
  - [Zernio::UpdateCampaignTargetingRequestTargetingLocations](docs/UpdateCampaignTargetingRequestTargetingLocations.md)
  - [Zernio::UpdateCampaignTargetingRequestTargetingLocationsOneOf](docs/UpdateCampaignTargetingRequestTargetingLocationsOneOf.md)
  - [Zernio::UpdateCampaignTargetingRequestTargetingLocationsOneOfRegionsInner](docs/UpdateCampaignTargetingRequestTargetingLocationsOneOfRegionsInner.md)

data/docs/AdCampaignsApi.md

@@ -32,7 +32,7 @@ All URIs are relative to *https://zernio.com/api*
 | [**get_campaign_ad_schedule**](AdCampaignsApi.md#get_campaign_ad_schedule) | **GET** /v1/ads/campaigns/{campaignId}/ad-schedule | Read a campaign's ad schedule (dayparting) |
 | [**get_campaign_bidding**](AdCampaignsApi.md#get_campaign_bidding) | **GET** /v1/ads/campaigns/{campaignId}/bidding | Read a campaign's current bidding |
 | [**get_campaign_conversion_goals**](AdCampaignsApi.md#get_campaign_conversion_goals) | **GET** /v1/ads/campaigns/{campaignId}/conversion-goals | Get campaign conversion goals |
-| [**get_campaign_targeting**](AdCampaignsApi.md#get_campaign_targeting) | **GET** /v1/ads/campaigns/{campaignId}/targeting | Read a Google campaign's device, location, and language targeting |
+| [**get_campaign_targeting**](AdCampaignsApi.md#get_campaign_targeting) | **GET** /v1/ads/campaigns/{campaignId}/targeting | Read a Google campaign's device, location, excluded location, and language targeting |
 | [**get_google_asset_group**](AdCampaignsApi.md#get_google_asset_group) | **GET** /v1/ads/campaigns/{campaignId}/asset-groups/{assetGroupId} | Get a Performance Max asset group |
 | [**list_ad_campaigns**](AdCampaignsApi.md#list_ad_campaigns) | **GET** /v1/ads/campaigns | List campaigns |
 | [**list_ad_group_assets**](AdCampaignsApi.md#list_ad_group_assets) | **GET** /v1/ads/ad-sets/{adSetId}/assets | List ad-group assets |
@@ -64,7 +64,7 @@ All URIs are relative to *https://zernio.com/api*
 | [**update_campaign_ad_schedule**](AdCampaignsApi.md#update_campaign_ad_schedule) | **PUT** /v1/ads/campaigns/{campaignId}/ad-schedule | Replace a campaign's ad schedule (dayparting) |
 | [**update_campaign_assets**](AdCampaignsApi.md#update_campaign_assets) | **PUT** /v1/ads/campaigns/{campaignId}/assets | Update campaign assets |
 | [**update_campaign_conversion_goals**](AdCampaignsApi.md#update_campaign_conversion_goals) | **PATCH** /v1/ads/campaigns/{campaignId}/conversion-goals | Update campaign conversion goals |
-| [**update_campaign_targeting**](AdCampaignsApi.md#update_campaign_targeting) | **PUT** /v1/ads/campaigns/{campaignId}/targeting | Edit a Google campaign's device, location, or language targeting |
+| [**update_campaign_targeting**](AdCampaignsApi.md#update_campaign_targeting) | **PUT** /v1/ads/campaigns/{campaignId}/targeting | Edit a Google campaign's device, location, excluded location, or language targeting |
 | [**update_google_asset_group**](AdCampaignsApi.md#update_google_asset_group) | **PATCH** /v1/ads/campaigns/{campaignId}/asset-groups/{assetGroupId} | Update a Performance Max asset group |
 
 
@@ -2136,9 +2136,9 @@ end
 
 > <GetCampaignTargeting200Response> get_campaign_targeting(campaign_id, opts)
 
-Read a Google campaign's device, location, and language targeting
+Read a Google campaign's device, location, excluded location, and language targeting
 
-Google Ads compliance requires geo, language, budget, and bidding targeting set at creation to stay editable afterwards; this reads the campaign state so an integrator can build an editor around it. Cached for the quota window (10 minutes fresh, up to 7 days last-good), not always a live read. Google only; every other platform returns 501.  `devices` lists the device criteria the campaign carries, which depends on its channel: Search campaigns have MOBILE, DESKTOP and TABLET, Display campaigns also have CONNECTED_TV. `bidModifier` is Google's bid adjustment for that device, `null` when it has none, and `0` when the device is switched off; `included` is false for exactly that case. 
+Google Ads compliance requires geo, language, budget, and bidding targeting set at creation to stay editable afterwards; this reads the campaign state so an integrator can build an editor around it. Cached for the quota window (10 minutes fresh, up to 7 days last-good), not always a live read. Google only; every other platform returns 501.  `devices` lists the device criteria the campaign carries, which depends on its channel: Search campaigns have MOBILE, DESKTOP and TABLET, Display campaigns also have CONNECTED_TV. `bidModifier` is Google's bid adjustment for that device, `null` when it has none, and `0` when the device is switched off; `included` is false for exactly that case.  `excludedLocations` lists the campaign's negative location criteria (the places it never serves in). `locations` still lists every location criterion, each flagged with `negative`, so a client reading the targeted set filters `negative: false`. 
 
 ### Examples
 
@@ -2158,7 +2158,7 @@ opts = {
 }
 
 begin
-  # Read a Google campaign's device, location, and language targeting
+  # Read a Google campaign's device, location, excluded location, and language targeting
   result = api_instance.get_campaign_targeting(campaign_id, opts)
   p result
 rescue Zernio::ApiError => e
@@ -2174,7 +2174,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Read a Google campaign's device, location, and language targeting
+  # Read a Google campaign's device, location, excluded location, and language targeting
   data, status_code, headers = api_instance.get_campaign_targeting_with_http_info(campaign_id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -4554,9 +4554,9 @@ end
 
 > <UpdateCampaignTargeting200Response> update_campaign_targeting(campaign_id, update_campaign_targeting_request)
 
-Edit a Google campaign's device, location, or language targeting
+Edit a Google campaign's device, location, excluded location, or language targeting
 
-Google Ads compliance row M.10: geo and language targeting set at creation must stay editable afterwards. Send at least one of `devices`, `locations`, `languages`, `locationTargetingType`; each provided field REPLACES that field's existing criteria on the campaign (a full set, not a delta). Fields left out of the body are untouched. Google only; every other platform returns 501.  `devices` is the full set of device bid modifiers: a supported device you leave out is switched off with a bid modifier of 0, since Google cannot remove a device criterion. A device the campaign's channel does not carry, and a set that switches every device off, both return 422.  `locations` accepts the same shapes as campaign creation: a bare array of ISO country codes, or an object with `countries`/`regions`/`cities`/`zips`/`metros` key lists (`key` from GET /v1/ads/targeting/search?dimension=geo). Negative (excluded) locations are left untouched by this endpoint. An empty location list returns 400 instead of removing every criterion: a Google campaign with no location criteria targets every country, so omit `locations` to leave targeting alone.  The removes and the creates go out in ONE Google `googleAds:mutate`, so a failed edit leaves the campaign's previous set intact rather than a half-applied one.  `languages` is an array of Google's language codes (ISO 639-1, plus variants such as `zh_CN`); an unknown code returns 400.  `locationTargetingType` switches who the location targeting reaches: `presence` (people in or regularly in the locations) or `presence_or_interest` (also people searching for or interested in them). Example: `{ \"platform\": \"google\", \"targeting\": { \"locationTargetingType\": \"presence\" } }`.  The response includes the refreshed `devices`/`locations`/`languages` state read back from Google after the edit, and invalidates the cached copy `GET` on this campaign would otherwise keep serving.  **Demand Gen:** Google keeps a Demand Gen campaign's locations and languages on its ad groups and refuses them on the campaign. When the campaign has one ad group they are written there and the response carries its `adGroupId` (the campaign-level `locations`/`languages` read back then stay empty). With several ad groups the call returns 400 naming them: edit each one with PUT /v1/ads/{adId} `targeting` on an ad of that ad group. Campaigns migrated from Discovery that still target on the campaign keep being written there. `devices` and `locationTargetingType` stay campaign-level. 
+Google Ads compliance row M.10: geo and language targeting set at creation must stay editable afterwards. Send at least one of `devices`, `locations`, `excludedLocations`, `languages`, `locationTargetingType`; each provided field REPLACES that field's existing criteria on the campaign (a full set, not a delta). Fields left out of the body are untouched. Google only; every other platform returns 501.  `devices` is the full set of device bid modifiers: a supported device you leave out is switched off with a bid modifier of 0, since Google cannot remove a device criterion. A device the campaign's channel does not carry, and a set that switches every device off, both return 422.  `locations` accepts the same shapes as campaign creation: a bare array of ISO country codes, or an object with `countries`/`regions`/`cities`/`zips`/`metros` key lists (`key` from GET /v1/ads/targeting/search?dimension=geo). Excluded locations are left untouched by `locations`. An empty location list returns 400 instead of removing every criterion: a Google campaign with no location criteria targets every country, so omit `locations` to leave targeting alone.  `excludedLocations` takes the same two shapes and replaces the campaign's negative location criteria (the places it never serves in), leaving the targeted `locations` untouched. An empty list (or `{}`) removes every exclusion. Radius exclusions are not supported. A place cannot be both targeted and excluded: a request whose result would leave one on both sides returns 400 before anything is written, and moving a place from one side to the other in the same request is applied atomically. Example: `{ \"platform\": \"google\", \"targeting\": { \"excludedLocations\": { \"countries\": [\"CA\"], \"regions\": [\"21137\"] } } }`.  The removes and the creates go out in ONE Google `googleAds:mutate`, so a failed edit leaves the campaign's previous set intact rather than a half-applied one.  `languages` is an array of Google's language codes (ISO 639-1, plus variants such as `zh_CN`); an unknown code returns 400.  `locationTargetingType` switches who the location targeting reaches: `presence` (people in or regularly in the locations) or `presence_or_interest` (also people searching for or interested in them). Example: `{ \"platform\": \"google\", \"targeting\": { \"locationTargetingType\": \"presence\" } }`.  The response includes the refreshed `devices`/`locations`/`excludedLocations`/`languages` state read back from Google after the edit, and invalidates the cached copy `GET` on this campaign would otherwise keep serving.  **Demand Gen:** Google keeps a Demand Gen campaign's locations and languages on its ad groups and refuses them on the campaign. When the campaign has one ad group they are written there and the response carries its `adGroupId` (the campaign-level `locations`/`languages` read back then stay empty). With several ad groups the call returns 400 naming them: edit each one with PUT /v1/ads/{adId} `targeting` on an ad of that ad group. Campaigns migrated from Discovery that still target on the campaign keep being written there. `devices` and `locationTargetingType` stay campaign-level. `excludedLocations` is not available on Demand Gen yet and returns 400. 
 
 ### Examples
 
@@ -4574,7 +4574,7 @@ campaign_id = 'campaign_id_example' # String | Google platform campaign ID
 update_campaign_targeting_request = Zernio::UpdateCampaignTargetingRequest.new({platform: 'google', targeting: Zernio::UpdateCampaignTargetingRequestTargeting.new}) # UpdateCampaignTargetingRequest | 
 
 begin
-  # Edit a Google campaign's device, location, or language targeting
+  # Edit a Google campaign's device, location, excluded location, or language targeting
   result = api_instance.update_campaign_targeting(campaign_id, update_campaign_targeting_request)
   p result
 rescue Zernio::ApiError => e
@@ -4590,7 +4590,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Edit a Google campaign's device, location, or language targeting
+  # Edit a Google campaign's device, location, excluded location, or language targeting
   data, status_code, headers = api_instance.update_campaign_targeting_with_http_info(campaign_id, update_campaign_targeting_request)
   p status_code # => 2xx
   p headers # => { ... }

data/docs/GetCampaignTargeting200Response.md

@@ -6,6 +6,8 @@
 | ---- | ---- | ----------- | ----- |
 | **devices** | [**Array<GetCampaignTargeting200ResponseDevicesInner>**](GetCampaignTargeting200ResponseDevicesInner.md) |  | [optional] |
 | **locations** | [**Array<GetCampaignTargeting200ResponseLocationsInner>**](GetCampaignTargeting200ResponseLocationsInner.md) |  | [optional] |
+| **excluded_locations** | [**Array<GetCampaignTargeting200ResponseExcludedLocationsInner>**](GetCampaignTargeting200ResponseExcludedLocationsInner.md) | The negative (excluded) location criteria, same item shape as `locations` with `negative: true`. | [optional] |
+| **excluded_locations_editable** | **Boolean** | Whether PUT accepts `excludedLocations` for this campaign. False on Demand Gen, which returns 400 for any exclusion. | [optional] |
 | **languages** | [**Array<GetCampaignTargeting200ResponseLanguagesInner>**](GetCampaignTargeting200ResponseLanguagesInner.md) |  | [optional] |
 | **location_targeting_type** | **String** | Who the location targeting reaches, see GoogleLocationTargetingType. Null when Google reports a legacy value (SEARCH_INTEREST) this API does not set. | [optional] |
 | **cached_at** | **Time** | When this targeting was fetched from Google. Null when it was never served from cache. | [optional] |
@@ -19,6 +21,8 @@ require 'zernio-sdk'
 instance = Zernio::GetCampaignTargeting200Response.new(
   devices: null,
   locations: null,
+  excluded_locations: null,
+  excluded_locations_editable: null,
   languages: null,
   location_targeting_type: null,
   cached_at: null,

data/docs/GetCampaignTargeting200ResponseExcludedLocationsInner.md

@@ -0,0 +1,28 @@
+# Zernio::GetCampaignTargeting200ResponseExcludedLocationsInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **geo_target_id** | **String** | Numeric id from Google's geoTargetConstants/{id}. | [optional] |
+| **negative** | **Boolean** | Always true here. | [optional] |
+| **name** | **String** |  | [optional] |
+| **canonical_name** | **String** |  | [optional] |
+| **type** | **String** |  | [optional] |
+| **country_code** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::GetCampaignTargeting200ResponseExcludedLocationsInner.new(
+  geo_target_id: null,
+  negative: null,
+  name: null,
+  canonical_name: null,
+  type: null,
+  country_code: null
+)
+```
+

data/docs/UpdateCampaignTargeting200Response.md

@@ -10,6 +10,7 @@
 | **location_targeting_type** | **String** | The value read back from Google after the edit. | [optional] |
 | **devices** | [**Array<UpdateCampaignTargeting200ResponseDevicesInner>**](UpdateCampaignTargeting200ResponseDevicesInner.md) |  | [optional] |
 | **locations** | [**Array<UpdateCampaignTargeting200ResponseLocationsInner>**](UpdateCampaignTargeting200ResponseLocationsInner.md) |  | [optional] |
+| **excluded_locations** | [**Array<UpdateCampaignTargeting200ResponseExcludedLocationsInner>**](UpdateCampaignTargeting200ResponseExcludedLocationsInner.md) | The negative (excluded) location criteria read back after the edit, same item shape as `locations`. | [optional] |
 | **languages** | [**Array<UpdateCampaignTargeting200ResponseLanguagesInner>**](UpdateCampaignTargeting200ResponseLanguagesInner.md) |  | [optional] |
 
 ## Example
@@ -24,6 +25,7 @@ instance = Zernio::UpdateCampaignTargeting200Response.new(
   location_targeting_type: null,
   devices: null,
   locations: null,
+  excluded_locations: null,
   languages: null
 )
 ```

data/docs/UpdateCampaignTargeting200ResponseExcludedLocationsInner.md

@@ -0,0 +1,28 @@
+# Zernio::UpdateCampaignTargeting200ResponseExcludedLocationsInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **geo_target_id** | **String** |  | [optional] |
+| **negative** | **Boolean** |  | [optional] |
+| **name** | **String** |  | [optional] |
+| **canonical_name** | **String** |  | [optional] |
+| **type** | **String** |  | [optional] |
+| **country_code** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::UpdateCampaignTargeting200ResponseExcludedLocationsInner.new(
+  geo_target_id: null,
+  negative: null,
+  name: null,
+  canonical_name: null,
+  type: null,
+  country_code: null
+)
+```
+

data/docs/UpdateCampaignTargetingRequestTargeting.md

@@ -7,6 +7,7 @@
 | **devices** | [**Array<UpdateCampaignTargetingRequestTargetingDevicesInner>**](UpdateCampaignTargetingRequestTargetingDevicesInner.md) | Devices to include. Devices not listed become excluded (negative) criteria, same contract as the existing devices-only edit. | [optional] |
 | **locations** | [**UpdateCampaignTargetingRequestTargetingLocations**](UpdateCampaignTargetingRequestTargetingLocations.md) |  | [optional] |
 | **languages** | **Array<String>** | Google's language codes (ISO 639-1, plus variants such as `zh_CN`), e.g. [\"en\", \"de\"]. | [optional] |
+| **excluded_locations** | [**UpdateCampaignTargetingRequestTargetingExcludedLocations**](UpdateCampaignTargetingRequestTargetingExcludedLocations.md) |  | [optional] |
 | **location_targeting_type** | [**GoogleLocationTargetingType**](GoogleLocationTargetingType.md) |  | [optional] |
 
 ## Example
@@ -18,6 +19,7 @@ instance = Zernio::UpdateCampaignTargetingRequestTargeting.new(
   devices: null,
   locations: null,
   languages: null,
+  excluded_locations: null,
   location_targeting_type: null
 )
 ```

data/docs/UpdateCampaignTargetingRequestTargetingExcludedLocations.md

@@ -0,0 +1,49 @@
+# Zernio::UpdateCampaignTargetingRequestTargetingExcludedLocations
+
+## Class instance methods
+
+### `openapi_one_of`
+
+Returns the list of classes defined in oneOf.
+
+#### Example
+
+```ruby
+require 'zernio-sdk'
+
+Zernio::UpdateCampaignTargetingRequestTargetingExcludedLocations.openapi_one_of
+# =>
+# [
+#   :'Array<String>',
+#   :'UpdateCampaignTargetingRequestTargetingExcludedLocationsOneOf'
+# ]
+```
+
+### build
+
+Find the appropriate object from the `openapi_one_of` list and casts the data into it.
+
+#### Example
+
+```ruby
+require 'zernio-sdk'
+
+Zernio::UpdateCampaignTargetingRequestTargetingExcludedLocations.build(data)
+# => #<Array<String>:0x00007fdd4aab02a0>
+
+Zernio::UpdateCampaignTargetingRequestTargetingExcludedLocations.build(data_that_doesnt_match)
+# => nil
+```
+
+#### Parameters
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| **data** | **Mixed** | data to be matched against the list of oneOf items |
+
+#### Return type
+
+- `Array<String>`
+- `UpdateCampaignTargetingRequestTargetingExcludedLocationsOneOf`
+- `nil` (if no type matches)
+

data/docs/UpdateCampaignTargetingRequestTargetingExcludedLocationsOneOf.md

@@ -0,0 +1,26 @@
+# Zernio::UpdateCampaignTargetingRequestTargetingExcludedLocationsOneOf
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **countries** | **Array<String>** |  | [optional] |
+| **regions** | [**Array<UpdateCampaignTargetingRequestTargetingLocationsOneOfRegionsInner>**](UpdateCampaignTargetingRequestTargetingLocationsOneOfRegionsInner.md) |  | [optional] |
+| **cities** | [**Array<UpdateCampaignTargetingRequestTargetingLocationsOneOfRegionsInner>**](UpdateCampaignTargetingRequestTargetingLocationsOneOfRegionsInner.md) |  | [optional] |
+| **zips** | [**Array<UpdateCampaignTargetingRequestTargetingLocationsOneOfRegionsInner>**](UpdateCampaignTargetingRequestTargetingLocationsOneOfRegionsInner.md) |  | [optional] |
+| **metros** | [**Array<UpdateCampaignTargetingRequestTargetingLocationsOneOfRegionsInner>**](UpdateCampaignTargetingRequestTargetingLocationsOneOfRegionsInner.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::UpdateCampaignTargetingRequestTargetingExcludedLocationsOneOf.new(
+  countries: null,
+  regions: null,
+  cities: null,
+  zips: null,
+  metros: null
+)
+```
+

data/lib/zernio-sdk/api/ad_campaigns_api.rb

@@ -2180,8 +2180,8 @@ module Zernio
       return data, status_code, headers
     end
 
-    # Read a Google campaign's device, location, and language targeting
-    # Google Ads compliance requires geo, language, budget, and bidding targeting set at creation to stay editable afterwards; this reads the campaign state so an integrator can build an editor around it. Cached for the quota window (10 minutes fresh, up to 7 days last-good), not always a live read. Google only; every other platform returns 501.  `devices` lists the device criteria the campaign carries, which depends on its channel: Search campaigns have MOBILE, DESKTOP and TABLET, Display campaigns also have CONNECTED_TV. `bidModifier` is Google's bid adjustment for that device, `null` when it has none, and `0` when the device is switched off; `included` is false for exactly that case. 
+    # Read a Google campaign's device, location, excluded location, and language targeting
+    # Google Ads compliance requires geo, language, budget, and bidding targeting set at creation to stay editable afterwards; this reads the campaign state so an integrator can build an editor around it. Cached for the quota window (10 minutes fresh, up to 7 days last-good), not always a live read. Google only; every other platform returns 501.  `devices` lists the device criteria the campaign carries, which depends on its channel: Search campaigns have MOBILE, DESKTOP and TABLET, Display campaigns also have CONNECTED_TV. `bidModifier` is Google's bid adjustment for that device, `null` when it has none, and `0` when the device is switched off; `included` is false for exactly that case.  `excludedLocations` lists the campaign's negative location criteria (the places it never serves in). `locations` still lists every location criterion, each flagged with `negative`, so a client reading the targeted set filters `negative: false`. 
     # @param campaign_id [String] Google platform campaign ID
     # @param [Hash] opts the optional parameters
     # @option opts [String] :platform Disambiguates when the same campaignId string exists on more than one connected platform.
@@ -2191,8 +2191,8 @@ module Zernio
       data
     end
 
-    # Read a Google campaign's device, location, and language targeting
-    # Google Ads compliance requires geo, language, budget, and bidding targeting set at creation to stay editable afterwards; this reads the campaign state so an integrator can build an editor around it. Cached for the quota window (10 minutes fresh, up to 7 days last-good), not always a live read. Google only; every other platform returns 501.  `devices` lists the device criteria the campaign carries, which depends on its channel: Search campaigns have MOBILE, DESKTOP and TABLET, Display campaigns also have CONNECTED_TV. `bidModifier` is Google's bid adjustment for that device, `null` when it has none, and `0` when the device is switched off; `included` is false for exactly that case. 
+    # Read a Google campaign's device, location, excluded location, and language targeting
+    # Google Ads compliance requires geo, language, budget, and bidding targeting set at creation to stay editable afterwards; this reads the campaign state so an integrator can build an editor around it. Cached for the quota window (10 minutes fresh, up to 7 days last-good), not always a live read. Google only; every other platform returns 501.  `devices` lists the device criteria the campaign carries, which depends on its channel: Search campaigns have MOBILE, DESKTOP and TABLET, Display campaigns also have CONNECTED_TV. `bidModifier` is Google's bid adjustment for that device, `null` when it has none, and `0` when the device is switched off; `included` is false for exactly that case.  `excludedLocations` lists the campaign's negative location criteria (the places it never serves in). `locations` still lists every location criterion, each flagged with `negative`, so a client reading the targeted set filters `negative: false`. 
     # @param campaign_id [String] Google platform campaign ID
     # @param [Hash] opts the optional parameters
     # @option opts [String] :platform Disambiguates when the same campaignId string exists on more than one connected platform.
@@ -4865,8 +4865,8 @@ module Zernio
       return data, status_code, headers
     end
 
-    # Edit a Google campaign's device, location, or language targeting
-    # Google Ads compliance row M.10: geo and language targeting set at creation must stay editable afterwards. Send at least one of `devices`, `locations`, `languages`, `locationTargetingType`; each provided field REPLACES that field's existing criteria on the campaign (a full set, not a delta). Fields left out of the body are untouched. Google only; every other platform returns 501.  `devices` is the full set of device bid modifiers: a supported device you leave out is switched off with a bid modifier of 0, since Google cannot remove a device criterion. A device the campaign's channel does not carry, and a set that switches every device off, both return 422.  `locations` accepts the same shapes as campaign creation: a bare array of ISO country codes, or an object with `countries`/`regions`/`cities`/`zips`/`metros` key lists (`key` from GET /v1/ads/targeting/search?dimension=geo). Negative (excluded) locations are left untouched by this endpoint. An empty location list returns 400 instead of removing every criterion: a Google campaign with no location criteria targets every country, so omit `locations` to leave targeting alone.  The removes and the creates go out in ONE Google `googleAds:mutate`, so a failed edit leaves the campaign's previous set intact rather than a half-applied one.  `languages` is an array of Google's language codes (ISO 639-1, plus variants such as `zh_CN`); an unknown code returns 400.  `locationTargetingType` switches who the location targeting reaches: `presence` (people in or regularly in the locations) or `presence_or_interest` (also people searching for or interested in them). Example: `{ \"platform\": \"google\", \"targeting\": { \"locationTargetingType\": \"presence\" } }`.  The response includes the refreshed `devices`/`locations`/`languages` state read back from Google after the edit, and invalidates the cached copy `GET` on this campaign would otherwise keep serving.  **Demand Gen:** Google keeps a Demand Gen campaign's locations and languages on its ad groups and refuses them on the campaign. When the campaign has one ad group they are written there and the response carries its `adGroupId` (the campaign-level `locations`/`languages` read back then stay empty). With several ad groups the call returns 400 naming them: edit each one with PUT /v1/ads/{adId} `targeting` on an ad of that ad group. Campaigns migrated from Discovery that still target on the campaign keep being written there. `devices` and `locationTargetingType` stay campaign-level. 
+    # Edit a Google campaign's device, location, excluded location, or language targeting
+    # Google Ads compliance row M.10: geo and language targeting set at creation must stay editable afterwards. Send at least one of `devices`, `locations`, `excludedLocations`, `languages`, `locationTargetingType`; each provided field REPLACES that field's existing criteria on the campaign (a full set, not a delta). Fields left out of the body are untouched. Google only; every other platform returns 501.  `devices` is the full set of device bid modifiers: a supported device you leave out is switched off with a bid modifier of 0, since Google cannot remove a device criterion. A device the campaign's channel does not carry, and a set that switches every device off, both return 422.  `locations` accepts the same shapes as campaign creation: a bare array of ISO country codes, or an object with `countries`/`regions`/`cities`/`zips`/`metros` key lists (`key` from GET /v1/ads/targeting/search?dimension=geo). Excluded locations are left untouched by `locations`. An empty location list returns 400 instead of removing every criterion: a Google campaign with no location criteria targets every country, so omit `locations` to leave targeting alone.  `excludedLocations` takes the same two shapes and replaces the campaign's negative location criteria (the places it never serves in), leaving the targeted `locations` untouched. An empty list (or `{}`) removes every exclusion. Radius exclusions are not supported. A place cannot be both targeted and excluded: a request whose result would leave one on both sides returns 400 before anything is written, and moving a place from one side to the other in the same request is applied atomically. Example: `{ \"platform\": \"google\", \"targeting\": { \"excludedLocations\": { \"countries\": [\"CA\"], \"regions\": [\"21137\"] } } }`.  The removes and the creates go out in ONE Google `googleAds:mutate`, so a failed edit leaves the campaign's previous set intact rather than a half-applied one.  `languages` is an array of Google's language codes (ISO 639-1, plus variants such as `zh_CN`); an unknown code returns 400.  `locationTargetingType` switches who the location targeting reaches: `presence` (people in or regularly in the locations) or `presence_or_interest` (also people searching for or interested in them). Example: `{ \"platform\": \"google\", \"targeting\": { \"locationTargetingType\": \"presence\" } }`.  The response includes the refreshed `devices`/`locations`/`excludedLocations`/`languages` state read back from Google after the edit, and invalidates the cached copy `GET` on this campaign would otherwise keep serving.  **Demand Gen:** Google keeps a Demand Gen campaign's locations and languages on its ad groups and refuses them on the campaign. When the campaign has one ad group they are written there and the response carries its `adGroupId` (the campaign-level `locations`/`languages` read back then stay empty). With several ad groups the call returns 400 naming them: edit each one with PUT /v1/ads/{adId} `targeting` on an ad of that ad group. Campaigns migrated from Discovery that still target on the campaign keep being written there. `devices` and `locationTargetingType` stay campaign-level. `excludedLocations` is not available on Demand Gen yet and returns 400. 
     # @param campaign_id [String] Google platform campaign ID
     # @param update_campaign_targeting_request [UpdateCampaignTargetingRequest] 
     # @param [Hash] opts the optional parameters
@@ -4876,8 +4876,8 @@ module Zernio
       data
     end
 
-    # Edit a Google campaign's device, location, or language targeting
-    # Google Ads compliance row M.10: geo and language targeting set at creation must stay editable afterwards. Send at least one of `devices`, `locations`, `languages`, `locationTargetingType`; each provided field REPLACES that field's existing criteria on the campaign (a full set, not a delta). Fields left out of the body are untouched. Google only; every other platform returns 501.  `devices` is the full set of device bid modifiers: a supported device you leave out is switched off with a bid modifier of 0, since Google cannot remove a device criterion. A device the campaign's channel does not carry, and a set that switches every device off, both return 422.  `locations` accepts the same shapes as campaign creation: a bare array of ISO country codes, or an object with `countries`/`regions`/`cities`/`zips`/`metros` key lists (`key` from GET /v1/ads/targeting/search?dimension=geo). Negative (excluded) locations are left untouched by this endpoint. An empty location list returns 400 instead of removing every criterion: a Google campaign with no location criteria targets every country, so omit `locations` to leave targeting alone.  The removes and the creates go out in ONE Google `googleAds:mutate`, so a failed edit leaves the campaign's previous set intact rather than a half-applied one.  `languages` is an array of Google's language codes (ISO 639-1, plus variants such as `zh_CN`); an unknown code returns 400.  `locationTargetingType` switches who the location targeting reaches: `presence` (people in or regularly in the locations) or `presence_or_interest` (also people searching for or interested in them). Example: `{ \"platform\": \"google\", \"targeting\": { \"locationTargetingType\": \"presence\" } }`.  The response includes the refreshed `devices`/`locations`/`languages` state read back from Google after the edit, and invalidates the cached copy `GET` on this campaign would otherwise keep serving.  **Demand Gen:** Google keeps a Demand Gen campaign's locations and languages on its ad groups and refuses them on the campaign. When the campaign has one ad group they are written there and the response carries its `adGroupId` (the campaign-level `locations`/`languages` read back then stay empty). With several ad groups the call returns 400 naming them: edit each one with PUT /v1/ads/{adId} `targeting` on an ad of that ad group. Campaigns migrated from Discovery that still target on the campaign keep being written there. `devices` and `locationTargetingType` stay campaign-level. 
+    # Edit a Google campaign's device, location, excluded location, or language targeting
+    # Google Ads compliance row M.10: geo and language targeting set at creation must stay editable afterwards. Send at least one of `devices`, `locations`, `excludedLocations`, `languages`, `locationTargetingType`; each provided field REPLACES that field's existing criteria on the campaign (a full set, not a delta). Fields left out of the body are untouched. Google only; every other platform returns 501.  `devices` is the full set of device bid modifiers: a supported device you leave out is switched off with a bid modifier of 0, since Google cannot remove a device criterion. A device the campaign's channel does not carry, and a set that switches every device off, both return 422.  `locations` accepts the same shapes as campaign creation: a bare array of ISO country codes, or an object with `countries`/`regions`/`cities`/`zips`/`metros` key lists (`key` from GET /v1/ads/targeting/search?dimension=geo). Excluded locations are left untouched by `locations`. An empty location list returns 400 instead of removing every criterion: a Google campaign with no location criteria targets every country, so omit `locations` to leave targeting alone.  `excludedLocations` takes the same two shapes and replaces the campaign's negative location criteria (the places it never serves in), leaving the targeted `locations` untouched. An empty list (or `{}`) removes every exclusion. Radius exclusions are not supported. A place cannot be both targeted and excluded: a request whose result would leave one on both sides returns 400 before anything is written, and moving a place from one side to the other in the same request is applied atomically. Example: `{ \"platform\": \"google\", \"targeting\": { \"excludedLocations\": { \"countries\": [\"CA\"], \"regions\": [\"21137\"] } } }`.  The removes and the creates go out in ONE Google `googleAds:mutate`, so a failed edit leaves the campaign's previous set intact rather than a half-applied one.  `languages` is an array of Google's language codes (ISO 639-1, plus variants such as `zh_CN`); an unknown code returns 400.  `locationTargetingType` switches who the location targeting reaches: `presence` (people in or regularly in the locations) or `presence_or_interest` (also people searching for or interested in them). Example: `{ \"platform\": \"google\", \"targeting\": { \"locationTargetingType\": \"presence\" } }`.  The response includes the refreshed `devices`/`locations`/`excludedLocations`/`languages` state read back from Google after the edit, and invalidates the cached copy `GET` on this campaign would otherwise keep serving.  **Demand Gen:** Google keeps a Demand Gen campaign's locations and languages on its ad groups and refuses them on the campaign. When the campaign has one ad group they are written there and the response carries its `adGroupId` (the campaign-level `locations`/`languages` read back then stay empty). With several ad groups the call returns 400 naming them: edit each one with PUT /v1/ads/{adId} `targeting` on an ad of that ad group. Campaigns migrated from Discovery that still target on the campaign keep being written there. `devices` and `locationTargetingType` stay campaign-level. `excludedLocations` is not available on Demand Gen yet and returns 400. 
     # @param campaign_id [String] Google platform campaign ID
     # @param update_campaign_targeting_request [UpdateCampaignTargetingRequest] 
     # @param [Hash] opts the optional parameters

data/lib/zernio-sdk/models/get_campaign_targeting200_response.rb

@@ -19,6 +19,12 @@ module Zernio
 
     attr_accessor :locations
 
+    # The negative (excluded) location criteria, same item shape as `locations` with `negative: true`.
+    attr_accessor :excluded_locations
+
+    # Whether PUT accepts `excludedLocations` for this campaign. False on Demand Gen, which returns 400 for any exclusion.
+    attr_accessor :excluded_locations_editable
+
     attr_accessor :languages
 
     # Who the location targeting reaches, see GoogleLocationTargetingType. Null when Google reports a legacy value (SEARCH_INTEREST) this API does not set.
@@ -57,6 +63,8 @@ module Zernio
       {
         :'devices' => :'devices',
         :'locations' => :'locations',
+        :'excluded_locations' => :'excludedLocations',
+        :'excluded_locations_editable' => :'excludedLocationsEditable',
         :'languages' => :'languages',
         :'location_targeting_type' => :'locationTargetingType',
         :'cached_at' => :'cachedAt',
@@ -79,6 +87,8 @@ module Zernio
       {
         :'devices' => :'Array<GetCampaignTargeting200ResponseDevicesInner>',
         :'locations' => :'Array<GetCampaignTargeting200ResponseLocationsInner>',
+        :'excluded_locations' => :'Array<GetCampaignTargeting200ResponseExcludedLocationsInner>',
+        :'excluded_locations_editable' => :'Boolean',
         :'languages' => :'Array<GetCampaignTargeting200ResponseLanguagesInner>',
         :'location_targeting_type' => :'String',
         :'cached_at' => :'Time',
@@ -122,6 +132,16 @@ module Zernio
         end
       end
 
+      if attributes.key?(:'excluded_locations')
+        if (value = attributes[:'excluded_locations']).is_a?(Array)
+          self.excluded_locations = value
+        end
+      end
+
+      if attributes.key?(:'excluded_locations_editable')
+        self.excluded_locations_editable = attributes[:'excluded_locations_editable']
+      end
+
       if attributes.key?(:'languages')
         if (value = attributes[:'languages']).is_a?(Array)
           self.languages = value
@@ -175,6 +195,8 @@ module Zernio
       self.class == o.class &&
           devices == o.devices &&
           locations == o.locations &&
+          excluded_locations == o.excluded_locations &&
+          excluded_locations_editable == o.excluded_locations_editable &&
           languages == o.languages &&
           location_targeting_type == o.location_targeting_type &&
           cached_at == o.cached_at &&
@@ -190,7 +212,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [devices, locations, languages, location_targeting_type, cached_at, stale].hash
+      [devices, locations, excluded_locations, excluded_locations_editable, languages, location_targeting_type, cached_at, stale].hash
     end
 
     # Builds the object from hash