966 lines
		
	
	
		
			40 KiB
		
	
	
	
		
			Ruby
		
	
	
	
		
		
			
		
	
	
			966 lines
		
	
	
		
			40 KiB
		
	
	
	
		
			Ruby
		
	
	
	
|  | # Copyright 2020 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 | ||
|  | # | ||
|  | #      http://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. | ||
|  | 
 | ||
|  | require 'date' | ||
|  | require 'google/apis/core/base_service' | ||
|  | require 'google/apis/core/json_representation' | ||
|  | require 'google/apis/core/hashable' | ||
|  | require 'google/apis/errors' | ||
|  | 
 | ||
|  | module Google | ||
|  |   module Apis | ||
|  |     module DoubleclicksearchV2 | ||
|  |        | ||
|  |       # A message containing availability data relevant to DoubleClick Search. | ||
|  |       class Availability | ||
|  |         include Google::Apis::Core::Hashable | ||
|  |        | ||
|  |         # DS advertiser ID. | ||
|  |         # Corresponds to the JSON property `advertiserId` | ||
|  |         # @return [Fixnum] | ||
|  |         attr_accessor :advertiser_id | ||
|  |        | ||
|  |         # DS agency ID. | ||
|  |         # Corresponds to the JSON property `agencyId` | ||
|  |         # @return [Fixnum] | ||
|  |         attr_accessor :agency_id | ||
|  |        | ||
|  |         # The time by which all conversions have been uploaded, in epoch millis UTC. | ||
|  |         # Corresponds to the JSON property `availabilityTimestamp` | ||
|  |         # @return [Fixnum] | ||
|  |         attr_accessor :availability_timestamp | ||
|  |        | ||
|  |         # The numeric segmentation identifier (for example, DoubleClick Search | ||
|  |         # Floodlight activity ID). | ||
|  |         # Corresponds to the JSON property `segmentationId` | ||
|  |         # @return [Fixnum] | ||
|  |         attr_accessor :segmentation_id | ||
|  |        | ||
|  |         # The friendly segmentation identifier (for example, DoubleClick Search | ||
|  |         # Floodlight activity name). | ||
|  |         # Corresponds to the JSON property `segmentationName` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :segmentation_name | ||
|  |        | ||
|  |         # The segmentation type that this availability is for (its default value is ` | ||
|  |         # FLOODLIGHT`). | ||
|  |         # Corresponds to the JSON property `segmentationType` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :segmentation_type | ||
|  |        | ||
|  |         def initialize(**args) | ||
|  |            update!(**args) | ||
|  |         end | ||
|  |        | ||
|  |         # Update properties of this object | ||
|  |         def update!(**args) | ||
|  |           @advertiser_id = args[:advertiser_id] if args.key?(:advertiser_id) | ||
|  |           @agency_id = args[:agency_id] if args.key?(:agency_id) | ||
|  |           @availability_timestamp = args[:availability_timestamp] if args.key?(:availability_timestamp) | ||
|  |           @segmentation_id = args[:segmentation_id] if args.key?(:segmentation_id) | ||
|  |           @segmentation_name = args[:segmentation_name] if args.key?(:segmentation_name) | ||
|  |           @segmentation_type = args[:segmentation_type] if args.key?(:segmentation_type) | ||
|  |         end | ||
|  |       end | ||
|  |        | ||
|  |       # A conversion containing data relevant to DoubleClick Search. | ||
|  |       class Conversion | ||
|  |         include Google::Apis::Core::Hashable | ||
|  |        | ||
|  |         # DS ad group ID. | ||
|  |         # Corresponds to the JSON property `adGroupId` | ||
|  |         # @return [Fixnum] | ||
|  |         attr_accessor :ad_group_id | ||
|  |        | ||
|  |         # DS ad ID. | ||
|  |         # Corresponds to the JSON property `adId` | ||
|  |         # @return [Fixnum] | ||
|  |         attr_accessor :ad_id | ||
|  |        | ||
|  |         # DS advertiser ID. | ||
|  |         # Corresponds to the JSON property `advertiserId` | ||
|  |         # @return [Fixnum] | ||
|  |         attr_accessor :advertiser_id | ||
|  |        | ||
|  |         # DS agency ID. | ||
|  |         # Corresponds to the JSON property `agencyId` | ||
|  |         # @return [Fixnum] | ||
|  |         attr_accessor :agency_id | ||
|  |        | ||
|  |         # Available to advertisers only after contacting DoubleClick Search customer | ||
|  |         # support. | ||
|  |         # Corresponds to the JSON property `attributionModel` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :attribution_model | ||
|  |        | ||
|  |         # DS campaign ID. | ||
|  |         # Corresponds to the JSON property `campaignId` | ||
|  |         # @return [Fixnum] | ||
|  |         attr_accessor :campaign_id | ||
|  |        | ||
|  |         # Sales channel for the product. Acceptable values are: - "`local`": a physical | ||
|  |         # store - "`online`": an online store | ||
|  |         # Corresponds to the JSON property `channel` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :channel | ||
|  |        | ||
|  |         # DS click ID for the conversion. | ||
|  |         # Corresponds to the JSON property `clickId` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :click_id | ||
|  |        | ||
|  |         # For offline conversions, advertisers provide this ID. Advertisers can specify | ||
|  |         # any ID that is meaningful to them. Each conversion in a request must specify a | ||
|  |         # unique ID, and the combination of ID and timestamp must be unique amongst all | ||
|  |         # conversions within the advertiser. For online conversions, DS copies the ` | ||
|  |         # dsConversionId` or `floodlightOrderId` into this property depending on the | ||
|  |         # advertiser's Floodlight instructions. | ||
|  |         # Corresponds to the JSON property `conversionId` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :conversion_id | ||
|  |        | ||
|  |         # The time at which the conversion was last modified, in epoch millis UTC. | ||
|  |         # Corresponds to the JSON property `conversionModifiedTimestamp` | ||
|  |         # @return [Fixnum] | ||
|  |         attr_accessor :conversion_modified_timestamp | ||
|  |        | ||
|  |         # The time at which the conversion took place, in epoch millis UTC. | ||
|  |         # Corresponds to the JSON property `conversionTimestamp` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :conversion_timestamp | ||
|  |        | ||
|  |         # Available to advertisers only after contacting DoubleClick Search customer | ||
|  |         # support. | ||
|  |         # Corresponds to the JSON property `countMillis` | ||
|  |         # @return [Fixnum] | ||
|  |         attr_accessor :count_millis | ||
|  |        | ||
|  |         # DS criterion (keyword) ID. | ||
|  |         # Corresponds to the JSON property `criterionId` | ||
|  |         # @return [Fixnum] | ||
|  |         attr_accessor :criterion_id | ||
|  |        | ||
|  |         # The currency code for the conversion's revenue. Should be in ISO 4217 | ||
|  |         # alphabetic (3-char) format. | ||
|  |         # Corresponds to the JSON property `currencyCode` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :currency_code | ||
|  |        | ||
|  |         # Custom dimensions for the conversion, which can be used to filter data in a | ||
|  |         # report. | ||
|  |         # Corresponds to the JSON property `customDimension` | ||
|  |         # @return [Array<Google::Apis::DoubleclicksearchV2::CustomDimension>] | ||
|  |         attr_accessor :custom_dimension | ||
|  |        | ||
|  |         # Custom metrics for the conversion. | ||
|  |         # Corresponds to the JSON property `customMetric` | ||
|  |         # @return [Array<Google::Apis::DoubleclicksearchV2::CustomMetric>] | ||
|  |         attr_accessor :custom_metric | ||
|  |        | ||
|  |         # The type of device on which the conversion occurred. | ||
|  |         # Corresponds to the JSON property `deviceType` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :device_type | ||
|  |        | ||
|  |         # ID that DoubleClick Search generates for each conversion. | ||
|  |         # Corresponds to the JSON property `dsConversionId` | ||
|  |         # @return [Fixnum] | ||
|  |         attr_accessor :ds_conversion_id | ||
|  |        | ||
|  |         # DS engine account ID. | ||
|  |         # Corresponds to the JSON property `engineAccountId` | ||
|  |         # @return [Fixnum] | ||
|  |         attr_accessor :engine_account_id | ||
|  |        | ||
|  |         # The Floodlight order ID provided by the advertiser for the conversion. | ||
|  |         # Corresponds to the JSON property `floodlightOrderId` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :floodlight_order_id | ||
|  |        | ||
|  |         # ID that DS generates and uses to uniquely identify the inventory account that | ||
|  |         # contains the product. | ||
|  |         # Corresponds to the JSON property `inventoryAccountId` | ||
|  |         # @return [Fixnum] | ||
|  |         attr_accessor :inventory_account_id | ||
|  |        | ||
|  |         # The country registered for the Merchant Center feed that contains the product. | ||
|  |         # Use an ISO 3166 code to specify a country. | ||
|  |         # Corresponds to the JSON property `productCountry` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :product_country | ||
|  |        | ||
|  |         # DS product group ID. | ||
|  |         # Corresponds to the JSON property `productGroupId` | ||
|  |         # @return [Fixnum] | ||
|  |         attr_accessor :product_group_id | ||
|  |        | ||
|  |         # The product ID (SKU). | ||
|  |         # Corresponds to the JSON property `productId` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :product_id | ||
|  |        | ||
|  |         # The language registered for the Merchant Center feed that contains the product. | ||
|  |         # Use an ISO 639 code to specify a language. | ||
|  |         # Corresponds to the JSON property `productLanguage` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :product_language | ||
|  |        | ||
|  |         # The quantity of this conversion, in millis. | ||
|  |         # Corresponds to the JSON property `quantityMillis` | ||
|  |         # @return [Fixnum] | ||
|  |         attr_accessor :quantity_millis | ||
|  |        | ||
|  |         # The revenue amount of this `TRANSACTION` conversion, in micros (value | ||
|  |         # multiplied by 1000000, no decimal). For example, to specify a revenue value of | ||
|  |         # "10" enter "10000000" (10 million) in your request. | ||
|  |         # Corresponds to the JSON property `revenueMicros` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :revenue_micros | ||
|  |        | ||
|  |         # The numeric segmentation identifier (for example, DoubleClick Search | ||
|  |         # Floodlight activity ID). | ||
|  |         # Corresponds to the JSON property `segmentationId` | ||
|  |         # @return [Fixnum] | ||
|  |         attr_accessor :segmentation_id | ||
|  |        | ||
|  |         # The friendly segmentation identifier (for example, DoubleClick Search | ||
|  |         # Floodlight activity name). | ||
|  |         # Corresponds to the JSON property `segmentationName` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :segmentation_name | ||
|  |        | ||
|  |         # The segmentation type of this conversion (for example, `FLOODLIGHT`). | ||
|  |         # Corresponds to the JSON property `segmentationType` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :segmentation_type | ||
|  |        | ||
|  |         # The state of the conversion, that is, either `ACTIVE` or `REMOVED`. Note: | ||
|  |         # state DELETED is deprecated. | ||
|  |         # Corresponds to the JSON property `state` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :state | ||
|  |        | ||
|  |         # The ID of the local store for which the product was advertised. Applicable | ||
|  |         # only when the channel is "`local`". | ||
|  |         # Corresponds to the JSON property `storeId` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :store_id | ||
|  |        | ||
|  |         # The type of the conversion, that is, either `ACTION` or `TRANSACTION`. An ` | ||
|  |         # ACTION` conversion is an action by the user that has no monetarily | ||
|  |         # quantifiable value, while a `TRANSACTION` conversion is an action that does | ||
|  |         # have a monetarily quantifiable value. Examples are email list signups (`ACTION` | ||
|  |         # ) versus ecommerce purchases (`TRANSACTION`). | ||
|  |         # Corresponds to the JSON property `type` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :type | ||
|  |        | ||
|  |         def initialize(**args) | ||
|  |            update!(**args) | ||
|  |         end | ||
|  |        | ||
|  |         # Update properties of this object | ||
|  |         def update!(**args) | ||
|  |           @ad_group_id = args[:ad_group_id] if args.key?(:ad_group_id) | ||
|  |           @ad_id = args[:ad_id] if args.key?(:ad_id) | ||
|  |           @advertiser_id = args[:advertiser_id] if args.key?(:advertiser_id) | ||
|  |           @agency_id = args[:agency_id] if args.key?(:agency_id) | ||
|  |           @attribution_model = args[:attribution_model] if args.key?(:attribution_model) | ||
|  |           @campaign_id = args[:campaign_id] if args.key?(:campaign_id) | ||
|  |           @channel = args[:channel] if args.key?(:channel) | ||
|  |           @click_id = args[:click_id] if args.key?(:click_id) | ||
|  |           @conversion_id = args[:conversion_id] if args.key?(:conversion_id) | ||
|  |           @conversion_modified_timestamp = args[:conversion_modified_timestamp] if args.key?(:conversion_modified_timestamp) | ||
|  |           @conversion_timestamp = args[:conversion_timestamp] if args.key?(:conversion_timestamp) | ||
|  |           @count_millis = args[:count_millis] if args.key?(:count_millis) | ||
|  |           @criterion_id = args[:criterion_id] if args.key?(:criterion_id) | ||
|  |           @currency_code = args[:currency_code] if args.key?(:currency_code) | ||
|  |           @custom_dimension = args[:custom_dimension] if args.key?(:custom_dimension) | ||
|  |           @custom_metric = args[:custom_metric] if args.key?(:custom_metric) | ||
|  |           @device_type = args[:device_type] if args.key?(:device_type) | ||
|  |           @ds_conversion_id = args[:ds_conversion_id] if args.key?(:ds_conversion_id) | ||
|  |           @engine_account_id = args[:engine_account_id] if args.key?(:engine_account_id) | ||
|  |           @floodlight_order_id = args[:floodlight_order_id] if args.key?(:floodlight_order_id) | ||
|  |           @inventory_account_id = args[:inventory_account_id] if args.key?(:inventory_account_id) | ||
|  |           @product_country = args[:product_country] if args.key?(:product_country) | ||
|  |           @product_group_id = args[:product_group_id] if args.key?(:product_group_id) | ||
|  |           @product_id = args[:product_id] if args.key?(:product_id) | ||
|  |           @product_language = args[:product_language] if args.key?(:product_language) | ||
|  |           @quantity_millis = args[:quantity_millis] if args.key?(:quantity_millis) | ||
|  |           @revenue_micros = args[:revenue_micros] if args.key?(:revenue_micros) | ||
|  |           @segmentation_id = args[:segmentation_id] if args.key?(:segmentation_id) | ||
|  |           @segmentation_name = args[:segmentation_name] if args.key?(:segmentation_name) | ||
|  |           @segmentation_type = args[:segmentation_type] if args.key?(:segmentation_type) | ||
|  |           @state = args[:state] if args.key?(:state) | ||
|  |           @store_id = args[:store_id] if args.key?(:store_id) | ||
|  |           @type = args[:type] if args.key?(:type) | ||
|  |         end | ||
|  |       end | ||
|  |        | ||
|  |       # A list of conversions. | ||
|  |       class ConversionList | ||
|  |         include Google::Apis::Core::Hashable | ||
|  |        | ||
|  |         # The conversions being requested. | ||
|  |         # Corresponds to the JSON property `conversion` | ||
|  |         # @return [Array<Google::Apis::DoubleclicksearchV2::Conversion>] | ||
|  |         attr_accessor :conversion | ||
|  |        | ||
|  |         # Identifies this as a ConversionList resource. Value: the fixed string | ||
|  |         # doubleclicksearch#conversionList. | ||
|  |         # Corresponds to the JSON property `kind` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :kind | ||
|  |        | ||
|  |         def initialize(**args) | ||
|  |            update!(**args) | ||
|  |         end | ||
|  |        | ||
|  |         # Update properties of this object | ||
|  |         def update!(**args) | ||
|  |           @conversion = args[:conversion] if args.key?(:conversion) | ||
|  |           @kind = args[:kind] if args.key?(:kind) | ||
|  |         end | ||
|  |       end | ||
|  |        | ||
|  |       # A message containing the custom dimension. | ||
|  |       class CustomDimension | ||
|  |         include Google::Apis::Core::Hashable | ||
|  |        | ||
|  |         # Custom dimension name. | ||
|  |         # Corresponds to the JSON property `name` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :name | ||
|  |        | ||
|  |         # Custom dimension value. | ||
|  |         # Corresponds to the JSON property `value` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :value | ||
|  |        | ||
|  |         def initialize(**args) | ||
|  |            update!(**args) | ||
|  |         end | ||
|  |        | ||
|  |         # Update properties of this object | ||
|  |         def update!(**args) | ||
|  |           @name = args[:name] if args.key?(:name) | ||
|  |           @value = args[:value] if args.key?(:value) | ||
|  |         end | ||
|  |       end | ||
|  |        | ||
|  |       # A message containing the custom metric. | ||
|  |       class CustomMetric | ||
|  |         include Google::Apis::Core::Hashable | ||
|  |        | ||
|  |         # Custom metric name. | ||
|  |         # Corresponds to the JSON property `name` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :name | ||
|  |        | ||
|  |         # Custom metric numeric value. | ||
|  |         # Corresponds to the JSON property `value` | ||
|  |         # @return [Float] | ||
|  |         attr_accessor :value | ||
|  |        | ||
|  |         def initialize(**args) | ||
|  |            update!(**args) | ||
|  |         end | ||
|  |        | ||
|  |         # Update properties of this object | ||
|  |         def update!(**args) | ||
|  |           @name = args[:name] if args.key?(:name) | ||
|  |           @value = args[:value] if args.key?(:value) | ||
|  |         end | ||
|  |       end | ||
|  |        | ||
|  |       # A DoubleClick Search report. This object contains the report request, some | ||
|  |       # report metadata such as currency code, and the generated report rows or report | ||
|  |       # files. | ||
|  |       class Report | ||
|  |         include Google::Apis::Core::Hashable | ||
|  |        | ||
|  |         # Asynchronous report only. Contains a list of generated report files once the | ||
|  |         # report has successfully completed. | ||
|  |         # Corresponds to the JSON property `files` | ||
|  |         # @return [Array<Google::Apis::DoubleclicksearchV2::Report::File>] | ||
|  |         attr_accessor :files | ||
|  |        | ||
|  |         # Asynchronous report only. Id of the report. | ||
|  |         # Corresponds to the JSON property `id` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :id | ||
|  |        | ||
|  |         # Asynchronous report only. True if and only if the report has completed | ||
|  |         # successfully and the report files are ready to be downloaded. | ||
|  |         # Corresponds to the JSON property `isReportReady` | ||
|  |         # @return [Boolean] | ||
|  |         attr_accessor :is_report_ready | ||
|  |         alias_method :is_report_ready?, :is_report_ready | ||
|  |        | ||
|  |         # Identifies this as a Report resource. Value: the fixed string ` | ||
|  |         # doubleclicksearch#report`. | ||
|  |         # Corresponds to the JSON property `kind` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :kind | ||
|  |        | ||
|  |         # A request object used to create a DoubleClick Search report. | ||
|  |         # Corresponds to the JSON property `request` | ||
|  |         # @return [Google::Apis::DoubleclicksearchV2::ReportRequest] | ||
|  |         attr_accessor :request | ||
|  |        | ||
|  |         # The number of report rows generated by the report, not including headers. | ||
|  |         # Corresponds to the JSON property `rowCount` | ||
|  |         # @return [Fixnum] | ||
|  |         attr_accessor :row_count | ||
|  |        | ||
|  |         # Synchronous report only. Generated report rows. | ||
|  |         # Corresponds to the JSON property `rows` | ||
|  |         # @return [Array<Hash<String,Object>>] | ||
|  |         attr_accessor :rows | ||
|  |        | ||
|  |         # The currency code of all monetary values produced in the report, including | ||
|  |         # values that are set by users (e.g., keyword bid settings) and metrics (e.g., | ||
|  |         # cost and revenue). The currency code of a report is determined by the ` | ||
|  |         # statisticsCurrency` field of the report request. | ||
|  |         # Corresponds to the JSON property `statisticsCurrencyCode` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :statistics_currency_code | ||
|  |        | ||
|  |         # If all statistics of the report are sourced from the same time zone, this | ||
|  |         # would be it. Otherwise the field is unset. | ||
|  |         # Corresponds to the JSON property `statisticsTimeZone` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :statistics_time_zone | ||
|  |        | ||
|  |         def initialize(**args) | ||
|  |            update!(**args) | ||
|  |         end | ||
|  |        | ||
|  |         # Update properties of this object | ||
|  |         def update!(**args) | ||
|  |           @files = args[:files] if args.key?(:files) | ||
|  |           @id = args[:id] if args.key?(:id) | ||
|  |           @is_report_ready = args[:is_report_ready] if args.key?(:is_report_ready) | ||
|  |           @kind = args[:kind] if args.key?(:kind) | ||
|  |           @request = args[:request] if args.key?(:request) | ||
|  |           @row_count = args[:row_count] if args.key?(:row_count) | ||
|  |           @rows = args[:rows] if args.key?(:rows) | ||
|  |           @statistics_currency_code = args[:statistics_currency_code] if args.key?(:statistics_currency_code) | ||
|  |           @statistics_time_zone = args[:statistics_time_zone] if args.key?(:statistics_time_zone) | ||
|  |         end | ||
|  |          | ||
|  |         #  | ||
|  |         class File | ||
|  |           include Google::Apis::Core::Hashable | ||
|  |          | ||
|  |           # The size of this report file in bytes. | ||
|  |           # Corresponds to the JSON property `byteCount` | ||
|  |           # @return [Fixnum] | ||
|  |           attr_accessor :byte_count | ||
|  |          | ||
|  |           # Use this url to download the report file. | ||
|  |           # Corresponds to the JSON property `url` | ||
|  |           # @return [String] | ||
|  |           attr_accessor :url | ||
|  |          | ||
|  |           def initialize(**args) | ||
|  |              update!(**args) | ||
|  |           end | ||
|  |          | ||
|  |           # Update properties of this object | ||
|  |           def update!(**args) | ||
|  |             @byte_count = args[:byte_count] if args.key?(:byte_count) | ||
|  |             @url = args[:url] if args.key?(:url) | ||
|  |           end | ||
|  |         end | ||
|  |       end | ||
|  |        | ||
|  |       # A request object used to create a DoubleClick Search report. | ||
|  |       class ReportApiColumnSpec | ||
|  |         include Google::Apis::Core::Hashable | ||
|  |        | ||
|  |         # Name of a DoubleClick Search column to include in the report. | ||
|  |         # Corresponds to the JSON property `columnName` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :column_name | ||
|  |        | ||
|  |         # Segments a report by a custom dimension. The report must be scoped to an | ||
|  |         # advertiser or lower, and the custom dimension must already be set up in | ||
|  |         # DoubleClick Search. The custom dimension name, which appears in DoubleClick | ||
|  |         # Search, is case sensitive.\ If used in a conversion report, returns the value | ||
|  |         # of the specified custom dimension for the given conversion, if set. This | ||
|  |         # column does not segment the conversion report. | ||
|  |         # Corresponds to the JSON property `customDimensionName` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :custom_dimension_name | ||
|  |        | ||
|  |         # Name of a custom metric to include in the report. The report must be scoped to | ||
|  |         # an advertiser or lower, and the custom metric must already be set up in | ||
|  |         # DoubleClick Search. The custom metric name, which appears in DoubleClick | ||
|  |         # Search, is case sensitive. | ||
|  |         # Corresponds to the JSON property `customMetricName` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :custom_metric_name | ||
|  |        | ||
|  |         # Inclusive day in YYYY-MM-DD format. When provided, this overrides the overall | ||
|  |         # time range of the report for this column only. Must be provided together with ` | ||
|  |         # startDate`. | ||
|  |         # Corresponds to the JSON property `endDate` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :end_date | ||
|  |        | ||
|  |         # Synchronous report only. Set to `true` to group by this column. Defaults to ` | ||
|  |         # false`. | ||
|  |         # Corresponds to the JSON property `groupByColumn` | ||
|  |         # @return [Boolean] | ||
|  |         attr_accessor :group_by_column | ||
|  |         alias_method :group_by_column?, :group_by_column | ||
|  |        | ||
|  |         # Text used to identify this column in the report output; defaults to ` | ||
|  |         # columnName` or `savedColumnName` when not specified. This can be used to | ||
|  |         # prevent collisions between DoubleClick Search columns and saved columns with | ||
|  |         # the same name. | ||
|  |         # Corresponds to the JSON property `headerText` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :header_text | ||
|  |        | ||
|  |         # The platform that is used to provide data for the custom dimension. Acceptable | ||
|  |         # values are "floodlight". | ||
|  |         # Corresponds to the JSON property `platformSource` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :platform_source | ||
|  |        | ||
|  |         # Returns metrics only for a specific type of product activity. Accepted values | ||
|  |         # are: - "`sold`": returns metrics only for products that were sold - "` | ||
|  |         # advertised`": returns metrics only for products that were advertised in a | ||
|  |         # Shopping campaign, and that might or might not have been sold | ||
|  |         # Corresponds to the JSON property `productReportPerspective` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :product_report_perspective | ||
|  |        | ||
|  |         # Name of a saved column to include in the report. The report must be scoped at | ||
|  |         # advertiser or lower, and this saved column must already be created in the | ||
|  |         # DoubleClick Search UI. | ||
|  |         # Corresponds to the JSON property `savedColumnName` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :saved_column_name | ||
|  |        | ||
|  |         # Inclusive date in YYYY-MM-DD format. When provided, this overrides the overall | ||
|  |         # time range of the report for this column only. Must be provided together with ` | ||
|  |         # endDate`. | ||
|  |         # Corresponds to the JSON property `startDate` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :start_date | ||
|  |        | ||
|  |         def initialize(**args) | ||
|  |            update!(**args) | ||
|  |         end | ||
|  |        | ||
|  |         # Update properties of this object | ||
|  |         def update!(**args) | ||
|  |           @column_name = args[:column_name] if args.key?(:column_name) | ||
|  |           @custom_dimension_name = args[:custom_dimension_name] if args.key?(:custom_dimension_name) | ||
|  |           @custom_metric_name = args[:custom_metric_name] if args.key?(:custom_metric_name) | ||
|  |           @end_date = args[:end_date] if args.key?(:end_date) | ||
|  |           @group_by_column = args[:group_by_column] if args.key?(:group_by_column) | ||
|  |           @header_text = args[:header_text] if args.key?(:header_text) | ||
|  |           @platform_source = args[:platform_source] if args.key?(:platform_source) | ||
|  |           @product_report_perspective = args[:product_report_perspective] if args.key?(:product_report_perspective) | ||
|  |           @saved_column_name = args[:saved_column_name] if args.key?(:saved_column_name) | ||
|  |           @start_date = args[:start_date] if args.key?(:start_date) | ||
|  |         end | ||
|  |       end | ||
|  |        | ||
|  |       # A request object used to create a DoubleClick Search report. | ||
|  |       class ReportRequest | ||
|  |         include Google::Apis::Core::Hashable | ||
|  |        | ||
|  |         # The columns to include in the report. This includes both DoubleClick Search | ||
|  |         # columns and saved columns. For DoubleClick Search columns, only the ` | ||
|  |         # columnName` parameter is required. For saved columns only the `savedColumnName` | ||
|  |         # parameter is required. Both `columnName` and `savedColumnName` cannot be set | ||
|  |         # in the same stanza.\ The maximum number of columns per request is 300. | ||
|  |         # Corresponds to the JSON property `columns` | ||
|  |         # @return [Array<Google::Apis::DoubleclicksearchV2::ReportApiColumnSpec>] | ||
|  |         attr_accessor :columns | ||
|  |        | ||
|  |         # Format that the report should be returned in. Currently `csv` or `tsv` is | ||
|  |         # supported. | ||
|  |         # Corresponds to the JSON property `downloadFormat` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :download_format | ||
|  |        | ||
|  |         # A list of filters to be applied to the report.\ The maximum number of filters | ||
|  |         # per request is 300. | ||
|  |         # Corresponds to the JSON property `filters` | ||
|  |         # @return [Array<Google::Apis::DoubleclicksearchV2::ReportRequest::Filter>] | ||
|  |         attr_accessor :filters | ||
|  |        | ||
|  |         # Determines if removed entities should be included in the report. Defaults to ` | ||
|  |         # false`. Deprecated, please use `includeRemovedEntities` instead. | ||
|  |         # Corresponds to the JSON property `includeDeletedEntities` | ||
|  |         # @return [Boolean] | ||
|  |         attr_accessor :include_deleted_entities | ||
|  |         alias_method :include_deleted_entities?, :include_deleted_entities | ||
|  |        | ||
|  |         # Determines if removed entities should be included in the report. Defaults to ` | ||
|  |         # false`. | ||
|  |         # Corresponds to the JSON property `includeRemovedEntities` | ||
|  |         # @return [Boolean] | ||
|  |         attr_accessor :include_removed_entities | ||
|  |         alias_method :include_removed_entities?, :include_removed_entities | ||
|  |        | ||
|  |         # Asynchronous report only. The maximum number of rows per report file. A large | ||
|  |         # report is split into many files based on this field. Acceptable values are ` | ||
|  |         # 1000000` to `100000000`, inclusive. | ||
|  |         # Corresponds to the JSON property `maxRowsPerFile` | ||
|  |         # @return [Fixnum] | ||
|  |         attr_accessor :max_rows_per_file | ||
|  |        | ||
|  |         # Synchronous report only. A list of columns and directions defining sorting to | ||
|  |         # be performed on the report rows.\ The maximum number of orderings per request | ||
|  |         # is 300. | ||
|  |         # Corresponds to the JSON property `orderBy` | ||
|  |         # @return [Array<Google::Apis::DoubleclicksearchV2::ReportRequest::OrderBy>] | ||
|  |         attr_accessor :order_by | ||
|  |        | ||
|  |         # The reportScope is a set of IDs that are used to determine which subset of | ||
|  |         # entities will be returned in the report. The full lineage of IDs from the | ||
|  |         # lowest scoped level desired up through agency is required. | ||
|  |         # Corresponds to the JSON property `reportScope` | ||
|  |         # @return [Google::Apis::DoubleclicksearchV2::ReportRequest::ReportScope] | ||
|  |         attr_accessor :report_scope | ||
|  |        | ||
|  |         # Determines the type of rows that are returned in the report. For example, if | ||
|  |         # you specify `reportType: keyword`, each row in the report will contain data | ||
|  |         # about a keyword. See the [Types of Reports](/search-ads/v2/report-types/) | ||
|  |         # reference for the columns that are available for each type. | ||
|  |         # Corresponds to the JSON property `reportType` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :report_type | ||
|  |        | ||
|  |         # Synchronous report only. The maximum number of rows to return; additional rows | ||
|  |         # are dropped. Acceptable values are `0` to `10000`, inclusive. Defaults to ` | ||
|  |         # 10000`. | ||
|  |         # Corresponds to the JSON property `rowCount` | ||
|  |         # @return [Fixnum] | ||
|  |         attr_accessor :row_count | ||
|  |        | ||
|  |         # Synchronous report only. Zero-based index of the first row to return. | ||
|  |         # Acceptable values are `0` to `50000`, inclusive. Defaults to `0`. | ||
|  |         # Corresponds to the JSON property `startRow` | ||
|  |         # @return [Fixnum] | ||
|  |         attr_accessor :start_row | ||
|  |        | ||
|  |         # Specifies the currency in which monetary will be returned. Possible values are: | ||
|  |         # `usd`, `agency` (valid if the report is scoped to agency or lower), ` | ||
|  |         # advertiser` (valid if the report is scoped to * advertiser or lower), or ` | ||
|  |         # account` (valid if the report is scoped to engine account or lower). | ||
|  |         # Corresponds to the JSON property `statisticsCurrency` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :statistics_currency | ||
|  |        | ||
|  |         # If metrics are requested in a report, this argument will be used to restrict | ||
|  |         # the metrics to a specific time range. | ||
|  |         # Corresponds to the JSON property `timeRange` | ||
|  |         # @return [Google::Apis::DoubleclicksearchV2::ReportRequest::TimeRange] | ||
|  |         attr_accessor :time_range | ||
|  |        | ||
|  |         # If `true`, the report would only be created if all the requested stat data are | ||
|  |         # sourced from a single timezone. Defaults to `false`. | ||
|  |         # Corresponds to the JSON property `verifySingleTimeZone` | ||
|  |         # @return [Boolean] | ||
|  |         attr_accessor :verify_single_time_zone | ||
|  |         alias_method :verify_single_time_zone?, :verify_single_time_zone | ||
|  |        | ||
|  |         def initialize(**args) | ||
|  |            update!(**args) | ||
|  |         end | ||
|  |        | ||
|  |         # Update properties of this object | ||
|  |         def update!(**args) | ||
|  |           @columns = args[:columns] if args.key?(:columns) | ||
|  |           @download_format = args[:download_format] if args.key?(:download_format) | ||
|  |           @filters = args[:filters] if args.key?(:filters) | ||
|  |           @include_deleted_entities = args[:include_deleted_entities] if args.key?(:include_deleted_entities) | ||
|  |           @include_removed_entities = args[:include_removed_entities] if args.key?(:include_removed_entities) | ||
|  |           @max_rows_per_file = args[:max_rows_per_file] if args.key?(:max_rows_per_file) | ||
|  |           @order_by = args[:order_by] if args.key?(:order_by) | ||
|  |           @report_scope = args[:report_scope] if args.key?(:report_scope) | ||
|  |           @report_type = args[:report_type] if args.key?(:report_type) | ||
|  |           @row_count = args[:row_count] if args.key?(:row_count) | ||
|  |           @start_row = args[:start_row] if args.key?(:start_row) | ||
|  |           @statistics_currency = args[:statistics_currency] if args.key?(:statistics_currency) | ||
|  |           @time_range = args[:time_range] if args.key?(:time_range) | ||
|  |           @verify_single_time_zone = args[:verify_single_time_zone] if args.key?(:verify_single_time_zone) | ||
|  |         end | ||
|  |          | ||
|  |         #  | ||
|  |         class Filter | ||
|  |           include Google::Apis::Core::Hashable | ||
|  |          | ||
|  |           # A request object used to create a DoubleClick Search report. | ||
|  |           # Corresponds to the JSON property `column` | ||
|  |           # @return [Google::Apis::DoubleclicksearchV2::ReportApiColumnSpec] | ||
|  |           attr_accessor :column | ||
|  |          | ||
|  |           # Operator to use in the filter. See the filter reference for a list of | ||
|  |           # available operators. | ||
|  |           # Corresponds to the JSON property `operator` | ||
|  |           # @return [String] | ||
|  |           attr_accessor :operator | ||
|  |          | ||
|  |           # A list of values to filter the column value against.\ The maximum number of | ||
|  |           # filter values per request is 300. | ||
|  |           # Corresponds to the JSON property `values` | ||
|  |           # @return [Array<Object>] | ||
|  |           attr_accessor :values | ||
|  |          | ||
|  |           def initialize(**args) | ||
|  |              update!(**args) | ||
|  |           end | ||
|  |          | ||
|  |           # Update properties of this object | ||
|  |           def update!(**args) | ||
|  |             @column = args[:column] if args.key?(:column) | ||
|  |             @operator = args[:operator] if args.key?(:operator) | ||
|  |             @values = args[:values] if args.key?(:values) | ||
|  |           end | ||
|  |         end | ||
|  |          | ||
|  |         #  | ||
|  |         class OrderBy | ||
|  |           include Google::Apis::Core::Hashable | ||
|  |          | ||
|  |           # A request object used to create a DoubleClick Search report. | ||
|  |           # Corresponds to the JSON property `column` | ||
|  |           # @return [Google::Apis::DoubleclicksearchV2::ReportApiColumnSpec] | ||
|  |           attr_accessor :column | ||
|  |          | ||
|  |           # The sort direction, which is either `ascending` or `descending`. | ||
|  |           # Corresponds to the JSON property `sortOrder` | ||
|  |           # @return [String] | ||
|  |           attr_accessor :sort_order | ||
|  |          | ||
|  |           def initialize(**args) | ||
|  |              update!(**args) | ||
|  |           end | ||
|  |          | ||
|  |           # Update properties of this object | ||
|  |           def update!(**args) | ||
|  |             @column = args[:column] if args.key?(:column) | ||
|  |             @sort_order = args[:sort_order] if args.key?(:sort_order) | ||
|  |           end | ||
|  |         end | ||
|  |          | ||
|  |         # The reportScope is a set of IDs that are used to determine which subset of | ||
|  |         # entities will be returned in the report. The full lineage of IDs from the | ||
|  |         # lowest scoped level desired up through agency is required. | ||
|  |         class ReportScope | ||
|  |           include Google::Apis::Core::Hashable | ||
|  |          | ||
|  |           # DS ad group ID. | ||
|  |           # Corresponds to the JSON property `adGroupId` | ||
|  |           # @return [Fixnum] | ||
|  |           attr_accessor :ad_group_id | ||
|  |          | ||
|  |           # DS ad ID. | ||
|  |           # Corresponds to the JSON property `adId` | ||
|  |           # @return [Fixnum] | ||
|  |           attr_accessor :ad_id | ||
|  |          | ||
|  |           # DS advertiser ID. | ||
|  |           # Corresponds to the JSON property `advertiserId` | ||
|  |           # @return [Fixnum] | ||
|  |           attr_accessor :advertiser_id | ||
|  |          | ||
|  |           # DS agency ID. | ||
|  |           # Corresponds to the JSON property `agencyId` | ||
|  |           # @return [Fixnum] | ||
|  |           attr_accessor :agency_id | ||
|  |          | ||
|  |           # DS campaign ID. | ||
|  |           # Corresponds to the JSON property `campaignId` | ||
|  |           # @return [Fixnum] | ||
|  |           attr_accessor :campaign_id | ||
|  |          | ||
|  |           # DS engine account ID. | ||
|  |           # Corresponds to the JSON property `engineAccountId` | ||
|  |           # @return [Fixnum] | ||
|  |           attr_accessor :engine_account_id | ||
|  |          | ||
|  |           # DS keyword ID. | ||
|  |           # Corresponds to the JSON property `keywordId` | ||
|  |           # @return [Fixnum] | ||
|  |           attr_accessor :keyword_id | ||
|  |          | ||
|  |           def initialize(**args) | ||
|  |              update!(**args) | ||
|  |           end | ||
|  |          | ||
|  |           # Update properties of this object | ||
|  |           def update!(**args) | ||
|  |             @ad_group_id = args[:ad_group_id] if args.key?(:ad_group_id) | ||
|  |             @ad_id = args[:ad_id] if args.key?(:ad_id) | ||
|  |             @advertiser_id = args[:advertiser_id] if args.key?(:advertiser_id) | ||
|  |             @agency_id = args[:agency_id] if args.key?(:agency_id) | ||
|  |             @campaign_id = args[:campaign_id] if args.key?(:campaign_id) | ||
|  |             @engine_account_id = args[:engine_account_id] if args.key?(:engine_account_id) | ||
|  |             @keyword_id = args[:keyword_id] if args.key?(:keyword_id) | ||
|  |           end | ||
|  |         end | ||
|  |          | ||
|  |         # If metrics are requested in a report, this argument will be used to restrict | ||
|  |         # the metrics to a specific time range. | ||
|  |         class TimeRange | ||
|  |           include Google::Apis::Core::Hashable | ||
|  |          | ||
|  |           # Inclusive UTC timestamp in RFC format, e.g., `2013-07-16T10:16:23.555Z`. See | ||
|  |           # additional references on how changed attribute reports work. | ||
|  |           # Corresponds to the JSON property `changedAttributesSinceTimestamp` | ||
|  |           # @return [String] | ||
|  |           attr_accessor :changed_attributes_since_timestamp | ||
|  |          | ||
|  |           # Inclusive UTC timestamp in RFC format, e.g., `2013-07-16T10:16:23.555Z`. See | ||
|  |           # additional references on how changed metrics reports work. | ||
|  |           # Corresponds to the JSON property `changedMetricsSinceTimestamp` | ||
|  |           # @return [String] | ||
|  |           attr_accessor :changed_metrics_since_timestamp | ||
|  |          | ||
|  |           # Inclusive date in YYYY-MM-DD format. | ||
|  |           # Corresponds to the JSON property `endDate` | ||
|  |           # @return [String] | ||
|  |           attr_accessor :end_date | ||
|  |          | ||
|  |           # Inclusive date in YYYY-MM-DD format. | ||
|  |           # Corresponds to the JSON property `startDate` | ||
|  |           # @return [String] | ||
|  |           attr_accessor :start_date | ||
|  |          | ||
|  |           def initialize(**args) | ||
|  |              update!(**args) | ||
|  |           end | ||
|  |          | ||
|  |           # Update properties of this object | ||
|  |           def update!(**args) | ||
|  |             @changed_attributes_since_timestamp = args[:changed_attributes_since_timestamp] if args.key?(:changed_attributes_since_timestamp) | ||
|  |             @changed_metrics_since_timestamp = args[:changed_metrics_since_timestamp] if args.key?(:changed_metrics_since_timestamp) | ||
|  |             @end_date = args[:end_date] if args.key?(:end_date) | ||
|  |             @start_date = args[:start_date] if args.key?(:start_date) | ||
|  |           end | ||
|  |         end | ||
|  |       end | ||
|  |        | ||
|  |       # A saved column | ||
|  |       class SavedColumn | ||
|  |         include Google::Apis::Core::Hashable | ||
|  |        | ||
|  |         # Identifies this as a SavedColumn resource. Value: the fixed string | ||
|  |         # doubleclicksearch#savedColumn. | ||
|  |         # Corresponds to the JSON property `kind` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :kind | ||
|  |        | ||
|  |         # The name of the saved column. | ||
|  |         # Corresponds to the JSON property `savedColumnName` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :saved_column_name | ||
|  |        | ||
|  |         # The type of data this saved column will produce. | ||
|  |         # Corresponds to the JSON property `type` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :type | ||
|  |        | ||
|  |         def initialize(**args) | ||
|  |            update!(**args) | ||
|  |         end | ||
|  |        | ||
|  |         # Update properties of this object | ||
|  |         def update!(**args) | ||
|  |           @kind = args[:kind] if args.key?(:kind) | ||
|  |           @saved_column_name = args[:saved_column_name] if args.key?(:saved_column_name) | ||
|  |           @type = args[:type] if args.key?(:type) | ||
|  |         end | ||
|  |       end | ||
|  |        | ||
|  |       # A list of saved columns. Advertisers create saved columns to report on | ||
|  |       # Floodlight activities, Google Analytics goals, or custom KPIs. To request | ||
|  |       # reports with saved columns, you'll need the saved column names that are | ||
|  |       # available from this list. | ||
|  |       class SavedColumnList | ||
|  |         include Google::Apis::Core::Hashable | ||
|  |        | ||
|  |         # The saved columns being requested. | ||
|  |         # Corresponds to the JSON property `items` | ||
|  |         # @return [Array<Google::Apis::DoubleclicksearchV2::SavedColumn>] | ||
|  |         attr_accessor :items | ||
|  |        | ||
|  |         # Identifies this as a SavedColumnList resource. Value: the fixed string | ||
|  |         # doubleclicksearch#savedColumnList. | ||
|  |         # Corresponds to the JSON property `kind` | ||
|  |         # @return [String] | ||
|  |         attr_accessor :kind | ||
|  |        | ||
|  |         def initialize(**args) | ||
|  |            update!(**args) | ||
|  |         end | ||
|  |        | ||
|  |         # Update properties of this object | ||
|  |         def update!(**args) | ||
|  |           @items = args[:items] if args.key?(:items) | ||
|  |           @kind = args[:kind] if args.key?(:kind) | ||
|  |         end | ||
|  |       end | ||
|  |        | ||
|  |       # The request to update availability. | ||
|  |       class UpdateAvailabilityRequest | ||
|  |         include Google::Apis::Core::Hashable | ||
|  |        | ||
|  |         # The availabilities being requested. | ||
|  |         # Corresponds to the JSON property `availabilities` | ||
|  |         # @return [Array<Google::Apis::DoubleclicksearchV2::Availability>] | ||
|  |         attr_accessor :availabilities | ||
|  |        | ||
|  |         def initialize(**args) | ||
|  |            update!(**args) | ||
|  |         end | ||
|  |        | ||
|  |         # Update properties of this object | ||
|  |         def update!(**args) | ||
|  |           @availabilities = args[:availabilities] if args.key?(:availabilities) | ||
|  |         end | ||
|  |       end | ||
|  |        | ||
|  |       # The response to a update availability request. | ||
|  |       class UpdateAvailabilityResponse | ||
|  |         include Google::Apis::Core::Hashable | ||
|  |        | ||
|  |         # The availabilities being returned. | ||
|  |         # Corresponds to the JSON property `availabilities` | ||
|  |         # @return [Array<Google::Apis::DoubleclicksearchV2::Availability>] | ||
|  |         attr_accessor :availabilities | ||
|  |        | ||
|  |         def initialize(**args) | ||
|  |            update!(**args) | ||
|  |         end | ||
|  |        | ||
|  |         # Update properties of this object | ||
|  |         def update!(**args) | ||
|  |           @availabilities = args[:availabilities] if args.key?(:availabilities) | ||
|  |         end | ||
|  |       end | ||
|  |     end | ||
|  |   end | ||
|  | end |