changedInput schema / properties / body / properties / adGroups / example
Previous value: -[
- {
- "adContent": [],
- "id": "ag_1",
- "name": "Ad Group 1"
- }
-]New value: +[
+ {
+ "adContent": [
+ {
+ "descriptions": [
+ "Great products"
+ ],
+ "headlines": [
+ "Buy Now"
+ ],
+ "name": "Ad 1"
+ }
+ ],
+ "id": "ag_1",
+ "name": "Ad Group 1"
+ }
+]
addedInput schema / properties / body / properties / adGroups / items / properties / adContent / items / properties / carouselCards / items / properties / media / items / title
Added value: +"GoogleMediaDTO"
addedInput schema / properties / body / properties / adGroups / items / properties / adContent / items / properties / carouselCards / items / title
Added value: +"GoogleCarouselCardDTO"
addedInput schema / properties / body / properties / adGroups / items / properties / adContent / items / properties / media / items / title
Added value: +"GoogleMediaDTO"
changedInput schema / properties / body / properties / adGroups / items / properties / adContent / items / properties / placements / example
Previous value: -[
- "YOUTUBE"
-]New value: +[
+ "YOUTUBE_IN_STREAM"
+]
addedInput schema / properties / body / properties / adGroups / items / properties / adContent / items / properties / youtubeVideoLinks / items / title
Added value: +"GoogleYouTubeVideoLinkDTO"
addedInput schema / properties / body / properties / adGroups / items / properties / adContent / items / title
Added value: +"GoogleAdContentDTO"
changedInput schema / properties / body / properties / adGroups / items / properties / audience / allOf
Previous value: -[
- {
- "properties": {
- "geoLocations": {
- "description": "Geo-location targeting",
- "example": [
- {
- "key": "geoTargetConstants/2840",
- "name": "United States",
- "type": "country"
- }
- ],
- "items": {
- "properties": {
- "addressComponents": {
- "description": "Address components from Google Geocoding API",
- "example": [
- {
- "longName": "New York",
- "shortName": "NY",
- "types": [
- "locality",
- "political"
- ]
- }
- ],
- "items": {
- "properties": {
- "longName": {
- "description": "Full name of the address component",
- "example": "New York",
- "type": "string"
- },
- "shortName": {
- "description": "Abbreviated name of the address component",
- "example": "NY",
- "type": "string"
- },
- "types": {
- "description": "Address component types",
- "example": [
- "locality",
- "political"
- ],
- "items": {
- "type": "string"
- },
- "type": "array"
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "countryName": {
- "description": "Country name",
- "example": "United States",
- "type": "string"
- },
- "formattedAddress": {
- "description": "Full formatted address string",
- "example": "New York, NY, USA",
- "type": "string"
- },
- "geometry": {
- "allOf": [
- {
- "properties": {
- "location": {
- "allOf": [
- {
- "properties": {
- "lat": {
- "description": "Latitude",
- "example": 40.7128,
- "type": "number"
- },
- "lng": {
- "description": "Longitude",
- "example": -74.006,
- "type": "number"
- }
- },
- "type": "object"
- }
- ],
- "description": "Location coordinates",
- "example": {
- "lat": 40.7128,
- "lng": -74.006
- }
- },
- "locationType": {
- "description": "Location type (e.g. APPROXIMATE)",
- "example": "APPROXIMATE",
- "type": "string"
- },
- "viewport": {
- "allOf": [
- {
- "properties": {
- "northeast": {
- "allOf": [
- {
- "properties": {
- "lat": {
- "description": "Latitude",
- "example": 40.7128,
- "type": "number"
- },
- "lng": {
- "description": "Longitude",
- "example": -74.006,
- "type": "number"
- }
- },
- "type": "object"
- }
- ],
- "description": "Northeast corner of the viewport",
- "example": {
- "lat": 40.8,
- "lng": -73.9
- }
- },
- "southwest": {
- "allOf": [
- {
- "properties": {
- "lat": {
- "description": "Latitude",
- "example": 40.7128,
- "type": "number"
- },
- "lng": {
- "description": "Longitude",
- "example": -74.006,
- "type": "number"
- }
- },
- "type": "object"
- }
- ],
- "description": "Southwest corner of the viewport",
- "example": {
- "lat": 40.6,
- "lng": -74.1
- }
- }
- },
- "type": "object"
- }
- ],
- "description": "Viewport bounding box",
- "example": {
- "northeast": {
- "lat": 40.8,
- "lng": -73.9
- },
- "southwest": {
- "lat": 40.6,
- "lng": -74.1
- }
- }
- }
- },
- "type": "object"
- }
- ],
- "description": "Geometry data from Google Geocoding API",
- "example": {
- "location": {
- "lat": 40.7128,
- "lng": -74.006
- },
- "locationType": "APPROXIMATE"
- }
- },
- "id": {
- "description": "Location identifier (place_id)",
- "example": "ChIJOwg_06VPwokRYv534QaPC8g",
- "type": "string"
- },
- "key": {
- "description": "Geo target constant resource name",
- "example": "geoTargetConstants/2840",
- "type": "string"
- },
- "name": {
- "description": "Location display name",
- "example": "New York",
- "type": "string"
- },
- "placeId": {
- "description": "Google place ID",
- "example": "ChIJOwg_06VPwokRYv534QaPC8g",
- "type": "string"
- },
- "radius": {
- "description": "Radius for proximity targeting",
- "example": 25,
- "type": "number"
- },
- "radiusUnit": {
- "description": "Radius unit",
- "enum": [
- "km",
- "mi"
- ],
- "example": "mi",
- "type": "string"
- },
- "resourceName": {
- "description": "Google Ads resource name",
- "example": "customers/123/geoTargetConstants/2840",
- "type": "string"
- },
- "selectionType": {
- "description": "Include or exclude this location",
- "enum": [
- "include",
- "exclude"
- ],
- "example": "include",
- "type": "string"
- },
- "type": {
- "description": "Location type (city, region, country, address, etc.)",
- "example": "city",
- "type": "string"
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "locales": {
- "description": "Language/locale targeting",
- "example": [
- {
- "key": "1000",
- "name": "English"
- }
- ],
- "items": {
- "properties": {
- "id": {
- "description": "Language identifier",
- "example": "1000",
- "type": "string"
- },
- "key": {
- "description": "Language key",
- "example": "1000",
- "type": "string"
- },
- "name": {
- "description": "Language display name",
- "example": "English",
- "type": "string"
- },
- "resourceName": {
- "description": "Language resource name",
- "example": "languageConstants/1000",
- "type": "string"
- }
- },
- "type": "object"
- },
- "type": "array"
- }
- },
- "type": "object"
- }
-]New value: +[
+ {
+ "properties": {
+ "geoLocations": {
+ "description": "Geo-location targeting",
+ "example": [
+ {
+ "key": "geoTargetConstants/2840",
+ "name": "United States",
+ "type": "country"
+ }
+ ],
+ "items": {
+ "properties": {
+ "addressComponents": {
+ "description": "Address components from Google Geocoding API",
+ "example": [
+ {
+ "longName": "New York",
+ "shortName": "NY",
+ "types": [
+ "locality",
+ "political"
+ ]
+ }
+ ],
+ "items": {
+ "properties": {
+ "longName": {
+ "description": "Full name of the address component",
+ "example": "New York",
+ "type": "string"
+ },
+ "shortName": {
+ "description": "Abbreviated name of the address component",
+ "example": "NY",
+ "type": "string"
+ },
+ "types": {
+ "description": "Address component types",
+ "example": [
+ "locality",
+ "political"
+ ],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "title": "GeoAddressComponentDTO",
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "countryName": {
+ "description": "Country name",
+ "example": "United States",
+ "type": "string"
+ },
+ "formattedAddress": {
+ "description": "Full formatted address string",
+ "example": "New York, NY, USA",
+ "type": "string"
+ },
+ "geometry": {
+ "allOf": [
+ {
+ "properties": {
+ "location": {
+ "allOf": [
+ {
+ "properties": {
+ "lat": {
+ "description": "Latitude",
+ "example": 40.7128,
+ "type": "number"
+ },
+ "lng": {
+ "description": "Longitude",
+ "example": -74.006,
+ "type": "number"
+ }
+ },
+ "title": "GeoLatLngDTO",
+ "type": "object"
+ }
+ ],
+ "description": "Location coordinates",
+ "example": {
+ "lat": 40.7128,
+ "lng": -74.006
+ }
+ },
+ "locationType": {
+ "description": "Location type (e.g. APPROXIMATE)",
+ "example": "APPROXIMATE",
+ "type": "string"
+ },
+ "viewport": {
+ "allOf": [
+ {
+ "properties": {
+ "northeast": {
+ "allOf": [
+ {
+ "properties": {
+ "lat": {
+ "description": "Latitude",
+ "example": 40.7128,
+ "type": "number"
+ },
+ "lng": {
+ "description": "Longitude",
+ "example": -74.006,
+ "type": "number"
+ }
+ },
+ "title": "GeoLatLngDTO",
+ "type": "object"
+ }
+ ],
+ "description": "Northeast corner of the viewport",
+ "example": {
+ "lat": 40.8,
+ "lng": -73.9
+ }
+ },
+ "southwest": {
+ "allOf": [
+ {
+ "properties": {
+ "lat": {
+ "description": "Latitude",
+ "example": 40.7128,
+ "type": "number"
+ },
+ "lng": {
+ "description": "Longitude",
+ "example": -74.006,
+ "type": "number"
+ }
+ },
+ "title": "GeoLatLngDTO",
+ "type": "object"
+ }
+ ],
+ "description": "Southwest corner of the viewport",
+ "example": {
+ "lat": 40.6,
+ "lng": -74.1
+ }
+ }
+ },
+ "title": "GeoViewportDTO",
+ "type": "object"
+ }
+ ],
+ "description": "Viewport bounding box",
+ "example": {
+ "northeast": {
+ "lat": 40.8,
+ "lng": -73.9
+ },
+ "southwest": {
+ "lat": 40.6,
+ "lng": -74.1
+ }
+ }
+ }
+ },
+ "title": "GeoGeometryDTO",
+ "type": "object"
+ }
+ ],
+ "description": "Geometry data from Google Geocoding API",
+ "example": {
+ "location": {
+ "lat": 40.7128,
+ "lng": -74.006
+ },
+ "locationType": "APPROXIMATE"
+ }
+ },
+ "id": {
+ "description": "Location identifier (place_id)",
+ "example": "ChIJOwg_06VPwokRYv534QaPC8g",
+ "type": "string"
+ },
+ "key": {
+ "description": "Geo target constant resource name",
+ "example": "geoTargetConstants/2840",
+ "type": "string"
+ },
+ "name": {
+ "description": "Location display name",
+ "example": "New York",
+ "type": "string"
+ },
+ "placeId": {
+ "description": "Google place ID",
+ "example": "ChIJOwg_06VPwokRYv534QaPC8g",
+ "type": "string"
+ },
+ "radius": {
+ "description": "Radius for proximity targeting",
+ "example": 25,
+ "type": "number"
+ },
+ "radiusUnit": {
+ "description": "Radius unit",
+ "enum": [
+ "km",
+ "mi"
+ ],
+ "example": "mi",
+ "type": "string"
+ },
+ "resourceName": {
+ "description": "Google Ads resource name",
+ "example": "customers/123/geoTargetConstants/2840",
+ "type": "string"
+ },
+ "selectionType": {
+ "description": "Include or exclude this location",
+ "enum": [
+ "include",
+ "exclude"
+ ],
+ "example": "include",
+ "type": "string"
+ },
+ "type": {
+ "description": "Location type (city, region, country, address, etc.)",
+ "example": "city",
+ "type": "string"
+ }
+ },
+ "title": "GoogleGeoLocationDTO",
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "locales": {
+ "description": "Language/locale targeting",
+ "example": [
+ {
+ "key": "1000",
+ "name": "English"
+ }
+ ],
+ "items": {
+ "properties": {
+ "id": {
+ "description": "Language identifier",
+ "example": "1000",
+ "type": "string"
+ },
+ "key": {
+ "description": "Language key",
+ "example": "1000",
+ "type": "string"
+ },
+ "name": {
+ "description": "Language display name",
+ "example": "English",
+ "type": "string"
+ },
+ "resourceName": {
+ "description": "Language resource name",
+ "example": "languageConstants/1000",
+ "type": "string"
+ }
+ },
+ "title": "GoogleLocaleDTO",
+ "type": "object"
+ },
+ "type": "array"
+ }
+ },
+ "title": "GoogleAdGroupAudienceDTO",
+ "type": "object"
+ }
+]
changedInput schema / properties / body / properties / adGroups / items / properties / audience / example / locales
Previous value: -[]New value: +[
+ {
+ "key": "languageConstants/1000",
+ "name": "English"
+ }
+]
changedInput schema / properties / body / properties / adGroups / items / properties / keywords / allOf
Previous value: -[
- {
- "properties": {
- "negatives": {
- "description": "Negative keywords",
- "example": [
- {
- "keyword": "free",
- "matchType": "EXACT"
- }
- ],
- "items": {
- "properties": {
- "keyword": {
- "description": "Keyword text",
- "example": "digital marketing",
- "type": "string"
- },
- "matchType": {
- "description": "Match type (BROAD, PHRASE, EXACT)",
- "example": "BROAD",
- "type": "string"
- }
- },
- "required": [
- "keyword",
- "matchType"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "positives": {
- "description": "Positive keywords",
- "example": [
- {
- "keyword": "digital marketing",
- "matchType": "BROAD"
- }
- ],
- "items": {
- "properties": {
- "keyword": {
- "description": "Keyword text",
- "example": "digital marketing",
- "type": "string"
- },
- "matchType": {
- "description": "Match type (BROAD, PHRASE, EXACT)",
- "example": "BROAD",
- "type": "string"
- }
- },
- "required": [
- "keyword",
- "matchType"
- ],
- "type": "object"
- },
- "type": "array"
- }
- },
- "type": "object"
- }
-]New value: +[
+ {
+ "properties": {
+ "negatives": {
+ "description": "Negative keywords",
+ "example": [
+ {
+ "keyword": "free",
+ "matchType": "EXACT"
+ }
+ ],
+ "items": {
+ "properties": {
+ "keyword": {
+ "description": "Keyword text",
+ "example": "digital marketing",
+ "type": "string"
+ },
+ "matchType": {
+ "description": "Match type (BROAD, PHRASE, EXACT)",
+ "example": "BROAD",
+ "type": "string"
+ }
+ },
+ "required": [
+ "keyword",
+ "matchType"
+ ],
+ "title": "GoogleKeywordItemDTO",
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "positives": {
+ "description": "Positive keywords",
+ "example": [
+ {
+ "keyword": "digital marketing",
+ "matchType": "BROAD"
+ }
+ ],
+ "items": {
+ "properties": {
+ "keyword": {
+ "description": "Keyword text",
+ "example": "digital marketing",
+ "type": "string"
+ },
+ "matchType": {
+ "description": "Match type (BROAD, PHRASE, EXACT)",
+ "example": "BROAD",
+ "type": "string"
+ }
+ },
+ "required": [
+ "keyword",
+ "matchType"
+ ],
+ "title": "GoogleKeywordItemDTO",
+ "type": "object"
+ },
+ "type": "array"
+ }
+ },
+ "title": "GoogleKeywordsDTO",
+ "type": "object"
+ }
+]
changedInput schema / properties / body / properties / adGroups / items / properties / keywords / example / negatives
Previous value: -[]New value: +[
+ {
+ "keyword": "free digital marketing",
+ "matchType": "BROAD"
+ }
+]
changedInput schema / properties / body / properties / adGroups / items / properties / selectedChannels / example
Previous value: -[
- "YOUTUBE"
-]New value: +[
+ "YOUTUBE_IN_STREAM"
+]
addedInput schema / properties / body / properties / adGroups / items / title
Added value: +"GoogleAdGroupDTO"
addedInput schema / properties / body / properties / adSchedule / items / title
Added value: +"GoogleAdScheduleDTO"
changedInput schema / properties / body / properties / advertisingChannelSubType / example
Previous value: -"SEARCH_MOBILE_APP"New value: +"DEMAND_GEN"
changedInput schema / properties / body / properties / advertisingChannelType / description
Previous value: -"Advertising channel"New value: +"Advertising channel. Only `SEARCH` and `DEMAND_GEN` campaigns can be built and published by this product; the other Google channels are readable on existing campaigns but cannot be created here."
changedInput schema / properties / body / properties / advertisingChannelType / enum
Previous value: -[
- "SEARCH",
- "DISCOVERY",
- "DISPLAY",
- "HOTEL",
- "LOCAL",
- "MULTI_CHANNEL",
- "PERFORMANCE_MAX",
- "DEMAND_GEN"
-]New value: +[
+ "SEARCH",
+ "DEMAND_GEN"
+]
changedInput schema / properties / body / properties / assets / allOf
Previous value: -[
- {
- "properties": {
- "businessLogo": {
- "allOf": [
- {
- "properties": {
- "error": {
- "description": "Error message if asset upload failed",
- "example": "Image too large",
- "type": "string"
- },
- "name": {
- "description": "Asset name",
- "example": "Logo",
- "type": "string"
- },
- "resourceName": {
- "description": "Google Ads resource name",
- "example": "customers/123/assets/456",
- "type": "string"
- },
- "url": {
- "description": "Image URL",
- "example": "https://example.com/logo.png",
- "type": "string"
- }
- },
- "required": [
- "url"
- ],
- "type": "object"
- }
- ],
- "description": "Business logo asset",
- "example": {
- "name": "Business Logo",
- "url": "https://example.com/logo.png"
- }
- },
- "calls": {
- "description": "Call extension asset resource names",
- "example": [
- "customers/123/assets/456"
- ],
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "images": {
- "description": "Image assets",
- "example": [
- {
- "name": "Logo",
- "url": "https://example.com/logo.png"
- }
- ],
- "items": {
- "properties": {
- "error": {
- "description": "Error message if asset upload failed",
- "example": "Image too large",
- "type": "string"
- },
- "name": {
- "description": "Asset name",
- "example": "Logo",
- "type": "string"
- },
- "resourceName": {
- "description": "Google Ads resource name",
- "example": "customers/123/assets/456",
- "type": "string"
- },
- "url": {
- "description": "Image URL",
- "example": "https://example.com/logo.png",
- "type": "string"
- }
- },
- "required": [
- "url"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "leadForm": {
- "description": "Lead form asset resource name",
- "example": "customers/123/assets/321",
- "type": "string"
- },
- "sitelinks": {
- "description": "Sitelink asset resource names",
- "example": [
- "customers/123/assets/789"
- ],
- "items": {
- "type": "string"
- },
- "type": "array"
- }
- },
- "type": "object"
- }
-]New value: +[
+ {
+ "properties": {
+ "businessLogo": {
+ "allOf": [
+ {
+ "properties": {
+ "error": {
+ "description": "Error message if asset upload failed",
+ "example": "Image too large",
+ "type": "string"
+ },
+ "name": {
+ "description": "Asset name",
+ "example": "Logo",
+ "type": "string"
+ },
+ "resourceName": {
+ "description": "Google Ads resource name",
+ "example": "customers/123/assets/456",
+ "type": "string"
+ },
+ "url": {
+ "description": "Image URL",
+ "example": "https://example.com/logo.png",
+ "type": "string"
+ }
+ },
+ "required": [
+ "url"
+ ],
+ "title": "GoogleAssetImageDTO",
+ "type": "object"
+ }
+ ],
+ "description": "Business logo asset",
+ "example": {
+ "name": "Business Logo",
+ "url": "https://example.com/logo.png"
+ }
+ },
+ "calls": {
+ "description": "Call extension asset resource names",
+ "example": [
+ "customers/123/assets/456"
+ ],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "images": {
+ "description": "Image assets",
+ "example": [
+ {
+ "name": "Logo",
+ "url": "https://example.com/logo.png"
+ }
+ ],
+ "items": {
+ "properties": {
+ "error": {
+ "description": "Error message if asset upload failed",
+ "example": "Image too large",
+ "type": "string"
+ },
+ "name": {
+ "description": "Asset name",
+ "example": "Logo",
+ "type": "string"
+ },
+ "resourceName": {
+ "description": "Google Ads resource name",
+ "example": "customers/123/assets/456",
+ "type": "string"
+ },
+ "url": {
+ "description": "Image URL",
+ "example": "https://example.com/logo.png",
+ "type": "string"
+ }
+ },
+ "required": [
+ "url"
+ ],
+ "title": "GoogleAssetImageDTO",
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "leadForm": {
+ "description": "Lead form asset resource name",
+ "example": "customers/123/assets/321",
+ "type": "string"
+ },
+ "sitelinks": {
+ "description": "Sitelink asset resource names",
+ "example": [
+ "customers/123/assets/789"
+ ],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "title": "GoogleAssetsDTO",
+ "type": "object"
+ }
+]
changedInput schema / properties / body / properties / assets / example / calls
Previous value: -[]New value: +[
+ "customers/6776452901/assets/112233445"
+]
changedInput schema / properties / body / properties / assets / example / images
Previous value: -[]New value: +[
+ "customers/6776452901/assets/112233448"
+]
changedInput schema / properties / body / properties / assets / example / sitelinks
Previous value: -[]New value: +[
+ "customers/6776452901/assets/112233446"
+]
changedInput schema / properties / body / properties / audience / allOf
Previous value: -[
- {
- "properties": {
- "ageRange": {
- "description": "Age range targeting",
- "example": [
- {
- "enum": "AGE_RANGE_25_34",
- "negative": false
- }
- ],
- "items": {
- "properties": {
- "enum": {
- "description": "Demographic enum value",
- "example": "MALE",
- "type": "string"
- },
- "negative": {
- "description": "Whether this is a negative target",
- "example": false,
- "type": "boolean"
- }
- },
- "required": [
- "enum",
- "negative"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "gender": {
- "description": "Gender targeting",
- "example": [
- {
- "enum": "MALE",
- "negative": false
- }
- ],
- "items": {
- "properties": {
- "enum": {
- "description": "Demographic enum value",
- "example": "MALE",
- "type": "string"
- },
- "negative": {
- "description": "Whether this is a negative target",
- "example": false,
- "type": "boolean"
- }
- },
- "required": [
- "enum",
- "negative"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "geoLocations": {
- "description": "Geo-location targeting",
- "example": [
- {
- "key": "geoTargetConstants/2840",
- "name": "United States",
- "type": "country"
- }
- ],
- "items": {
- "properties": {
- "addressComponents": {
- "description": "Address components from Google Geocoding API",
- "example": [
- {
- "longName": "New York",
- "shortName": "NY",
- "types": [
- "locality",
- "political"
- ]
- }
- ],
- "items": {
- "properties": {
- "longName": {
- "description": "Full name of the address component",
- "example": "New York",
- "type": "string"
- },
- "shortName": {
- "description": "Abbreviated name of the address component",
- "example": "NY",
- "type": "string"
- },
- "types": {
- "description": "Address component types",
- "example": [
- "locality",
- "political"
- ],
- "items": {
- "type": "string"
- },
- "type": "array"
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "countryName": {
- "description": "Country name",
- "example": "United States",
- "type": "string"
- },
- "formattedAddress": {
- "description": "Full formatted address string",
- "example": "New York, NY, USA",
- "type": "string"
- },
- "geometry": {
- "allOf": [
- {
- "properties": {
- "location": {
- "allOf": [
- {
- "properties": {
- "lat": {
- "description": "Latitude",
- "example": 40.7128,
- "type": "number"
- },
- "lng": {
- "description": "Longitude",
- "example": -74.006,
- "type": "number"
- }
- },
- "type": "object"
- }
- ],
- "description": "Location coordinates",
- "example": {
- "lat": 40.7128,
- "lng": -74.006
- }
- },
- "locationType": {
- "description": "Location type (e.g. APPROXIMATE)",
- "example": "APPROXIMATE",
- "type": "string"
- },
- "viewport": {
- "allOf": [
- {
- "properties": {
- "northeast": {
- "allOf": [
- {
- "properties": {
- "lat": {
- "description": "Latitude",
- "example": 40.7128,
- "type": "number"
- },
- "lng": {
- "description": "Longitude",
- "example": -74.006,
- "type": "number"
- }
- },
- "type": "object"
- }
- ],
- "description": "Northeast corner of the viewport",
- "example": {
- "lat": 40.8,
- "lng": -73.9
- }
- },
- "southwest": {
- "allOf": [
- {
- "properties": {
- "lat": {
- "description": "Latitude",
- "example": 40.7128,
- "type": "number"
- },
- "lng": {
- "description": "Longitude",
- "example": -74.006,
- "type": "number"
- }
- },
- "type": "object"
- }
- ],
- "description": "Southwest corner of the viewport",
- "example": {
- "lat": 40.6,
- "lng": -74.1
- }
- }
- },
- "type": "object"
- }
- ],
- "description": "Viewport bounding box",
- "example": {
- "northeast": {
- "lat": 40.8,
- "lng": -73.9
- },
- "southwest": {
- "lat": 40.6,
- "lng": -74.1
- }
- }
- }
- },
- "type": "object"
- }
- ],
- "description": "Geometry data from Google Geocoding API",
- "example": {
- "location": {
- "lat": 40.7128,
- "lng": -74.006
- },
- "locationType": "APPROXIMATE"
- }
- },
- "id": {
- "description": "Location identifier (place_id)",
- "example": "ChIJOwg_06VPwokRYv534QaPC8g",
- "type": "string"
- },
- "key": {
- "description": "Geo target constant resource name",
- "example": "geoTargetConstants/2840",
- "type": "string"
- },
- "name": {
- "description": "Location display name",
- "example": "New York",
- "type": "string"
- },
- "placeId": {
- "description": "Google place ID",
- "example": "ChIJOwg_06VPwokRYv534QaPC8g",
- "type": "string"
- },
- "radius": {
- "description": "Radius for proximity targeting",
- "example": 25,
- "type": "number"
- },
- "radiusUnit": {
- "description": "Radius unit",
- "enum": [
- "km",
- "mi"
- ],
- "example": "mi",
- "type": "string"
- },
- "resourceName": {
- "description": "Google Ads resource name",
- "example": "customers/123/geoTargetConstants/2840",
- "type": "string"
- },
- "selectionType": {
- "description": "Include or exclude this location",
- "enum": [
- "include",
- "exclude"
- ],
- "example": "include",
- "type": "string"
- },
- "type": {
- "description": "Location type (city, region, country, address, etc.)",
- "example": "city",
- "type": "string"
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "locales": {
- "description": "Language/locale targeting",
- "example": [
- {
- "key": "1000",
- "name": "English"
- }
- ],
- "items": {
- "properties": {
- "id": {
- "description": "Language identifier",
- "example": "1000",
- "type": "string"
- },
- "key": {
- "description": "Language key",
- "example": "1000",
- "type": "string"
- },
- "name": {
- "description": "Language display name",
- "example": "English",
- "type": "string"
- },
- "resourceName": {
- "description": "Language resource name",
- "example": "languageConstants/1000",
- "type": "string"
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "segments": {
- "description": "Audience segment targeting",
- "example": [
- {
- "id": "customers/123/userLists/456",
- "type": "USER_LIST"
- }
- ],
- "items": {
- "properties": {
- "id": {
- "description": "Segment identifier",
- "example": "customers/123/userLists/456",
- "type": "string"
- },
- "type": {
- "description": "Segment type",
- "example": "USER_LIST",
- "type": "string"
- }
- },
- "required": [
- "type",
- "id"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "targetInterests": {
- "allOf": [
- {
- "properties": {
- "affinity": {
- "description": "Affinity audience IDs",
- "example": [
- "customers/123/userInterests/789"
- ],
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "inMarket": {
- "description": "In-market audience IDs",
- "example": [
- "customers/123/userInterests/321"
- ],
- "items": {
- "type": "string"
- },
- "type": "array"
- }
- },
- "type": "object"
- }
- ],
- "description": "Interest-based targeting",
- "example": {
- "affinity": [
- "customers/123/userInterests/789"
- ],
- "inMarket": []
- }
- }
- },
- "type": "object"
- }
-]New value: +[
+ {
+ "properties": {
+ "ageRange": {
+ "description": "Age range targeting",
+ "example": [
+ {
+ "enum": "AGE_RANGE_25_34",
+ "negative": false
+ }
+ ],
+ "items": {
+ "properties": {
+ "enum": {
+ "description": "Age bucket to target",
+ "enum": [
+ "AGE_RANGE_18_24",
+ "AGE_RANGE_25_34",
+ "AGE_RANGE_35_44",
+ "AGE_RANGE_45_54",
+ "AGE_RANGE_55_64",
+ "AGE_RANGE_65_UP",
+ "AGE_RANGE_UNDETERMINED"
+ ],
+ "example": "AGE_RANGE_25_34",
+ "type": "string"
+ },
+ "negative": {
+ "description": "Whether this is a negative target",
+ "example": false,
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "enum",
+ "negative"
+ ],
+ "title": "GoogleAgeRangeTargetDTO",
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "gender": {
+ "description": "Gender targeting",
+ "example": [
+ {
+ "enum": "MALE",
+ "negative": false
+ }
+ ],
+ "items": {
+ "properties": {
+ "enum": {
+ "description": "Gender to target",
+ "enum": [
+ "MALE",
+ "FEMALE",
+ "UNDETERMINED"
+ ],
+ "example": "MALE",
+ "type": "string"
+ },
+ "negative": {
+ "description": "Whether this is a negative target",
+ "example": false,
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "enum",
+ "negative"
+ ],
+ "title": "GoogleGenderTargetDTO",
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "geoLocations": {
+ "description": "Geographic targeting",
+ "example": [
+ {
+ "addressComponents": [
+ {
+ "longName": "New York",
+ "shortName": "NY",
+ "types": [
+ "locality",
+ "political"
+ ]
+ }
+ ],
+ "countryName": "United States",
+ "formattedAddress": "New York, NY, USA",
+ "geometry": {
+ "location": {
+ "lat": 40.7128,
+ "lng": -74.006
+ },
+ "locationType": "APPROXIMATE"
+ },
+ "id": "ChIJOwg_06VPwokRYv534QaPC8g",
+ "key": "geoTargetConstants/2840",
+ "name": "New York",
+ "placeId": "ChIJOwg_06VPwokRYv534QaPC8g",
+ "radius": 25,
+ "radiusUnit": "mi",
+ "resourceName": "customers/123/geoTargetConstants/2840",
+ "selectionType": "include",
+ "type": "city"
+ }
+ ],
+ "items": {
+ "properties": {
+ "addressComponents": {
+ "description": "Address components from Google Geocoding API",
+ "example": [
+ {
+ "longName": "New York",
+ "shortName": "NY",
+ "types": [
+ "locality",
+ "political"
+ ]
+ }
+ ],
+ "items": {
+ "properties": {
+ "longName": {
+ "description": "Full name of the address component",
+ "example": "New York",
+ "type": "string"
+ },
+ "shortName": {
+ "description": "Abbreviated name of the address component",
+ "example": "NY",
+ "type": "string"
+ },
+ "types": {
+ "description": "Address component types",
+ "example": [
+ "locality",
+ "political"
+ ],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "title": "GeoAddressComponentDTO",
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "countryName": {
+ "description": "Country name",
+ "example": "United States",
+ "type": "string"
+ },
+ "formattedAddress": {
+ "description": "Full formatted address string",
+ "example": "New York, NY, USA",
+ "type": "string"
+ },
+ "geometry": {
+ "allOf": [
+ {
+ "properties": {
+ "location": {
+ "allOf": [
+ {
+ "properties": {
+ "lat": {
+ "description": "Latitude",
+ "example": 40.7128,
+ "type": "number"
+ },
+ "lng": {
+ "description": "Longitude",
+ "example": -74.006,
+ "type": "number"
+ }
+ },
+ "title": "GeoLatLngDTO",
+ "type": "object"
+ }
+ ],
+ "description": "Location coordinates",
+ "example": {
+ "lat": 40.7128,
+ "lng": -74.006
+ }
+ },
+ "locationType": {
+ "description": "Location type (e.g. APPROXIMATE)",
+ "example": "APPROXIMATE",
+ "type": "string"
+ },
+ "viewport": {
+ "allOf": [
+ {
+ "properties": {
+ "northeast": {
+ "allOf": [
+ {
+ "properties": {
+ "lat": {
+ "description": "Latitude",
+ "example": 40.7128,
+ "type": "number"
+ },
+ "lng": {
+ "description": "Longitude",
+ "example": -74.006,
+ "type": "number"
+ }
+ },
+ "title": "GeoLatLngDTO",
+ "type": "object"
+ }
+ ],
+ "description": "Northeast corner of the viewport",
+ "example": {
+ "lat": 40.8,
+ "lng": -73.9
+ }
+ },
+ "southwest": {
+ "allOf": [
+ {
+ "properties": {
+ "lat": {
+ "description": "Latitude",
+ "example": 40.7128,
+ "type": "number"
+ },
+ "lng": {
+ "description": "Longitude",
+ "example": -74.006,
+ "type": "number"
+ }
+ },
+ "title": "GeoLatLngDTO",
+ "type": "object"
+ }
+ ],
+ "description": "Southwest corner of the viewport",
+ "example": {
+ "lat": 40.6,
+ "lng": -74.1
+ }
+ }
+ },
+ "title": "GeoViewportDTO",
+ "type": "object"
+ }
+ ],
+ "description": "Viewport bounding box",
+ "example": {
+ "northeast": {
+ "lat": 40.8,
+ "lng": -73.9
+ },
+ "southwest": {
+ "lat": 40.6,
+ "lng": -74.1
+ }
+ }
+ }
+ },
+ "title": "GeoGeometryDTO",
+ "type": "object"
+ }
+ ],
+ "description": "Geometry data from Google Geocoding API",
+ "example": {
+ "location": {
+ "lat": 40.7128,
+ "lng": -74.006
+ },
+ "locationType": "APPROXIMATE"
+ }
+ },
+ "id": {
+ "description": "Location identifier (place_id)",
+ "example": "ChIJOwg_06VPwokRYv534QaPC8g",
+ "type": "string"
+ },
+ "key": {
+ "description": "Geo target constant resource name",
+ "example": "geoTargetConstants/2840",
+ "type": "string"
+ },
+ "name": {
+ "description": "Location display name",
+ "example": "New York",
+ "type": "string"
+ },
+ "placeId": {
+ "description": "Google place ID",
+ "example": "ChIJOwg_06VPwokRYv534QaPC8g",
+ "type": "string"
+ },
+ "radius": {
+ "description": "Radius for proximity targeting",
+ "example": 25,
+ "type": "number"
+ },
+ "radiusUnit": {
+ "description": "Radius unit",
+ "enum": [
+ "km",
+ "mi"
+ ],
+ "example": "mi",
+ "type": "string"
+ },
+ "resourceName": {
+ "description": "Google Ads resource name",
+ "example": "customers/123/geoTargetConstants/2840",
+ "type": "string"
+ },
+ "selectionType": {
+ "description": "Include or exclude this location",
+ "enum": [
+ "include",
+ "exclude"
+ ],
+ "example": "include",
+ "type": "string"
+ },
+ "type": {
+ "description": "Location type (city, region, country, address, etc.)",
+ "example": "city",
+ "type": "string"
+ }
+ },
+ "title": "GoogleGeoLocationDTO",
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "locales": {
+ "description": "Language targeting",
+ "example": [
+ {
+ "id": "1000",
+ "key": "1000",
+ "name": "English",
+ "resourceName": "languageConstants/1000"
+ }
+ ],
+ "items": {
+ "properties": {
+ "id": {
+ "description": "Language identifier",
+ "example": "1000",
+ "type": "string"
+ },
+ "key": {
+ "description": "Language key",
+ "example": "1000",
+ "type": "string"
+ },
+ "name": {
+ "description": "Language display name",
+ "example": "English",
+ "type": "string"
+ },
+ "resourceName": {
+ "description": "Language resource name",
+ "example": "languageConstants/1000",
+ "type": "string"
+ }
+ },
+ "title": "GoogleLocaleDTO",
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "segments": {
+ "description": "Audience segment resource names",
+ "example": [
+ "customers/6776452901/userLists/9215680180"
+ ],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "targetInterests": {
+ "allOf": [
+ {
+ "properties": {
+ "affinity": {
+ "description": "Affinity audience resource names",
+ "example": [
+ "customers/6776452901/userInterests/80351"
+ ],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "inMarket": {
+ "description": "In-market audience resource names",
+ "example": [
+ "customers/6776452901/userInterests/80148"
+ ],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "affinity",
+ "inMarket"
+ ],
+ "title": "GoogleTargetInterestsDTO",
+ "type": "object"
+ }
+ ],
+ "description": "Affinity and in-market interests",
+ "example": {
+ "affinity": [
+ "customers/6776452901/userInterests/80351"
+ ],
+ "inMarket": [
+ "customers/6776452901/userInterests/80148"
+ ]
+ }
+ }
+ },
+ "required": [
+ "locales",
+ "geoLocations"
+ ],
+ "title": "GoogleCampaignAudienceDTO",
+ "type": "object"
+ }
+]
changedInput schema / properties / body / properties / biddingStrategy / allOf
Previous value: -[
- {
- "properties": {
- "type": {
- "description": "Bidding strategy type",
- "example": "MAXIMIZE_CONVERSIONS",
- "type": "string"
- },
- "value": {
- "description": "Bid value in micros",
- "example": 1000000,
- "type": "number"
- }
- },
- "type": "object"
- }
-]New value: +[
+ {
+ "properties": {
+ "type": {
+ "description": "Bidding strategy type",
+ "example": "MAXIMIZE_CONVERSIONS",
+ "type": "string"
+ },
+ "value": {
+ "description": "Bid value in micros",
+ "example": 1000000,
+ "type": "number"
+ }
+ },
+ "title": "GoogleBiddingStrategyDTO",
+ "type": "object"
+ }
+]
changedInput schema / properties / body / properties / budget / allOf
Previous value: -[
- {
- "properties": {
- "amount": {
- "description": "Budget amount in micros",
- "example": 5000,
- "type": "number"
- },
- "budgetType": {
- "description": "Budget type",
- "enum": [
- "DAILY",
- "LIFETIME"
- ],
- "example": "DAILY",
- "type": "string"
- },
- "scheduleEndDate": {
- "description": "Schedule end date",
- "example": "2024-12-31",
- "type": "string"
- },
- "scheduleStartDate": {
- "description": "Schedule start date",
- "example": "2024-01-01",
- "type": "string"
- }
- },
- "type": "object"
- }
-]New value: +[
+ {
+ "properties": {
+ "amount": {
+ "description": "Budget amount in micros",
+ "example": 5000,
+ "type": "number"
+ },
+ "budgetType": {
+ "description": "Budget type",
+ "enum": [
+ "DAILY",
+ "LIFETIME"
+ ],
+ "example": "DAILY",
+ "type": "string"
+ },
+ "scheduleEndDate": {
+ "description": "Schedule end date",
+ "example": "2024-12-31",
+ "type": "string"
+ },
+ "scheduleStartDate": {
+ "description": "Schedule start date",
+ "example": "2024-01-01",
+ "type": "string"
+ }
+ },
+ "title": "GoogleBudgetDTO",
+ "type": "object"
+ }
+]
changedInput schema / properties / body / properties / campaignGoal / allOf
Previous value: -[
- {
- "properties": {
- "isCustomConversionGoal": {
- "description": "Whether this is a custom conversion goal",
- "example": false,
- "type": "boolean"
- },
- "type": {
- "description": "Campaign goal type",
- "enum": [
- "CONVERSIONS",
- "CLICK",
- "YOUTUBE_ENGAGEMENT"
- ],
- "example": "WEBSITE_TRAFFIC",
- "type": "string"
- },
- "value": {
- "description": "Goal value (e.g. conversion action resource name)",
- "example": "customers/123/conversionActions/456",
- "type": "string"
- }
- },
- "required": [
- "type"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "properties": {
+ "isCustomConversionGoal": {
+ "description": "Whether this is a custom conversion goal",
+ "example": false,
+ "type": "boolean"
+ },
+ "type": {
+ "description": "Campaign goal type",
+ "enum": [
+ "CONVERSIONS",
+ "CLICK",
+ "YOUTUBE_ENGAGEMENT"
+ ],
+ "example": "CLICK",
+ "type": "string"
+ },
+ "value": {
+ "description": "Goal value (e.g. conversion action resource name)",
+ "example": "customers/123/conversionActions/456",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "GoogleCampaignGoalDTO",
+ "type": "object"
+ }
+]
addedInput schema / properties / body / properties / customValueMappings
Added value: +{
+ "description": "User-provided overrides for custom_values merge tags used in ad copy",
+ "example": {
+ "{{ custom_values.pet_name }}": "Fluffy"
+ },
+ "type": "object"
+}
changedInput schema / properties / body / properties / networkSettings / allOf
Previous value: -[
- {
- "properties": {
- "targetContentNetwork": {
- "description": "Target Google Display Network",
- "example": false,
- "type": "boolean"
- },
- "targetSearchNetwork": {
- "description": "Target Google Search Network",
- "example": true,
- "type": "boolean"
- }
- },
- "required": [
- "targetSearchNetwork",
- "targetContentNetwork"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "properties": {
+ "targetContentNetwork": {
+ "description": "Serve on the Display/content network",
+ "example": false,
+ "type": "boolean"
+ },
+ "targetSearchNetwork": {
+ "description": "Serve on the Search network",
+ "example": true,
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "targetSearchNetwork",
+ "targetContentNetwork"
+ ],
+ "title": "GoogleNetworkSettingsDTO",
+ "type": "object"
+ }
+]
addedInput schema / properties / body / title
Added value: +"CampaignDTO"