|
260 | 260 | }
|
261 | 261 | }
|
262 | 262 | },
|
263 |
| - "revision": "20240429", |
| 263 | + "revision": "20240822", |
264 | 264 | "rootUrl": "https://searchads360.googleapis.com/",
|
265 | 265 | "schemas": {
|
266 | 266 | "GoogleAdsSearchads360V0Common__AdScheduleInfo": {
|
|
346 | 346 | },
|
347 | 347 | "type": "object"
|
348 | 348 | },
|
| 349 | + "GoogleAdsSearchads360V0Common__AdTextAsset": { |
| 350 | + "description": "A text asset used inside an ad.", |
| 351 | + "id": "GoogleAdsSearchads360V0Common__AdTextAsset", |
| 352 | + "properties": { |
| 353 | + "text": { |
| 354 | + "description": "Asset text.", |
| 355 | + "type": "string" |
| 356 | + } |
| 357 | + }, |
| 358 | + "type": "object" |
| 359 | + }, |
349 | 360 | "GoogleAdsSearchads360V0Common__AgeRangeInfo": {
|
350 | 361 | "description": "An age range criterion.",
|
351 | 362 | "id": "GoogleAdsSearchads360V0Common__AgeRangeInfo",
|
|
1012 | 1023 | "format": "double",
|
1013 | 1024 | "type": "number"
|
1014 | 1025 | },
|
| 1026 | + "averageQualityScore": { |
| 1027 | + "description": "The average quality score.", |
| 1028 | + "format": "double", |
| 1029 | + "type": "number" |
| 1030 | + }, |
1015 | 1031 | "clicks": {
|
1016 | 1032 | "description": "The number of clicks.",
|
1017 | 1033 | "format": "int64",
|
|
1540 | 1556 | "format": "int64",
|
1541 | 1557 | "type": "string"
|
1542 | 1558 | },
|
| 1559 | + "descriptions": { |
| 1560 | + "description": "List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.", |
| 1561 | + "items": { |
| 1562 | + "$ref": "GoogleAdsSearchads360V0Common__AdTextAsset" |
| 1563 | + }, |
| 1564 | + "type": "array" |
| 1565 | + }, |
| 1566 | + "headlines": { |
| 1567 | + "description": "List of text assets for headlines. When the ad serves the headlines will be selected from this list.", |
| 1568 | + "items": { |
| 1569 | + "$ref": "GoogleAdsSearchads360V0Common__AdTextAsset" |
| 1570 | + }, |
| 1571 | + "type": "array" |
| 1572 | + }, |
1543 | 1573 | "path1": {
|
1544 | 1574 | "description": "Text appended to the auto-generated visible URL with a delimiter.",
|
1545 | 1575 | "type": "string"
|
|
1738 | 1768 | ],
|
1739 | 1769 | "type": "string"
|
1740 | 1770 | },
|
| 1771 | + "geoTargetCity": { |
| 1772 | + "description": "Resource name of the geo target constant that represents a city.", |
| 1773 | + "type": "string" |
| 1774 | + }, |
| 1775 | + "geoTargetCountry": { |
| 1776 | + "description": "Resource name of the geo target constant that represents a country.", |
| 1777 | + "type": "string" |
| 1778 | + }, |
| 1779 | + "geoTargetMetro": { |
| 1780 | + "description": "Resource name of the geo target constant that represents a metro.", |
| 1781 | + "type": "string" |
| 1782 | + }, |
| 1783 | + "geoTargetRegion": { |
| 1784 | + "description": "Resource name of the geo target constant that represents a region.", |
| 1785 | + "type": "string" |
| 1786 | + }, |
| 1787 | + "hour": { |
| 1788 | + "description": "Hour of day as a number between 0 and 23, inclusive.", |
| 1789 | + "format": "int32", |
| 1790 | + "type": "integer" |
| 1791 | + }, |
1741 | 1792 | "keyword": {
|
1742 | 1793 | "$ref": "GoogleAdsSearchads360V0Common__Keyword",
|
1743 | 1794 | "description": "Keyword criterion."
|
|
2144 | 2195 | },
|
2145 | 2196 | "targetSpendMicros": {
|
2146 | 2197 | "deprecated": true,
|
2147 |
| - "description": "The spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details.", |
| 2198 | + "description": "Deprecated: The spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details.", |
2148 | 2199 | "format": "int64",
|
2149 | 2200 | "type": "string"
|
2150 | 2201 | }
|
|
2181 | 2232 | "id": "GoogleAdsSearchads360V0Common__TextLabel",
|
2182 | 2233 | "properties": {
|
2183 | 2234 | "backgroundColor": {
|
2184 |
| - "description": "Background color of the label in RGB format. This string must match the regular expression '^\\#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Note: The background color may not be visible for manager accounts.", |
| 2235 | + "description": "Background color of the label in HEX format. This string must match the regular expression '^\\#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Note: The background color may not be visible for manager accounts.", |
2185 | 2236 | "type": "string"
|
2186 | 2237 | },
|
2187 | 2238 | "description": {
|
|
3032 | 3083 | "type": "object"
|
3033 | 3084 | },
|
3034 | 3085 | "GoogleAdsSearchads360V0Errors__SearchAds360Error": {
|
3035 |
| - "description": "SearchAds360-specific error.", |
| 3086 | + "description": "Search Ads 360-specific error.", |
3036 | 3087 | "id": "GoogleAdsSearchads360V0Errors__SearchAds360Error",
|
3037 | 3088 | "properties": {
|
3038 | 3089 | "details": {
|
|
3893 | 3944 | "DISCOVERY_MULTI_ASSET_AD",
|
3894 | 3945 | "DISCOVERY_CAROUSEL_AD",
|
3895 | 3946 | "TRAVEL_AD",
|
3896 |
| - "DISCOVERY_VIDEO_RESPONSIVE_AD" |
| 3947 | + "DISCOVERY_VIDEO_RESPONSIVE_AD", |
| 3948 | + "MULTIMEDIA_AD" |
3897 | 3949 | ],
|
3898 | 3950 | "enumDescriptions": [
|
3899 | 3951 | "No value has been specified.",
|
|
3929 | 3981 | "Discovery multi asset ad.",
|
3930 | 3982 | "Discovery carousel ad.",
|
3931 | 3983 | "Travel ad.",
|
3932 |
| - "Discovery video responsive ad." |
| 3984 | + "Discovery video responsive ad.", |
| 3985 | + "Multimedia ad." |
3933 | 3986 | ],
|
3934 | 3987 | "readOnly": true,
|
3935 | 3988 | "type": "string"
|
|
4145 | 4198 | "type": "string"
|
4146 | 4199 | },
|
4147 | 4200 | "engineId": {
|
4148 |
| - "description": "Output only. ID of the ad in the external engine account. This field is for SearchAds 360 account only, for example, Yahoo Japan, Microsoft, Baidu etc. For non-SearchAds 360 entity, use \"ad_group_ad.ad.id\" instead.", |
| 4201 | + "description": "Output only. ID of the ad in the external engine account. This field is for Search Ads 360 account only, for example, Yahoo Japan, Microsoft, Baidu etc. For non-Search Ads 360 entity, use \"ad_group_ad.ad.id\" instead.", |
4149 | 4202 | "readOnly": true,
|
4150 | 4203 | "type": "string"
|
4151 | 4204 | },
|
|
4267 | 4320 | "description": "Immutable. The label assigned to the ad group ad.",
|
4268 | 4321 | "type": "string"
|
4269 | 4322 | },
|
| 4323 | + "ownerCustomerId": { |
| 4324 | + "description": "Output only. The ID of the Customer which owns the label.", |
| 4325 | + "format": "int64", |
| 4326 | + "readOnly": true, |
| 4327 | + "type": "string" |
| 4328 | + }, |
4270 | 4329 | "resourceName": {
|
4271 | 4330 | "description": "Immutable. The resource name of the ad group ad label. Ad group ad label resource names have the form: `customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}`",
|
4272 | 4331 | "type": "string"
|
|
4689 | 4748 | "description": "Immutable. The label assigned to the ad group criterion.",
|
4690 | 4749 | "type": "string"
|
4691 | 4750 | },
|
| 4751 | + "ownerCustomerId": { |
| 4752 | + "description": "Output only. The ID of the Customer which owns the label.", |
| 4753 | + "format": "int64", |
| 4754 | + "readOnly": true, |
| 4755 | + "type": "string" |
| 4756 | + }, |
4692 | 4757 | "resourceName": {
|
4693 | 4758 | "description": "Immutable. The resource name of the ad group criterion label. Ad group criterion label resource names have the form: `customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}`",
|
4694 | 4759 | "type": "string"
|
|
4708 | 4773 | "description": "Immutable. The label assigned to the ad group.",
|
4709 | 4774 | "type": "string"
|
4710 | 4775 | },
|
| 4776 | + "ownerCustomerId": { |
| 4777 | + "description": "Output only. The ID of the Customer which owns the label.", |
| 4778 | + "format": "int64", |
| 4779 | + "readOnly": true, |
| 4780 | + "type": "string" |
| 4781 | + }, |
4711 | 4782 | "resourceName": {
|
4712 | 4783 | "description": "Immutable. The resource name of the ad group label. Ad group label resource names have the form: `customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}`",
|
4713 | 4784 | "type": "string"
|
|
5512 | 5583 | "VIDEO_SEQUENCE",
|
5513 | 5584 | "APP_CAMPAIGN_FOR_PRE_REGISTRATION",
|
5514 | 5585 | "VIDEO_REACH_TARGET_FREQUENCY",
|
5515 |
| - "TRAVEL_ACTIVITIES" |
| 5586 | + "TRAVEL_ACTIVITIES", |
| 5587 | + "SOCIAL_FACEBOOK_TRACKING_ONLY" |
5516 | 5588 | ],
|
5517 | 5589 | "enumDescriptions": [
|
5518 | 5590 | "Not specified.",
|
|
5535 | 5607 | "Video campaigns with sequence video ads.",
|
5536 | 5608 | "App Campaign for pre registration, specialized for advertising mobile app pre-registration, that targets multiple advertising channels across Google Play, YouTube and Display Network.",
|
5537 | 5609 | "Video reach campaign with Target Frequency bidding strategy.",
|
5538 |
| - "Travel Activities campaigns." |
| 5610 | + "Travel Activities campaigns.", |
| 5611 | + "Facebook tracking only social campaigns." |
5539 | 5612 | ],
|
5540 | 5613 | "type": "string"
|
5541 | 5614 | },
|
|
5555 | 5628 | "PERFORMANCE_MAX",
|
5556 | 5629 | "LOCAL_SERVICES",
|
5557 | 5630 | "DISCOVERY",
|
5558 |
| - "TRAVEL" |
| 5631 | + "TRAVEL", |
| 5632 | + "SOCIAL" |
5559 | 5633 | ],
|
5560 | 5634 | "enumDescriptions": [
|
5561 | 5635 | "Not specified.",
|
|
5571 | 5645 | "Performance Max campaigns.",
|
5572 | 5646 | "Local services campaigns.",
|
5573 | 5647 | "Discovery campaigns.",
|
5574 |
| - "Travel campaigns." |
| 5648 | + "Travel campaigns.", |
| 5649 | + "Social campaigns." |
5575 | 5650 | ],
|
5576 | 5651 | "type": "string"
|
5577 | 5652 | },
|
|
6288 | 6363 | "description": "Immutable. The label assigned to the campaign.",
|
6289 | 6364 | "type": "string"
|
6290 | 6365 | },
|
| 6366 | + "ownerCustomerId": { |
| 6367 | + "description": "Output only. The ID of the Customer which owns the label.", |
| 6368 | + "format": "int64", |
| 6369 | + "readOnly": true, |
| 6370 | + "type": "string" |
| 6371 | + }, |
6291 | 6372 | "resourceName": {
|
6292 | 6373 | "description": "Immutable. Name of the resource. Campaign label resource names have the form: `customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}`",
|
6293 | 6374 | "type": "string"
|
|
6470 | 6551 | "type": "string"
|
6471 | 6552 | },
|
6472 | 6553 | "merchantId": {
|
6473 |
| - "description": "Output only. The SearchAds360 inventory account ID containing the product that was clicked on. SearchAds360 generates this ID when you link an inventory account in SearchAds360.", |
| 6554 | + "description": "Output only. The Search Ads 360 inventory account ID containing the product that was clicked on. Search Ads 360 generates this ID when you link an inventory account in Search Ads 360.", |
6474 | 6555 | "format": "int64",
|
6475 | 6556 | "readOnly": true,
|
6476 | 6557 | "type": "string"
|
|
6535 | 6616 | "type": "string"
|
6536 | 6617 | },
|
6537 | 6618 | "visitId": {
|
6538 |
| - "description": "Output only. The SearchAds360 visit ID that the conversion is attributed to.", |
| 6619 | + "description": "Output only. The Search Ads 360 visit ID that the conversion is attributed to.", |
6539 | 6620 | "format": "int64",
|
6540 | 6621 | "readOnly": true,
|
6541 | 6622 | "type": "string"
|
|
6979 | 7060 | "readOnly": true,
|
6980 | 7061 | "type": "boolean"
|
6981 | 7062 | },
|
| 7063 | + "renderType": { |
| 7064 | + "description": "Output only. How the result value of the custom column should be interpreted.", |
| 7065 | + "enum": [ |
| 7066 | + "UNSPECIFIED", |
| 7067 | + "UNKNOWN", |
| 7068 | + "NUMBER", |
| 7069 | + "PERCENT", |
| 7070 | + "MONEY", |
| 7071 | + "STRING", |
| 7072 | + "BOOLEAN", |
| 7073 | + "DATE" |
| 7074 | + ], |
| 7075 | + "enumDescriptions": [ |
| 7076 | + "Not specified.", |
| 7077 | + "Unknown.", |
| 7078 | + "The custom column is a raw numerical value. See value_type field to determine if it is an integer or a double.", |
| 7079 | + "The custom column should be multiplied by 100 to retrieve the percentage value.", |
| 7080 | + "The custom column value is a monetary value and is in micros.", |
| 7081 | + "The custom column value is a string.", |
| 7082 | + "The custom column value is a boolean.", |
| 7083 | + "The custom column value is a date represented as an integer in YYYYMMDD format." |
| 7084 | + ], |
| 7085 | + "readOnly": true, |
| 7086 | + "type": "string" |
| 7087 | + }, |
6982 | 7088 | "resourceName": {
|
6983 | 7089 | "description": "Immutable. The resource name of the custom column. Custom column resource names have the form: `customers/{customer_id}/customColumns/{custom_column_id}`",
|
6984 | 7090 | "type": "string"
|
|
6991 | 7097 | "STRING",
|
6992 | 7098 | "INT64",
|
6993 | 7099 | "DOUBLE",
|
6994 |
| - "BOOLEAN" |
| 7100 | + "BOOLEAN", |
| 7101 | + "DATE" |
6995 | 7102 | ],
|
6996 | 7103 | "enumDescriptions": [
|
6997 | 7104 | "Not specified.",
|
6998 | 7105 | "Unknown.",
|
6999 | 7106 | "The custom column value is a string.",
|
7000 | 7107 | "The custom column value is an int64 number.",
|
7001 | 7108 | "The custom column value is a double number.",
|
7002 |
| - "The custom column value is a boolean." |
| 7109 | + "The custom column value is a boolean.", |
| 7110 | + "The custom column value is a date, in YYYYMMDD format." |
7003 | 7111 | ],
|
7004 | 7112 | "readOnly": true,
|
7005 | 7113 | "type": "string"
|
|
7327 | 7435 | "description": "Immutable. Name of the resource. CustomerManagerLink resource names have the form: `customers/{customer_id}/customerManagerLinks/{manager_customer_id}~{manager_link_id}`",
|
7328 | 7436 | "type": "string"
|
7329 | 7437 | },
|
| 7438 | + "startTime": { |
| 7439 | + "description": "Output only. The timestamp when the CustomerManagerLink was created. The timestamp is in the customer's time zone and in \"yyyy-MM-dd HH:mm:ss\" format.", |
| 7440 | + "readOnly": true, |
| 7441 | + "type": "string" |
| 7442 | + }, |
7330 | 7443 | "status": {
|
7331 | 7444 | "description": "Status of the link between the customer and the manager.",
|
7332 | 7445 | "enum": [
|
|
0 commit comments