google-ads-googleads 0.4.0 → 0.5.0

data/lib/google/ads/googleads/v0/services/doc/google/ads/googleads/v0/common/metrics.rb

@@ -1,208 +0,0 @@
-# Copyright 2018 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     https://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-module Google
-  module Ads
-    module Googleads
-      module V0
-        module Common
-          # Metrics data.
-          # @!attribute [rw] all_conversions_from_interactions_rate
-          #   @return [Google::Protobuf::DoubleValue]
-          #     All conversions from interactions (as oppose to view through conversions)
-          #     divided by the number of ad interactions.
-          # @!attribute [rw] all_conversions_value
-          #   @return [Google::Protobuf::DoubleValue]
-          #     The total value of all conversions.
-          # @!attribute [rw] all_conversions
-          #   @return [Google::Protobuf::DoubleValue]
-          #     The total number of conversions. This includes "Conversions" plus
-          #     conversions that have their "Include in Conversions" setting unchecked.
-          # @!attribute [rw] all_conversions_value_per_cost
-          #   @return [Google::Protobuf::DoubleValue]
-          #     The value of all conversions divided by the total cost of ad interactions
-          #     (such as clicks for text ads or views for video ads).
-          # @!attribute [rw] all_conversions_from_interactions_value_per_interaction
-          #   @return [Google::Protobuf::DoubleValue]
-          #     The value of all conversions from interactions divided by the total number
-          #     of interactions.
-          # @!attribute [rw] average_cost
-          #   @return [Google::Protobuf::DoubleValue]
-          #     The average amount you pay per interaction. This amount is the total cost
-          #     of your ads divided by the total number of interactions.
-          # @!attribute [rw] average_cpc
-          #   @return [Google::Protobuf::DoubleValue]
-          #     The total cost of all clicks divided by the total number of clicks
-          #     received.
-          # @!attribute [rw] average_cpm
-          #   @return [Google::Protobuf::DoubleValue]
-          #     Average cost-per-thousand impressions (CPM).
-          # @!attribute [rw] average_position
-          #   @return [Google::Protobuf::DoubleValue]
-          #     Your ad's position relative to those of other advertisers.
-          # @!attribute [rw] bounce_rate
-          #   @return [Google::Protobuf::DoubleValue]
-          #     Percentage of clicks where the user only visited a single page on your
-          #     site. Imported from Google Analytics.
-          # @!attribute [rw] clicks
-          #   @return [Google::Protobuf::Int64Value]
-          #     The number of clicks.
-          # @!attribute [rw] content_budget_lost_impression_share
-          #   @return [Google::Protobuf::DoubleValue]
-          #     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.
-          # @!attribute [rw] content_impression_share
-          #   @return [Google::Protobuf::DoubleValue]
-          #     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.
-          # @!attribute [rw] content_rank_lost_impression_share
-          #   @return [Google::Protobuf::DoubleValue]
-          #     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.
-          # @!attribute [rw] conversions_from_interactions_rate
-          #   @return [Google::Protobuf::DoubleValue]
-          #     Conversions from interactions divided by the number of ad interactions
-          #     (such as clicks for text ads or views for video ads).
-          # @!attribute [rw] conversions_value
-          #   @return [Google::Protobuf::DoubleValue]
-          #     The total value of conversions.
-          # @!attribute [rw] conversions_value_per_cost
-          #   @return [Google::Protobuf::DoubleValue]
-          #     The value of conversions divided by the cost of ad interactions.
-          # @!attribute [rw] conversions_from_interactions_value_per_interaction
-          #   @return [Google::Protobuf::DoubleValue]
-          #     The value of conversions from interactions divided by the number of ad
-          #     interactions.
-          # @!attribute [rw] conversions
-          #   @return [Google::Protobuf::DoubleValue]
-          #     The number of conversions. This only includes conversion actions which have
-          #     "Include in Conversions" checked.
-          # @!attribute [rw] cost_micros
-          #   @return [Google::Protobuf::Int64Value]
-          #     The sum of your cost-per-click (CPC) and cost-per-thousand impressions
-          #     (CPM) costs during this period.
-          # @!attribute [rw] cost_per_all_conversions
-          #   @return [Google::Protobuf::DoubleValue]
-          #     The cost of ad interactions divided by all conversions.
-          # @!attribute [rw] cost_per_conversion
-          #   @return [Google::Protobuf::DoubleValue]
-          #     The cost of ad interactions divided by conversions.
-          # @!attribute [rw] cross_device_conversions
-          #   @return [Google::Protobuf::DoubleValue]
-          #     Conversions from when a customer clicks on a Google Ads ad on one device,
-          #     then converts on a different device or browser.
-          #     Cross-device conversions are already included in all_conversions.
-          # @!attribute [rw] ctr
-          #   @return [Google::Protobuf::DoubleValue]
-          #     The number of clicks your ad receives (Clicks) divided by the number
-          #     of times your ad is shown (Impressions).
-          # @!attribute [rw] engagement_rate
-          #   @return [Google::Protobuf::DoubleValue]
-          #     How often people engage with your ad after it's shown to them. This is the
-          #     number of ad expansions divided by the number of times your ad is shown.
-          # @!attribute [rw] engagements
-          #   @return [Google::Protobuf::Int64Value]
-          #     The number of engagements.
-          #     An engagement occurs when a viewer expands your Lightbox ad. Also, in the
-          #     future, other ad types may support engagement metrics.
-          # @!attribute [rw] impressions
-          #   @return [Google::Protobuf::Int64Value]
-          #     Count of how often your ad has appeared on a search results page or
-          #     website on the Google Network.
-          # @!attribute [rw] interaction_rate
-          #   @return [Google::Protobuf::DoubleValue]
-          #     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.
-          # @!attribute [rw] interactions
-          #   @return [Google::Protobuf::Int64Value]
-          #     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.
-          # @!attribute [rw] invalid_click_rate
-          #   @return [Google::Protobuf::DoubleValue]
-          #     The percentage of clicks filtered out of your total number of clicks
-          #     (filtered + non-filtered clicks) during the reporting period.
-          # @!attribute [rw] invalid_clicks
-          #   @return [Google::Protobuf::Int64Value]
-          #     Number of clicks Google considers illegitimate and doesn't charge you for.
-          # @!attribute [rw] percent_new_visitors
-          #   @return [Google::Protobuf::DoubleValue]
-          #     Percentage of first-time sessions (from people who had never visited your
-          #     site before). Imported from Google Analytics.
-          # @!attribute [rw] phone_calls
-          #   @return [Google::Protobuf::Int64Value]
-          #     Number of offline phone calls.
-          # @!attribute [rw] phone_impressions
-          #   @return [Google::Protobuf::Int64Value]
-          #     Number of offline phone impressions.
-          # @!attribute [rw] phone_through_rate
-          #   @return [Google::Protobuf::DoubleValue]
-          #     Number of phone calls received (phone_calls) divided by the number of
-          #     times your phone number is shown (phone_impressions).
-          # @!attribute [rw] relative_ctr
-          #   @return [Google::Protobuf::DoubleValue]
-          #     Your clickthrough rate (Ctr) divided by the average clickthrough rate of
-          #     all advertisers on the websites that show your ads. Measures how your ads
-          #     perform on Display Network sites compared to other ads on the same sites.
-          # @!attribute [rw] search_budget_lost_impression_share
-          #   @return [Google::Protobuf::DoubleValue]
-          #     The estimated percent of times that your ad was eligible to show on the
-          #     Search Network but didn't because your budget was too low. Note: Search
-          #     budget lost impression share is reported in the range of 0 to 0.9. Any
-          #     value above 0.9 is reported as 0.9001.
-          # @!attribute [rw] search_exact_match_impression_share
-          #   @return [Google::Protobuf::DoubleValue]
-          #     The impressions you've received divided by the estimated number of
-          #     impressions you were eligible to receive on the Search Network for search
-          #     terms that matched your keywords exactly (or were close variants of your
-          #     keyword), regardless of your keyword match types. Note: Search exact match
-          #     impression share is reported in the range of 0.1 to 1. Any value below 0.1
-          #     is reported as 0.0999.
-          # @!attribute [rw] search_impression_share
-          #   @return [Google::Protobuf::DoubleValue]
-          #     The impressions you've received on the Search Network divided
-          #     by the estimated number of impressions you were eligible to receive.
-          #     Note: Search impression share is reported in the range of 0.1 to 1. Any
-          #     value below 0.1 is reported as 0.0999.
-          # @!attribute [rw] search_rank_lost_impression_share
-          #   @return [Google::Protobuf::DoubleValue]
-          #     The estimated percentage of impressions on the Search Network
-          #     that your ads didn't receive due to poor Ad Rank.
-          #     Note: Search rank lost impression share is reported in the range of 0 to
-          #     0.9. Any value above 0.9 is reported as 0.9001.
-          # @!attribute [rw] value_per_all_conversions
-          #   @return [Google::Protobuf::DoubleValue]
-          #     The value of all conversions divided by the number of all conversions.
-          # @!attribute [rw] value_per_conversion
-          #   @return [Google::Protobuf::DoubleValue]
-          #     The value of conversions divided by the number of conversions.
-          # @!attribute [rw] view_through_conversions
-          #   @return [Google::Protobuf::Int64Value]
-          #     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 (e.g.,
-          #     clicking on) another ad.
-          class Metrics; end
-        end
-      end
-    end
-  end
-end

data/lib/google/ads/googleads/v0/services/doc/google/ads/googleads/v0/resources/ad.rb

@@ -1,79 +0,0 @@
-# Copyright 2018 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     https://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-module Google
-  module Ads
-    module Googleads
-      module V0
-        module Resources
-          # An ad.
-          # @!attribute [rw] id
-          #   @return [Google::Protobuf::Int64Value]
-          #     The ID of the ad.
-          # @!attribute [rw] final_urls
-          #   @return [Array<Google::Protobuf::StringValue>]
-          #     The list of possible final URLs after all cross-domain redirects for the
-          #     ad.
-          # @!attribute [rw] final_mobile_urls
-          #   @return [Array<Google::Protobuf::StringValue>]
-          #     The list of possible final mobile URLs after all cross-domain redirects
-          #     for the ad.
-          # @!attribute [rw] tracking_url_template
-          #   @return [Google::Protobuf::StringValue]
-          #     The URL template for constructing a tracking URL.
-          # @!attribute [rw] url_custom_parameters
-          #   @return [Array<Google::Ads::Googleads::V0::Common::CustomParameter>]
-          #     The list of mappings that can be used to substitute custom parameter tags
-          #     in a
-          #     +tracking_url_template+, +final_urls+, or +mobile_final_urls+.
-          # @!attribute [rw] display_url
-          #   @return [Google::Protobuf::StringValue]
-          #     The URL that appears in the ad description for some ad formats.
-          # @!attribute [rw] type
-          #   @return [Google::Ads::Googleads::V0::Enums::AdTypeEnum::AdType]
-          #     The type of ad.
-          # @!attribute [rw] text_ad
-          #   @return [Google::Ads::Googleads::V0::Common::TextAdInfo]
-          #     Details pertaining to a text ad.
-          # @!attribute [rw] expanded_text_ad
-          #   @return [Google::Ads::Googleads::V0::Common::ExpandedTextAdInfo]
-          #     Details pertaining to an expanded text ad.
-          # @!attribute [rw] dynamic_search_ad
-          #   @return [Google::Ads::Googleads::V0::Common::DynamicSearchAdInfo]
-          #     Details pertaining to a Dynamic Search Ad.
-          # @!attribute [rw] responsive_display_ad
-          #   @return [Google::Ads::Googleads::V0::Common::ResponsiveDisplayAdInfo]
-          #     Details pertaining to a responsive display ad.
-          # @!attribute [rw] call_only_ad
-          #   @return [Google::Ads::Googleads::V0::Common::CallOnlyAdInfo]
-          #     Details pertaining to a call-only ad.
-          # @!attribute [rw] expanded_dynamic_search_ad
-          #   @return [Google::Ads::Googleads::V0::Common::ExpandedDynamicSearchAdInfo]
-          #     Details pertaining to an Expanded Dynamic Search Ad.
-          #     This type of ad has its headline, final URLs, and display URL
-          #     auto-generated at serving time according to domain name specific
-          #     information provided by +dynamic_search_ads_setting+ linked at the
-          #     campaign level.
-          # @!attribute [rw] hotel_ad
-          #   @return [Google::Ads::Googleads::V0::Common::HotelAdInfo]
-          #     Details pertaining to a hotel ad.
-          # @!attribute [rw] shopping_smart_ad
-          #   @return [Google::Ads::Googleads::V0::Common::ShoppingSmartAdInfo]
-          #     Details pertaining to a Smart Shopping ad.
-          class Ad; end
-        end
-      end
-    end
-  end
-end

data/lib/google/ads/googleads/v0/services/doc/google/ads/googleads/v0/resources/ad_group.rb

@@ -1,87 +0,0 @@
-# Copyright 2018 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     https://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-module Google
-  module Ads
-    module Googleads
-      module V0
-        module Resources
-          # An ad group.
-          # @!attribute [rw] resource_name
-          #   @return [String]
-          #     The resource name of the ad group.
-          #     Ad group resource names have the form:
-          #
-          #     +customers/{customer_id}/adGroups/{ad_group_id}+
-          # @!attribute [rw] id
-          #   @return [Google::Protobuf::Int64Value]
-          #     The ID of the ad group.
-          # @!attribute [rw] name
-          #   @return [Google::Protobuf::StringValue]
-          #     The name of the ad group.
-          #
-          #     This field is required and should not be empty when creating new ad
-          #     groups.
-          #
-          #     It must contain fewer than 255 UTF-8 full-width characters.
-          #
-          #     It must not contain any null (code point 0x0), NL line feed
-          #     (code point 0xA) or carriage return (code point 0xD) characters.
-          # @!attribute [rw] status
-          #   @return [Google::Ads::Googleads::V0::Enums::AdGroupStatusEnum::AdGroupStatus]
-          #     The status of the ad group.
-          # @!attribute [rw] type
-          #   @return [Google::Ads::Googleads::V0::Enums::AdGroupTypeEnum::AdGroupType]
-          #     The type of the ad group.
-          # @!attribute [rw] tracking_url_template
-          #   @return [Google::Protobuf::StringValue]
-          #     The URL template for constructing a tracking URL.
-          # @!attribute [rw] url_custom_parameters
-          #   @return [Array<Google::Ads::Googleads::V0::Common::CustomParameter>]
-          #     The list of mappings used to substitute custom parameter tags in a
-          #     +tracking_url_template+, +final_urls+, or +mobile_final_urls+.
-          # @!attribute [rw] campaign
-          #   @return [Google::Protobuf::StringValue]
-          #     The campaign to which the ad group belongs.
-          #
-          #     This field must not be used in WHERE clauses.
-          # @!attribute [rw] cpc_bid_micros
-          #   @return [Google::Protobuf::Int64Value]
-          #     The maximum CPC (cost-per-click) bid.
-          # @!attribute [rw] cpm_bid_micros
-          #   @return [Google::Protobuf::Int64Value]
-          #     The maximum CPM (cost-per-thousand viewable impressions) bid.
-          # @!attribute [rw] cpa_bid_micros
-          #   @return [Google::Protobuf::Int64Value]
-          #     The target cost-per-acquisition (conversion) bid.
-          # @!attribute [rw] cpv_bid_micros
-          #   @return [Google::Protobuf::Int64Value]
-          #     The CPV (cost-per-view) bid.
-          # @!attribute [rw] target_roas_override
-          #   @return [Google::Protobuf::DoubleValue]
-          #     The target return on ad spend (ROAS) override. If the ad group's campaign
-          #     bidding strategy is a standard Target ROAS strategy, then this field
-          #     overrides the target ROAS specified in the campaign's bidding strategy.
-          #     Otherwise, this value is ignored.
-          # @!attribute [rw] percent_cpc_bid_micros
-          #   @return [Google::Protobuf::Int64Value]
-          #     The percent cpc bid amount, expressed as a fraction of the advertised price
-          #     for some good or service. The valid range for the fraction is [0,1) and the
-          #     value stored here is 1,000,000 * [fraction].
-          class AdGroup; end
-        end
-      end
-    end
-  end
-end

data/lib/google/ads/googleads/v0/services/doc/google/ads/googleads/v0/resources/ad_group_ad.rb

@@ -1,43 +0,0 @@
-# Copyright 2018 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     https://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-module Google
-  module Ads
-    module Googleads
-      module V0
-        module Resources
-          # An ad group ad.
-          # @!attribute [rw] resource_name
-          #   @return [String]
-          #     The resource name of the ad.
-          #     Ad group ad resource names have the form:
-          #
-          #     +customers/{customer_id}/adGroupAds/{ad_group_id}_{ad_id}+
-          # @!attribute [rw] status
-          #   @return [Google::Ads::Googleads::V0::Enums::AdGroupAdStatusEnum::AdGroupAdStatus]
-          #     The status of the ad.
-          # @!attribute [rw] ad_group
-          #   @return [Google::Protobuf::StringValue]
-          #     The ad group to which the ad belongs.
-          #
-          #     This field must not be used in WHERE clauses.
-          # @!attribute [rw] ad
-          #   @return [Google::Ads::Googleads::V0::Resources::Ad]
-          #     The ad.
-          class AdGroupAd; end
-        end
-      end
-    end
-  end
-end

data/lib/google/ads/googleads/v0/services/doc/google/ads/googleads/v0/resources/ad_group_bid_modifier.rb

@@ -1,70 +0,0 @@
-# Copyright 2018 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     https://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-module Google
-  module Ads
-    module Googleads
-      module V0
-        module Resources
-          # Represents an ad group bid modifier.
-          # @!attribute [rw] resource_name
-          #   @return [String]
-          #     The resource name of the ad group bid modifier.
-          #     Ad group bid modifier resource names have the form:
-          #
-          #     +customers/{customer_id}/adGroupBidModifiers/{ad_group_id}_{criterion_id}+
-          # @!attribute [rw] ad_group
-          #   @return [Google::Protobuf::StringValue]
-          #     The ad group to which this criterion belongs.
-          #
-          #     This field must not be used in WHERE clauses.
-          # @!attribute [rw] criterion_id
-          #   @return [Google::Protobuf::Int64Value]
-          #     The ID of the criterion to bid modify.
-          #
-          #     This field is ignored for mutates.
-          # @!attribute [rw] bid_modifier
-          #   @return [Google::Protobuf::DoubleValue]
-          #     The modifier for the bid when the criterion matches.
-          # @!attribute [rw] base_ad_group
-          #   @return [Google::Protobuf::StringValue]
-          #     The base ad group from which this draft/trial adgroup bid modifier was
-          #     created. If ad_group is a base ad group then this field will be equal to
-          #     ad_group. If the ad group was created in the draft or trial and has no
-          #     corresponding base ad group, then this field will be null.
-          #     This field is readonly.
-          # @!attribute [rw] bid_modifier_source
-          #   @return [Google::Ads::Googleads::V0::Enums::BidModifierSourceEnum::BidModifierSource]
-          #     Bid modifier source.
-          # @!attribute [rw] hotel_date_selection_type
-          #   @return [Google::Ads::Googleads::V0::Common::HotelDateSelectionTypeInfo]
-          #     Criterion for hotel date selection (default dates vs. user selected).
-          # @!attribute [rw] hotel_advance_booking_window
-          #   @return [Google::Ads::Googleads::V0::Common::HotelAdvanceBookingWindowInfo]
-          #     Criterion for number of days prior to the stay the booking is being made.
-          # @!attribute [rw] hotel_length_of_stay
-          #   @return [Google::Ads::Googleads::V0::Common::HotelLengthOfStayInfo]
-          #     Criterion for length of hotel stay in nights.
-          # @!attribute [rw] hotel_check_in_day
-          #   @return [Google::Ads::Googleads::V0::Common::HotelCheckInDayInfo]
-          #     Criterion for day of the week the booking is for.
-          # @!attribute [rw] device
-          #   @return [Google::Ads::Googleads::V0::Common::DeviceInfo]
-          #     A device criterion.
-          class AdGroupBidModifier; end
-        end
-      end
-    end
-  end
-end

data/lib/google/ads/googleads/v0/services/doc/google/ads/googleads/v0/resources/ad_group_criterion.rb

@@ -1,148 +0,0 @@
-# Copyright 2018 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     https://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-module Google
-  module Ads
-    module Googleads
-      module V0
-        module Resources
-          # An ad group criterion.
-          # @!attribute [rw] resource_name
-          #   @return [String]
-          #     The resource name of the ad group criterion.
-          #     Ad group criterion resource names have the form:
-          #
-          #     +customers/{customer_id}/adGroupCriteria/{ad_group_id}_{criterion_id}+
-          # @!attribute [rw] criterion_id
-          #   @return [Google::Protobuf::Int64Value]
-          #     The ID of the criterion.
-          #
-          #     This field is ignored for mutates.
-          # @!attribute [rw] status
-          #   @return [Google::Ads::Googleads::V0::Enums::AdGroupCriterionStatusEnum::AdGroupCriterionStatus]
-          #     The status of the criterion.
-          # @!attribute [rw] quality_info
-          #   @return [Google::Ads::Googleads::V0::Resources::AdGroupCriterion::QualityInfo]
-          #     Information regarding the quality of the criterion.
-          # @!attribute [rw] ad_group
-          #   @return [Google::Protobuf::StringValue]
-          #     The ad group to which the criterion belongs.
-          #
-          #     This field must not be used in WHERE clauses.
-          # @!attribute [rw] type
-          #   @return [Google::Ads::Googleads::V0::Enums::CriterionTypeEnum::CriterionType]
-          #     The type of the criterion.
-          # @!attribute [rw] negative
-          #   @return [Google::Protobuf::BoolValue]
-          #     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.
-          # @!attribute [rw] cpc_bid_micros
-          #   @return [Google::Protobuf::Int64Value]
-          #     The CPC (cost-per-click) bid.
-          # @!attribute [rw] cpm_bid_micros
-          #   @return [Google::Protobuf::Int64Value]
-          #     The CPM (cost-per-thousand viewable impressions) bid.
-          # @!attribute [rw] cpv_bid_micros
-          #   @return [Google::Protobuf::Int64Value]
-          #     The CPV (cost-per-view) bid.
-          # @!attribute [rw] percent_cpc_bid_micros
-          #   @return [Google::Protobuf::Int64Value]
-          #     The CPC bid amount, expressed as a fraction of the advertised price
-          #     for some good or service. The valid range for the fraction is [0,1) and the
-          #     value stored here is 1,000,000 * [fraction].
-          # @!attribute [rw] effective_cpc_bid_micros
-          #   @return [Google::Protobuf::Int64Value]
-          #     The effective CPC (cost-per-click) bid.
-          # @!attribute [rw] effective_cpm_bid_micros
-          #   @return [Google::Protobuf::Int64Value]
-          #     The effective CPM (cost-per-thousand viewable impressions) bid.
-          # @!attribute [rw] effective_cpv_bid_micros
-          #   @return [Google::Protobuf::Int64Value]
-          #     The effective CPV (cost-per-view) bid.
-          # @!attribute [rw] effective_percent_cpc_bid_micros
-          #   @return [Google::Protobuf::Int64Value]
-          #     The effective Percent CPC bid amount.
-          # @!attribute [rw] effective_cpc_bid_source
-          #   @return [Google::Ads::Googleads::V0::Enums::BiddingSourceEnum::BiddingSource]
-          #     Source of the effective CPC bid.
-          # @!attribute [rw] effective_cpm_bid_source
-          #   @return [Google::Ads::Googleads::V0::Enums::BiddingSourceEnum::BiddingSource]
-          #     Source of the effective CPM bid.
-          # @!attribute [rw] effective_cpv_bid_source
-          #   @return [Google::Ads::Googleads::V0::Enums::BiddingSourceEnum::BiddingSource]
-          #     Source of the effective CPV bid.
-          # @!attribute [rw] effective_percent_cpc_bid_source
-          #   @return [Google::Ads::Googleads::V0::Enums::BiddingSourceEnum::BiddingSource]
-          #     Source of the effective Percent CPC bid.
-          # @!attribute [rw] position_estimates
-          #   @return [Google::Ads::Googleads::V0::Resources::AdGroupCriterion::PositionEstimates]
-          #     Estimates for criterion bids at various positions.
-          # @!attribute [rw] final_urls
-          #   @return [Array<Google::Protobuf::StringValue>]
-          #     The list of possible final URLs after all cross-domain redirects for the
-          #     ad.
-          # @!attribute [rw] tracking_url_template
-          #   @return [Google::Protobuf::StringValue]
-          #     The URL template for constructing a tracking URL.
-          # @!attribute [rw] url_custom_parameters
-          #   @return [Array<Google::Ads::Googleads::V0::Common::CustomParameter>]
-          #     The list of mappings used to substitute custom parameter tags in a
-          #     +tracking_url_template+, +final_urls+, or +mobile_final_urls+.
-          # @!attribute [rw] keyword
-          #   @return [Google::Ads::Googleads::V0::Common::KeywordInfo]
-          #     Keyword.
-          # @!attribute [rw] listing_group
-          #   @return [Google::Ads::Googleads::V0::Common::ListingGroupInfo]
-          #     Listing group.
-          class AdGroupCriterion
-            # A container for ad group criterion quality information.
-            # @!attribute [rw] quality_score
-            #   @return [Google::Protobuf::Int32Value]
-            #     The quality score.
-            #
-            #     This field may not be populated if Google does not have enough
-            #     information to determine a value.
-            # @!attribute [rw] creative_quality_score
-            #   @return [Google::Ads::Googleads::V0::Enums::QualityScoreBucketEnum::QualityScoreBucket]
-            #     The performance of the ad compared to other advertisers.
-            # @!attribute [rw] post_click_quality_score
-            #   @return [Google::Ads::Googleads::V0::Enums::QualityScoreBucketEnum::QualityScoreBucket]
-            #     The quality score of the landing page.
-            # @!attribute [rw] search_predicted_ctr
-            #   @return [Google::Ads::Googleads::V0::Enums::QualityScoreBucketEnum::QualityScoreBucket]
-            #     The click-through rate compared to that of other advertisers.
-            class QualityInfo; end
-
-            # Estimates for criterion bids at various positions.
-            # @!attribute [rw] first_page_cpc_micros
-            #   @return [Google::Protobuf::Int64Value]
-            #     The estimate of the CPC bid required for ad to be shown on first
-            #     page of search results.
-            # @!attribute [rw] first_position_cpc_micros
-            #   @return [Google::Protobuf::Int64Value]
-            #     The estimate of the CPC bid required for ad to be displayed in first
-            #     position, at the top of the first page of search results.
-            # @!attribute [rw] top_of_page_cpc_micros
-            #   @return [Google::Protobuf::Int64Value]
-            #     The estimate of the CPC bid required for ad to be displayed at the top
-            #     of the first page of search results.
-            class PositionEstimates; end
-          end
-        end
-      end
-    end
-  end
-end