openapi-directory/api/googleapis.com/searchads360.json

Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS

{"openapi":"3.0.0","servers":[{"url":"https://searchads360.googleapis.com/"}],"info":{"contact":{"name":"Google","url":"https://google.com","x-twitter":"youtube"},"description":"The Search Ads 360 API allows developers to automate downloading reports from Search Ads 360.","license":{"name":"Creative Commons Attribution 3.0","url":"http://creativecommons.org/licenses/by/3.0/"},"termsOfService":"https://developers.google.com/terms/","title":"Search Ads 360 Reporting API","version":"v0","x-apisguru-categories":["analytics","media"],"x-logo":{"url":"https://upload.wikimedia.org/wikipedia/commons/e/e1/YouTube_play_buttom_icon_%282013-2017%29.svg"},"x-origin":[{"format":"google","url":"https://searchads360.googleapis.com/$discovery/rest?version=v0","version":"v1"}],"x-providerName":"googleapis.com","x-serviceName":"searchads360"},"externalDocs":{"url":"https://developers.google.com/search-ads/reporting"},"tags":[{"name":"customers"},{"name":"searchAds360Fields"}],"paths":{"/v0/customers/{customerId}/customColumns":{"get":{"description":"Returns all the custom columns associated with the customer in full detail.","operationId":"searchads360.customers.customColumns.list","parameters":[{"description":"Required. The ID of the customer to apply the CustomColumn list operation to.","in":"path","name":"customerId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleAdsSearchads360V0Services__ListCustomColumnsResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/doubleclicksearch"],"Oauth2c":["https://www.googleapis.com/auth/doubleclicksearch"]}],"tags":["customers"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v0/customers/{customerId}/searchAds360:search":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Returns all rows that match the search query. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [HeaderError]() [InternalError]() [QueryError]() [QuotaError]() [RequestError]()","operationId":"searchads360.customers.searchAds360.search","parameters":[{"description":"Required. The ID of the customer being queried.","in":"path","name":"customerId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleAdsSearchads360V0Services__SearchSearchAds360Request"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleAdsSearchads360V0Services__SearchSearchAds360Response"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/doubleclicksearch"],"Oauth2c":["https://www.googleapis.com/auth/doubleclicksearch"]}],"tags":["customers"]}},"/v0/customers:listAccessibleCustomers":{"get":{"description":"Returns resource names of customers directly accessible by the user authenticating the call. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [HeaderError]() [InternalError]() [QuotaError]() [RequestError]()","operationId":"searchads360.customers.listAccessibleCustomers","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleAdsSearchads360V0Services__ListAccessibleCustomersResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/doubleclicksearch"],"Oauth2c":["https://www.googleapis.com/auth/doubleclicksearch"]}],"tags":["customers"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v0/searchAds360Fields:search":{"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Returns all fields that match the search query. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [HeaderError]() [InternalError]() [QueryError]() [QuotaError]() [RequestError]()","operationId":"searchads360.searchAds360Fields.search","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleAdsSearchads360V0Services__SearchSearchAds360FieldsRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleAdsSearchads360V0Services__SearchSearchAds360FieldsResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/doubleclicksearch"],"Oauth2c":["https://www.googleapis.com/auth/doubleclicksearch"]}],"tags":["searchAds360Fields"]}},"/v0/{resourceName}":{"get":{"description":"Returns just the requested field. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [HeaderError]() [InternalError]() [QuotaError]() [RequestError]()","operationId":"searchads360.searchAds360Fields.get","parameters":[{"description":"Required. The resource name of the field to get.","in":"path","name":"resourceName","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleAdsSearchads360V0Resources__SearchAds360Field"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/doubleclicksearch"],"Oauth2c":["https://www.googleapis.com/auth/doubleclicksearch"]}],"tags":["searchAds360Fields"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]}},"components":{"parameters":{"_.xgafv":{"description":"V1 error format.","in":"query","name":"$.xgafv","schema":{"enum":["1","2"],"type":"string"}},"access_token":{"description":"OAuth access token.","in":"query","name":"access_token","schema":{"type":"string"}},"alt":{"description":"Data format for response.","in":"query","name":"alt","schema":{"enum":["json","media","proto"],"type":"string"}},"callback":{"description":"JSONP","in":"query","name":"callback","schema":{"type":"string"}},"fields":{"description":"Selector specifying which fields to include in a partial response.","in":"query","name":"fields","schema":{"type":"string"}},"key":{"description":"API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.","in":"query","name":"key","schema":{"type":"string"}},"oauth_token":{"description":"OAuth 2.0 token for the current user.","in":"query","name":"oauth_token","schema":{"type":"string"}},"prettyPrint":{"description":"Returns response with indentations and line breaks.","in":"query","name":"prettyPrint","schema":{"type":"boolean"}},"quotaUser":{"description":"Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.","in":"query","name":"quotaUser","schema":{"type":"string"}},"uploadType":{"description":"Legacy upload protocol for media (e.g. \"media\", \"multipart\").","in":"query","name":"uploadType","schema":{"type":"string"}},"upload_protocol":{"description":"Upload protocol for media (e.g. \"raw\", \"multipart\").","in":"query","name":"upload_protocol","schema":{"type":"string"}}},"schemas":{"GoogleAdsSearchads360V0Common__AdScheduleInfo":{"description":"Represents an AdSchedule criterion. AdSchedule is specified as the day of the week and a time interval within which ads will be shown. No more than six AdSchedules can be added for the same day.","properties":{"dayOfWeek":{"description":"Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations.","enum":["UNSPECIFIED","UNKNOWN","MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"],"type":"string"},"endHour":{"description":"Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.","format":"int32","type":"integer"},"endMinute":{"description":"Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations.","enum":["UNSPECIFIED","UNKNOWN","ZERO","FIFTEEN","THIRTY","FORTY_FIVE"],"type":"string"},"startHour":{"description":"Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations.","format":"int32","type":"integer"},"startMinute":{"description":"Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations.","enum":["UNSPECIFIED","UNKNOWN","ZERO","FIFTEEN","THIRTY","FORTY_FIVE"],"type":"string"}},"type":"object"},"GoogleAdsSearchads360V0Common__AgeRangeInfo":{"description":"An age range criterion.","properties":{"type":{"description":"Type of the age range.","enum":["UNSPECIFIED","UNKNOWN","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"],"type":"string"}},"type":"object"},"GoogleAdsSearchads360V0Common__AssetInteractionTarget":{"description":"An AssetInteractionTarget segment.","properties":{"asset":{"description":"The asset resource name.","type":"string"},"interactionOnThisAsset":{"description":"Only used with CustomerAsset, CampaignAsset and AdGroupAsset metrics. Indicates whether the interaction metrics occurred on the asset itself or a different asset or ad unit.","type":"boolean"}},"type":"object"},"GoogleAdsSearchads360V0Common__AssetUsage":{"description":"Contains the usage information of the asset.","properties":{"asset":{"description":"Resource name of the asset.","type":"string"},"servedAssetFieldType":{"description":"The served field type of the asset.","enum":["UNSPECIFIED","UNKNOWN","HEADLINE_1","HEADLINE_2","HEADLINE_3","DESCRIPTION_1","DESCRIPTION_2","HEADLINE","HEADLINE_IN_PORTRAIT","LONG_HEADLINE","DESCRIPTION","DESCRIPTION_IN_PORTRAIT","BUSINESS_NAME_IN_PORTRAIT","BUSINESS_NAME","MARKETING_IMAGE","MARKETING_IMAGE_IN_PORTRAIT","SQUARE_MARKETING_IMAGE","PORTRAIT_MARKETING_IMAGE","LOGO","LANDSCAPE_LOGO","CALL_TO_ACTION","YOU_TUBE_VIDEO","SITELINK","CALL","MOBILE_APP","CALLOUT","STRUCTURED_SNIPPET","PRICE","PROMOTION","AD_IMAGE","LEAD_FORM","BUSINESS_LOGO"],"type":"string"}},"type":"object"},"GoogleAdsSearchads360V0Common__AudienceInfo":{"description":"An audience criterion.","properties":{"audience":{"description":"The Audience resource name.","type":"string"}},"type":"object"},"GoogleAdsSearchads360V0Common__BusinessProfileLocation":{"description":"Business Profile location data synced from the linked Business Profile account.","properties":{"labels":{"description":"Advertiser specified label for the location on the Business Profile account. This is synced from the Business Profile account.","items":{"type":"string"},"type":"array"},"listingId":{"description":"Listing ID of this Business Profile location. This is synced from the linked Business Profile account.","format":"int64","type":"string"},"storeCode":{"description":"Business Profile store code of this location. This is synced from the Business Profile account.","type":"string"}},"type":"object"},"GoogleAdsSearchads360V0Common__CallToActionAsset":{"description":"A call to action asset.","properties":{"callToAction":{"description":"Call to action.","enum":["UNSPECIFIED","UNKNOWN","LEARN_MORE","GET_QUOTE","APPLY_NOW","SIGN_UP","CONTACT_US","SUBSCRIBE","DOWNLOAD","BOOK_NOW","SHOP_NOW","BUY_NOW","DONATE_NOW","ORDER_NOW","PLAY_NOW","SEE_MORE","START_NOW","VISIT_SITE","WATCH_NOW"],"type":"string"}},"type":"object"},"GoogleAdsSearchads360V0Common__CustomParameter":{"description":"A mapping that can be used by custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`.","properties":{"key":{"description":"The key matching the parameter tag name.","type":"string"},"value":{"description":"The value to be substituted.","type":"string"}},"type":"object"},"GoogleAdsSearchads360V0Common__DeviceInfo":{"description":"A device criterion.","properties":{"type":{"description":"Type of the device.","enum":["UNSPECIFIED","UNKNOWN","MOBILE","TABLET","DESKTOP","CONNECTED_TV","OTHER"],"type":"string"}},"type":"object"},"GoogleAdsSearchads360V0Common__EnhancedCpc":{"description":"An automated bidding strategy that raises bids for clicks that seem more likely to lead to a conversion and lowers them for clicks where they seem less likely. This bidding strategy is deprecated and cannot be created anymore. Use ManualCpc with enhanced_cpc_enabled set to true for equivalent functionality.","properties":{},"type":"object"},"GoogleAdsSearchads360V0Common__FrequencyCapEntry":{"description":"A rule specifying the maximum number of times an ad (or some set of ads) can be shown to a user over a particular time period.","properties":{},"type":"object"},"GoogleAdsSearchads360V0Common__GenderInfo":{"description":"A gender criterion.","properties":{"type":{"description":"Type of the gender.","enum":["UNSPECIFIED","UNKNOWN","MALE","FEMALE","UNDETERMINED"],"type":"string"}},"type":"object"},"GoogleAdsSearchads360V0Common__ImageAsset":{"description":"An Image asset.","properties":{"fileSize":{"description":"File size of the image asset in bytes.","format":"int64","type":"string"},"fullSize":{"$ref":"#/components/schemas/GoogleAdsSearchads360V0Common__ImageDimension","description":"Metadata for this image at its original size."},"mimeType":{"description":"MIME type of the image asset.","enum":["UNSPECIFIED","UNKNOWN","IMAGE_JPEG","IMAGE_GIF","IMAGE_PNG","FLASH","TEXT_HTML","PDF","MSWORD","MSEXCEL","RTF","AUDIO_WAV","AUDIO_MP3","HTML5_AD_ZIP"],"type":"string"}},"type":"object"},"GoogleAdsSearchads360V0Common__ImageDimension":{"description":"Metadata for an image at a certain size, either original or resized.","properties":{"heightPixels":{"description":"Height of the image.","format":"int64","type":"string"},"url":{"description":"A URL that returns the image with this height and width.","type":"string"},"widthPixels":{"description":"Width of the image.","format":"int64","type":"string"}},"type":"object"},"GoogleAdsSearchads360V0Common__Keyword":{"description":"A Keyword criterion segment.","properties":{"adGroupCriterion":{"description":"The AdGroupCriterion resource name.","type":"string"},"info":{"$ref":"#/components/schemas/GoogleAdsSearchads360V0Common__KeywordInfo","description":"Keyword info."}},"type":"object"},"GoogleAdsSearchads360V0Common__KeywordInfo":{"description":"A keyword criterion.","properties":{"matchType":{"description":"The match type of the keyword.","enum":["UNSPECIFIED","UNKNOWN","EXACT","PHRASE","BROAD"],"type":"string"},"text":{"description":"The text of the keyword (at most 80 characters and 10 words).","type":"string"}},"type":"object"},"GoogleAdsSearchads360V0Common__LanguageInfo":{"description":"A language criterion.","properties":{"languageConstant":{"description":"The language constant resource name.","type":"string"}},"type":"object"},"GoogleAdsSearchads360V0Common__ListingGroupInfo":{"description":"A listing group criterion.","properties":{"type":{"description":"Type of the listing group.","enum":["UNSPECIFIED","UNKNOWN","SUBDIVISION","UNIT"],"type":"string"}},"type":"object"},"GoogleAdsSearchads360V0Common__LocationGroupInfo":{"description":"A radius around a list of locations specified through a feed.","properties":{"feedItemSets":{"description":"FeedItemSets whose FeedItems are targeted. If multiple IDs are specified, then all items that appear in at least one set are targeted. This field cannot be used with geo_target_constants. This is optional and can only be set in CREATE operations.","items":{"type":"string"},"type":"array"},"geoTargetConstants":{"description":"Geo target constant(s) restricting the scope of the geographic area within the feed. Currently only one geo target constant is allowed.","items":{"type":"string"},"type":"array"},"radius":{"description":"Distance in units specifying the radius around targeted locations. This is required and must be set in CREATE operations.","format":"int64","type":"string"},"radiusUnits":{"description":"Unit of the radius. Miles and meters are supported for geo target constants. Milli miles and meters are supported for feed item sets. This is required and must be set in CREATE operations.","enum":["UNSPECIFIED","UNKNOWN","METERS","MILES","MILLI_MILES"],"type":"string"}},"type":"object"},"GoogleAdsSearchads360V0Common__LocationInfo":{"description":"A location criterion.","properties":{"geoTargetConstant":{"description":"The geo target constant resource name.","type":"string"}},"type":"object"},"GoogleAdsSearchads360V0Common__ManualCpa":{"description":"Manual bidding strategy that allows advertiser to set the bid per advertiser-specified action.","properties":{},"type":"object"},"GoogleAdsSearchads360V0Common__ManualCpc":{"description":"Manual click-based bidding where user pays per click.","properties":{"enhancedCpcEnabled":{"description":"Whether bids are to be enhanced based on conversion optimizer data.","type":"boolean"}},"type":"object"},"GoogleAdsSearchads360V0Common__ManualCpm":{"description":"Manual impression-based bidding where user pays per thousand impressions.","properties":{},"type":"object"},"GoogleAdsSearchads360V0Common__MaximizeConversionValue":{"description":"An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget.","properties":{"cpcBidCeilingMicros":{"description":"Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only.","format":"int64","type":"string"},"cpcBidFloorMicros":{"description":"Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only.","format":"int64","type":"string"},"targetRoas":{"description":"The target return on ad spend (ROAS) option. If set, the bid strategy will maximize revenue while averaging the target return on ad spend. If the target ROAS is high, the bid strategy may not be able to spend the full budget. If the target ROAS is not set, the bid strategy will aim to achieve the highest possible ROAS for the budget.","format":"double","type":"number"}},"type":"object"},"GoogleAdsSearchads360V0Common__MaximizeConversions":{"description":"An automated bidding strategy to help get the most conversions for your campaigns while spending your budget.","properties":{"cpcBidCeilingMicros":{"description":"Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only.","format":"int64","type":"string"},"cpcBidFloorMicros":{"description":"Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only.","format":"int64","type":"string"},"targetCpaMicros":{"description":"The target cost-per-action (CPA) option. This is the average amount that you would like to spend per conversion action specified in micro units of the bidding strategy's currency. If set, the bid strategy will get as many conversions as possible at or below the target cost-per-action. If the target CPA is not set, the bid strategy will aim to achieve the lowest possible CPA given the budget.","format":"int64","type":"string"}},"type":"object"},"GoogleAdsSearchads360V0Common__Metrics":{"description":"Metrics data.","properties":{"absoluteTopImpressionPercentage":{"description":"The percent of your ad impressions that are shown as the very first ad above the organic search results.","format":"double","type":"number"},"allConversions":{"description":"The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.","format":"double","type":"number"},"allConversionsByConversionDate":{"description":"The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611.","format":"double","type":"number"},"allConversionsFromClickToCall":{"description":"The number of times people clicked the \"Call\" button to call a store during or after clicking an ad. This number doesn't include whether or not calls were connected, or the duration of any calls. This metric applies to feed items only.","format":"double","type":"number"},"allConversionsFromDirections":{"description":"The number of times people clicked a \"Get directions\" button to navigate to a store after clicking an ad. This metric applies to feed items only.","format":"double","type":"number"},"allConversionsFromInteractionsRate":{"description":"All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions.","format":"double","type":"number"},"allConversionsFromInteractionsValuePerInteraction":{"description":"The value of all conversions from interactions divided by the total number of interactions.","format":"double","type":"number"},"allConversionsFromMenu":{"description":"The number of times people clicked a link to view a store's menu after clicking an ad. This metric applies to feed items only.","format":"double","type":"number"},"allConversionsFromOrder":{"description":"The number of times people placed an order at a store after clicking an ad. This metric applies to feed items only.","format":"double","type":"number"},"allConversionsFromOtherEngagement":{"description":"The number of other conversions (for example, posting a review or saving a location for a store) that occurred after people clicked an ad. This metric applies to feed items only.","format":"double","type":"number"},"allConversionsFromStoreVisit":{"description":"Estimated number of times people visited a store after clicking an ad. This metric applies to feed items only.","format":"double","type":"number"},"allConversionsFromStoreWebsite":{"description":"The number of times that people were taken to a store's URL after clicking an ad. This metric applies to feed items only.","format":"double","type":"number"},"allConversionsValue":{"description":"The value of all conversions.","format":"double","type":"number"},"allConversionsValueByConversionDate":{"description":"The value of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611.","format":"double","type":"number"},"allConversionsValuePerCost":{"description":"The value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads).","format":"double","type":"number"},"averageCost":{"description":"The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.","format":"double","type":"number"},"averageCpc":{"description":"The total cost of all clicks divided by the total number of clicks received. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause","format":"double","type":"number"},"averageCpm":{"description":"Average cost-per-thousand impressions (CPM). This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause","format":"double","type":"number"},"clicks":{"description":"The number of clicks.","format":"int64","type":"string"},"clientAccountConversions":{"description":"The number of client account conversions. This only includes conversion actions which include_in_client_account_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.","format":"double","type":"number"},"clientAccountConversionsValue":{"description":"The value of client account conversions. This only includes conversion actions which include_in_client_account_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.","format":"double","type":"number"},"clientAccountCrossSellCostOfGoodsSoldMicros":{"description":"Client account cross-sell cost of goods sold (COGS) is the total cost of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell cost of goods sold is the total cost of the products sold that weren't advertised. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause","format":"int64","type":"string"},"clientAccountCrossSellGrossProfitMicros":{"description":"Client account cross-sell gross profit is the profit you made from products sold as a result of advertising a different product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause","format":"int64","type":"string"},"clientAccountCrossSellRevenueMicros":{"description":"Client account cross-sell revenue is the total amount you made from products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell revenue is the total value you made from cross-sell attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The cross-sell revenue of this order is $20. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause","format":"int64","type":"string"},"clientAccountCrossSellUnitsSold":{"description":"Client account cross-sell units sold is the total number of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell units sold is the total number of cross-sold products from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The cross-sell units sold in this order is 2. This metric is only available if you report conversions with cart data.","format":"double","type":"number"},"clientAccountLeadCostOfGoodsSoldMicros":{"description":"Client account lead cost of goods sold (COGS) is the total cost of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the cost of these goods is counted under lead cost of goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The lead cost of goods sold for this order is $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause","format":"int64","type":"string"},"clientAccountLeadGrossProfitMicros":{"description":"Client account lead gross profit is the profit you made from products sold as a result of advertising the same product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the revenue you made from these sales minus the cost of goods sold is your lead gross profit. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and has a cost of goods sold value of $3. The lead gross profit of this order is $7 = $10 - $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause","format":"int64","type":"string"},"clientAccountLeadRevenueMicros":{"description":"Client account lead revenue is the total amount you made from products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total value you made from the sales of these products is shown under lead revenue. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The lead revenue of this order is $10. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause","format":"int64","type":"string"},"clientAccountLeadUnitsSold":{"description":"Client account lead units sold is the total number of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total number of these products sold is shown under lead units sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The lead units sold in this order is 1. This metric is only available if you report conversions with cart data.","format":"double","type":"number"},"clientAccountViewThroughConversions":{"description":"The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (for example, clicking on) another ad.","format":"int64","type":"string"},"contentBudgetLostImpressionShare":{"description":"The estimated percent of times that your ad was eligible to show on the Display Network but didn't because your budget was too low. Note: Content budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.","format":"double","type":"number"},"contentImpressionShare":{"description":"The impressions you've received on the Display Network divided by the estimated number of impressions you were eligible to receive. Note: Content impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.","format":"double","type":"number"},"contentRankLostImpressionShare":{"description":"The estimated percentage of impressions on the Display Network that your ads didn't receive due to poor Ad Rank. Note: Content rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.","format":"double","type":"number"},"conversionCustomMetrics":{"description":"The conversion custom metrics.","items":{"$ref":"#/components/schemas/GoogleAdsSearchads360V0Common__Value"},"type":"array"},"conversions":{"description":"The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.","format":"double","type":"number"},"conversionsByConversionDate":{"description":"The sum of conversions by conversion date for biddable conversion types. Can be fractional due to attribution modeling. When this column is selected with date, the values in date column means the conversion date.","format":"double","type":"number"},"conversionsFromInteractionsRate":{"description":"Average biddable conversions (from interaction) per conversion eligible interaction. Shows how often, on average, an ad interaction leads to a biddable conversion.","format":"double","type":"number"},"conversionsFromInteractionsValuePerInteraction":{"description":"The value of conversions from interactions divided by the number of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.","format":"double","type":"number"},"conversionsValue":{"description":"The sum of conversion values for the conversions included in the \"conversions\" field. This metric is useful only if you entered a value for your conversion actions.","format":"double","type":"number"},"conversionsValueByConversionDate":{"description":"The sum of biddable conversions value by conversion date. When this column is selected with date, the values in date column means the conversion date.","format":"double","type":"number"},"conversionsValuePerCost":{"description":"The value of biddable conversion divided by the total cost of conversion eligible interactions.","format":"double","type":"number"},"costMicros":{"description":"The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause","format":"int64","type":"string"},"costPerAllConversions":{"description":"The cost of ad interactions divided by all conversions.","format":"double","type":"number"},"costPerConversion":{"description":"Average conversion eligible cost per biddable conversion.","format":"double","type":"number"},"costPerCurrentModelAttributedConversion":{"description":"The cost of ad interactions divided by current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.","format":"double","type":"number"},"crossDeviceConversions":{"description":"Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all_conversions.","format":"double","type":"number"},"crossDeviceConversionsValue":{"description":"The sum of the value of cross-device conversions.","format":"double","type":"number"},"crossSellCostOfGoodsSoldMicros":{"description":"Cross-sell cost of goods sold (COGS) is the total cost of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell cost of goods sold is the total cost of the products sold that weren't advertised. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause","format":"int64","type":"string"},"crossSellGrossProfitMicros":{"description":"Cross-sell gross profit is the profit you made from products sold as a result of advertising a different product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause","format":"int64","type":"string"},"crossSellRevenueMicros":{"description":"Cross-sell revenue is the total amount you made from products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell revenue is the total value you made from cross-sell attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The cross-sell revenue of this order is $20. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause","format":"int64","type":"string"},"crossSellUnitsSold":{"description":"Cross-sell units sold is the total number of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell units sold is the total number of cross-sold products from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The cross-sell units sold in this order is 2. This metric is only available if you report conversions with cart data.","format":"double","type":"number"},"ctr":{"description":"The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).","format":"double","type":"number"},"historicalCreativeQualityScore":{"description":"The creative historical quality score.","enum":["UNSPECIFIED","UNKNOWN","BELOW_AVERAGE","AVERAGE","ABOVE_AVERAGE"],"type":"string"},"historicalLandingPageQualityScore":{"description":"The quality of historical landing page experience.","enum":["UNSPECIFIED","UNKNOWN","BELOW_AVERAGE","AVERAGE","ABOVE_AVERAGE"],"type":"string"},"historicalQualityScore":{"description":"The historical quality score.","format":"int64","type":"string"},"historicalSearchPredictedCtr":{"description":"The historical search predicted click through rate (CTR).","enum":["UNSPECIFIED","UNKNOWN","BELOW_AVERAGE","AVERAGE","ABOVE_AVERAGE"],"type":"string"},"impressions":{"description":"Count of how often your ad has appeared on a search results page or website on the Google Network.","format":"int64","type":"string"},"interactionEventTypes":{"description":"The types of payable and free interactions.","items":{"enum":["UNSPECIFIED","UNKNOWN","CLICK","ENGAGEMENT","VIDEO_VIEW","NONE"],"type":"string"},"type":"array"},"interactionRate":{"description":"How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.","format":"double","type":"number"},"interactions":{"description":"The number of interactions. An interaction is the main user action associated with an ad format-clicks for text and shopping ads, views for video ads, and so on.","format":"int64","type":"string"},"invalidClickRate":{"description":"The percentage of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period.","format":"double","type":"number"},"invalidClicks":{"description":"Number of clicks Google considers illegitimate and doesn't charge you for.","format":"int64","type":"string"},"leadCostOfGoodsSoldMicros":{"description":"Lead cost of goods sold (COGS) is the total cost of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the cost of these goods is counted under lead cost of goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The lead cost of goods sold for this order is $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause","format":"int64","type":"string"},"leadGrossProfitMicros":{"description":"Lead gross profit is the profit you made from products sold as a result of advertising the same product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the revenue you made from these sales minus the cost of goods sold is your lead gross profit. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and has a cost of goods sold value of $3. The lead gross profit of this order is $7 = $10 - $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause","format":"int64","type":"string"},"leadRevenueMicros":{"description":"Lead revenue is the total amount you made from products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total value you made from the sales of these products is shown under lead revenue. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The lead