Skip to content
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Commit 309d467

Browse files
committedMay 24, 2023
feat(searchads360): update the api
#### searchads360:v0 The following keys were deleted: - resources.customers.resources.searchAds360.methods.searchStream (Total Keys: 12) - schemas.GoogleAdsSearchads360V0Services__SearchSearchAds360StreamRequest (Total Keys: 6) - schemas.GoogleAdsSearchads360V0Services__SearchSearchAds360StreamResponse (Total Keys: 10) The following keys were added: - schemas.GoogleAdsSearchads360V0Common__Keyword (Total Keys: 4) - schemas.GoogleAdsSearchads360V0Common__SearchAds360ExpandedDynamicSearchAdInfo (Total Keys: 4) - schemas.GoogleAdsSearchads360V0Common__SearchAds360ExpandedTextAdInfo (Total Keys: 9) - schemas.GoogleAdsSearchads360V0Common__SearchAds360ProductAdInfo (Total Keys: 2) - schemas.GoogleAdsSearchads360V0Common__SearchAds360ResponsiveSearchAdInfo (Total Keys: 6) - schemas.GoogleAdsSearchads360V0Common__SearchAds360TextAdInfo (Total Keys: 5) - schemas.GoogleAdsSearchads360V0Common__Segments.properties.keyword.$ref (Total Keys: 1) - schemas.GoogleAdsSearchads360V0Resources__Ad.properties.expandedDynamicSearchAd.$ref (Total Keys: 1) - schemas.GoogleAdsSearchads360V0Resources__Ad.properties.expandedTextAd.$ref (Total Keys: 1) - schemas.GoogleAdsSearchads360V0Resources__Ad.properties.productAd.$ref (Total Keys: 1) - schemas.GoogleAdsSearchads360V0Resources__Ad.properties.responsiveSearchAd.$ref (Total Keys: 1) - schemas.GoogleAdsSearchads360V0Resources__Ad.properties.textAd.$ref (Total Keys: 1) - schemas.GoogleAdsSearchads360V0Resources__AdGroupCriterion.properties.location.readOnly (Total Keys: 1)
1 parent ded1e61 commit 309d467

File tree

2 files changed

+237
-1292
lines changed

2 files changed

+237
-1292
lines changed
 

‎docs/dyn/searchads360_v0.customers.searchAds360.html

+76-1,193
Large diffs are not rendered by default.

‎googleapiclient/discovery_cache/documents/searchads360.v0.json

+161-99
Original file line numberDiff line numberDiff line change
@@ -190,34 +190,6 @@
190190
"scopes": [
191191
"https://www.googleapis.com/auth/doubleclicksearch"
192192
]
193-
},
194-
"searchStream": {
195-
"description": "Returns all rows that match the search stream query. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [HeaderError]() [InternalError]() [QueryError]() [QuotaError]() [RequestError]()",
196-
"flatPath": "v0/customers/{customersId}/searchAds360:searchStream",
197-
"httpMethod": "POST",
198-
"id": "searchads360.customers.searchAds360.searchStream",
199-
"parameterOrder": [
200-
"customerId"
201-
],
202-
"parameters": {
203-
"customerId": {
204-
"description": "Required. The ID of the customer being queried.",
205-
"location": "path",
206-
"pattern": "^[^/]+$",
207-
"required": true,
208-
"type": "string"
209-
}
210-
},
211-
"path": "v0/customers/{+customerId}/searchAds360:searchStream",
212-
"request": {
213-
"$ref": "GoogleAdsSearchads360V0Services__SearchSearchAds360StreamRequest"
214-
},
215-
"response": {
216-
"$ref": "GoogleAdsSearchads360V0Services__SearchSearchAds360StreamResponse"
217-
},
218-
"scopes": [
219-
"https://www.googleapis.com/auth/doubleclicksearch"
220-
]
221193
}
222194
}
223195
}
@@ -271,7 +243,7 @@
271243
}
272244
}
273245
},
274-
"revision": "20230405",
246+
"revision": "20230504",
275247
"rootUrl": "https://searchads360.googleapis.com/",
276248
"schemas": {
277249
"GoogleAdsSearchads360V0Common__AgeRangeInfo": {
@@ -388,6 +360,21 @@
388360
},
389361
"type": "object"
390362
},
363+
"GoogleAdsSearchads360V0Common__Keyword": {
364+
"description": "A Keyword criterion segment.",
365+
"id": "GoogleAdsSearchads360V0Common__Keyword",
366+
"properties": {
367+
"adGroupCriterion": {
368+
"description": "The AdGroupCriterion resource name.",
369+
"type": "string"
370+
},
371+
"info": {
372+
"$ref": "GoogleAdsSearchads360V0Common__KeywordInfo",
373+
"description": "Keyword info."
374+
}
375+
},
376+
"type": "object"
377+
},
391378
"GoogleAdsSearchads360V0Common__KeywordInfo": {
392379
"description": "A keyword criterion.",
393380
"id": "GoogleAdsSearchads360V0Common__KeywordInfo",
@@ -999,6 +986,124 @@
999986
},
1000987
"type": "object"
1001988
},
989+
"GoogleAdsSearchads360V0Common__SearchAds360ExpandedDynamicSearchAdInfo": {
990+
"description": "An expanded dynamic search ad.",
991+
"id": "GoogleAdsSearchads360V0Common__SearchAds360ExpandedDynamicSearchAdInfo",
992+
"properties": {
993+
"adTrackingId": {
994+
"description": "The tracking id of the ad.",
995+
"format": "int64",
996+
"type": "string"
997+
},
998+
"description1": {
999+
"description": "The first line of the ad's description.",
1000+
"type": "string"
1001+
},
1002+
"description2": {
1003+
"description": "The second line of the ad's description.",
1004+
"type": "string"
1005+
}
1006+
},
1007+
"type": "object"
1008+
},
1009+
"GoogleAdsSearchads360V0Common__SearchAds360ExpandedTextAdInfo": {
1010+
"description": "A Search Ads 360 expanded text ad.",
1011+
"id": "GoogleAdsSearchads360V0Common__SearchAds360ExpandedTextAdInfo",
1012+
"properties": {
1013+
"adTrackingId": {
1014+
"description": "The tracking id of the ad.",
1015+
"format": "int64",
1016+
"type": "string"
1017+
},
1018+
"description1": {
1019+
"description": "The first line of the ad's description.",
1020+
"type": "string"
1021+
},
1022+
"description2": {
1023+
"description": "The second line of the ad's description.",
1024+
"type": "string"
1025+
},
1026+
"headline": {
1027+
"description": "The headline of the ad.",
1028+
"type": "string"
1029+
},
1030+
"headline2": {
1031+
"description": "The second headline of the ad.",
1032+
"type": "string"
1033+
},
1034+
"headline3": {
1035+
"description": "The third headline of the ad.",
1036+
"type": "string"
1037+
},
1038+
"path1": {
1039+
"description": "Text appended to the auto-generated visible URL with a delimiter.",
1040+
"type": "string"
1041+
},
1042+
"path2": {
1043+
"description": "Text appended to path1 with a delimiter.",
1044+
"type": "string"
1045+
}
1046+
},
1047+
"type": "object"
1048+
},
1049+
"GoogleAdsSearchads360V0Common__SearchAds360ProductAdInfo": {
1050+
"description": "A Search Ads 360 product ad.",
1051+
"id": "GoogleAdsSearchads360V0Common__SearchAds360ProductAdInfo",
1052+
"properties": {},
1053+
"type": "object"
1054+
},
1055+
"GoogleAdsSearchads360V0Common__SearchAds360ResponsiveSearchAdInfo": {
1056+
"description": "A Search Ads 360 responsive search ad.",
1057+
"id": "GoogleAdsSearchads360V0Common__SearchAds360ResponsiveSearchAdInfo",
1058+
"properties": {
1059+
"adTrackingId": {
1060+
"description": "The tracking id of the ad.",
1061+
"format": "int64",
1062+
"type": "string"
1063+
},
1064+
"path1": {
1065+
"description": "Text appended to the auto-generated visible URL with a delimiter.",
1066+
"type": "string"
1067+
},
1068+
"path2": {
1069+
"description": "Text appended to path1 with a delimiter.",
1070+
"type": "string"
1071+
}
1072+
},
1073+
"type": "object"
1074+
},
1075+
"GoogleAdsSearchads360V0Common__SearchAds360TextAdInfo": {
1076+
"description": "A Search Ads 360 text ad.",
1077+
"id": "GoogleAdsSearchads360V0Common__SearchAds360TextAdInfo",
1078+
"properties": {
1079+
"adTrackingId": {
1080+
"description": "The tracking id of the ad.",
1081+
"format": "int64",
1082+
"type": "string"
1083+
},
1084+
"description1": {
1085+
"description": "The first line of the ad's description.",
1086+
"type": "string"
1087+
},
1088+
"description2": {
1089+
"description": "The second line of the ad's description.",
1090+
"type": "string"
1091+
},
1092+
"displayMobileUrl": {
1093+
"description": "The displayed mobile URL of the ad.",
1094+
"type": "string"
1095+
},
1096+
"displayUrl": {
1097+
"description": "The displayed URL of the ad.",
1098+
"type": "string"
1099+
},
1100+
"headline": {
1101+
"description": "The headline of the ad.",
1102+
"type": "string"
1103+
}
1104+
},
1105+
"type": "object"
1106+
},
10021107
"GoogleAdsSearchads360V0Common__Segments": {
10031108
"description": "Segment only fields.",
10041109
"id": "GoogleAdsSearchads360V0Common__Segments",
@@ -1119,6 +1224,10 @@
11191224
],
11201225
"type": "string"
11211226
},
1227+
"keyword": {
1228+
"$ref": "GoogleAdsSearchads360V0Common__Keyword",
1229+
"description": "Keyword criterion."
1230+
},
11221231
"month": {
11231232
"description": "Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.",
11241233
"type": "string"
@@ -2255,6 +2364,14 @@
22552364
"description": "The URL that appears in the ad description for some ad formats.",
22562365
"type": "string"
22572366
},
2367+
"expandedDynamicSearchAd": {
2368+
"$ref": "GoogleAdsSearchads360V0Common__SearchAds360ExpandedDynamicSearchAdInfo",
2369+
"description": "Immutable. Details pertaining to an expanded dynamic search ad."
2370+
},
2371+
"expandedTextAd": {
2372+
"$ref": "GoogleAdsSearchads360V0Common__SearchAds360ExpandedTextAdInfo",
2373+
"description": "Immutable. Details pertaining to an expanded text ad."
2374+
},
22582375
"finalUrls": {
22592376
"description": "The list of possible final URLs after all cross-domain redirects for the ad.",
22602377
"items": {
@@ -2272,10 +2389,22 @@
22722389
"description": "Immutable. The name of the ad. This is only used to be able to identify the ad. It does not need to be unique and does not affect the served ad. The name field is currently only supported for DisplayUploadAd, ImageAd, ShoppingComparisonListingAd and VideoAd.",
22732390
"type": "string"
22742391
},
2392+
"productAd": {
2393+
"$ref": "GoogleAdsSearchads360V0Common__SearchAds360ProductAdInfo",
2394+
"description": "Immutable. Details pertaining to a product ad."
2395+
},
22752396
"resourceName": {
22762397
"description": "Immutable. The resource name of the ad. Ad resource names have the form: `customers/{customer_id}/ads/{ad_id}`",
22772398
"type": "string"
22782399
},
2400+
"responsiveSearchAd": {
2401+
"$ref": "GoogleAdsSearchads360V0Common__SearchAds360ResponsiveSearchAdInfo",
2402+
"description": "Immutable. Details pertaining to a responsive search ad."
2403+
},
2404+
"textAd": {
2405+
"$ref": "GoogleAdsSearchads360V0Common__SearchAds360TextAdInfo",
2406+
"description": "Immutable. Details pertaining to a text ad."
2407+
},
22792408
"type": {
22802409
"description": "Output only. The type of ad.",
22812410
"enum": [
@@ -2822,7 +2951,8 @@
28222951
},
28232952
"location": {
28242953
"$ref": "GoogleAdsSearchads360V0Common__LocationInfo",
2825-
"description": "Immutable. Location."
2954+
"description": "Output only. Location.",
2955+
"readOnly": true
28262956
},
28272957
"negative": {
28282958
"description": "Immutable. Whether to target (`false`) or exclude (`true`) the criterion. This field is immutable. To switch a criterion from positive to negative, remove then re-add it.",
@@ -3442,7 +3572,7 @@
34423572
"The asset is linked for use as a Promotion extension.",
34433573
"The asset is linked for use as a Callout extension.",
34443574
"The asset is linked for use as a Structured Snippet extension.",
3445-
"The asset is linked for use as a Sitelink extension.",
3575+
"The asset is linked for use as a Sitelink.",
34463576
"The asset is linked for use as a Mobile App extension.",
34473577
"The asset is linked for use as a Hotel Callout extension.",
34483578
"The asset is linked for use as a Call extension.",
@@ -5141,74 +5271,6 @@
51415271
}
51425272
},
51435273
"type": "object"
5144-
},
5145-
"GoogleAdsSearchads360V0Services__SearchSearchAds360StreamRequest": {
5146-
"description": "Request message for SearchAds360Service.SearchStream.",
5147-
"id": "GoogleAdsSearchads360V0Services__SearchSearchAds360StreamRequest",
5148-
"properties": {
5149-
"batchSize": {
5150-
"description": "The number of rows that are returned in each stream response batch. When too large batch is requested, the server may decide to further limit the number of returned rows.",
5151-
"format": "int32",
5152-
"type": "integer"
5153-
},
5154-
"query": {
5155-
"description": "Required. The query string.",
5156-
"type": "string"
5157-
},
5158-
"summaryRowSetting": {
5159-
"description": "Determines whether a summary row will be returned. By default, summary row is not returned. If requested, the summary row will be sent in a response by itself after all other query results are returned.",
5160-
"enum": [
5161-
"UNSPECIFIED",
5162-
"UNKNOWN",
5163-
"NO_SUMMARY_ROW",
5164-
"SUMMARY_ROW_WITH_RESULTS",
5165-
"SUMMARY_ROW_ONLY"
5166-
],
5167-
"enumDescriptions": [
5168-
"Not specified.",
5169-
"Represent unknown values of return summary row.",
5170-
"Do not return summary row.",
5171-
"Return summary row along with results. The summary row will be returned in the last batch alone (last batch will contain no results).",
5172-
"Return summary row only and return no results."
5173-
],
5174-
"type": "string"
5175-
}
5176-
},
5177-
"type": "object"
5178-
},
5179-
"GoogleAdsSearchads360V0Services__SearchSearchAds360StreamResponse": {
5180-
"description": "Response message for SearchAds360Service.SearchStream.",
5181-
"id": "GoogleAdsSearchads360V0Services__SearchSearchAds360StreamResponse",
5182-
"properties": {
5183-
"customColumnHeaders": {
5184-
"description": "The headers of the custom columns in the results.",
5185-
"items": {
5186-
"$ref": "GoogleAdsSearchads360V0Services__CustomColumnHeader"
5187-
},
5188-
"type": "array"
5189-
},
5190-
"fieldMask": {
5191-
"description": "FieldMask that represents what fields were requested by the user.",
5192-
"format": "google-fieldmask",
5193-
"type": "string"
5194-
},
5195-
"requestId": {
5196-
"description": "The unique id of the request that is used for debugging purposes.",
5197-
"type": "string"
5198-
},
5199-
"results": {
5200-
"description": "The list of rows that matched the query.",
5201-
"items": {
5202-
"$ref": "GoogleAdsSearchads360V0Services__SearchAds360Row"
5203-
},
5204-
"type": "array"
5205-
},
5206-
"summaryRow": {
5207-
"$ref": "GoogleAdsSearchads360V0Services__SearchAds360Row",
5208-
"description": "Summary row that contains summary of metrics in results. Summary of metrics means aggregation of metrics across all results, here aggregation could be sum, average, rate, etc."
5209-
}
5210-
},
5211-
"type": "object"
52125274
}
52135275
},
52145276
"servicePath": "",

0 commit comments

Comments
 (0)
Please sign in to comment.