1344 lines
56 KiB
Ruby
1344 lines
56 KiB
Ruby
# Copyright 2015 Google Inc.
|
|
#
|
|
# 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 RealtimebiddingV1
|
|
|
|
# Detected ad technology provider information.
|
|
class AdTechnologyProviders
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# The detected ad technology provider IDs for this creative. See https://storage.
|
|
# googleapis.com/adx-rtb-dictionaries/providers.csv for mapping of provider ID
|
|
# to provided name, a privacy policy URL, and a list of domains which can be
|
|
# attributed to the provider. If the creative contains provider IDs that are
|
|
# outside of those listed in the `BidRequest.adslot.consented_providers_settings.
|
|
# consented_providers` field on the [Google bid protocol](https://developers.
|
|
# google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) and the `
|
|
# BidRequest.user.ext.consented_providers_settings.consented_providers` field on
|
|
# the [OpenRTB protocol](https://developers.google.com/authorized-buyers/rtb/
|
|
# downloads/openrtb-adx-proto), and a bid is submitted with that creative for an
|
|
# impression that will serve to an EEA user, the bid will be filtered before the
|
|
# auction.
|
|
# Corresponds to the JSON property `detectedProviderIds`
|
|
# @return [Array<Fixnum>]
|
|
attr_accessor :detected_provider_ids
|
|
|
|
# Whether the creative contains an unidentified ad technology provider. If true
|
|
# for a given creative, any bid submitted with that creative for an impression
|
|
# that will serve to an EEA user will be filtered before the auction.
|
|
# Corresponds to the JSON property `hasUnidentifiedProvider`
|
|
# @return [Boolean]
|
|
attr_accessor :has_unidentified_provider
|
|
alias_method :has_unidentified_provider?, :has_unidentified_provider
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@detected_provider_ids = args[:detected_provider_ids] if args.key?(:detected_provider_ids)
|
|
@has_unidentified_provider = args[:has_unidentified_provider] if args.key?(:has_unidentified_provider)
|
|
end
|
|
end
|
|
|
|
# Detected advertiser and brand information.
|
|
class AdvertiserAndBrand
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# See https://storage.googleapis.com/adx-rtb-dictionaries/advertisers.txt for
|
|
# the list of possible values. Can be used to filter the response of the
|
|
# creatives.list method.
|
|
# Corresponds to the JSON property `advertiserId`
|
|
# @return [Fixnum]
|
|
attr_accessor :advertiser_id
|
|
|
|
# Advertiser name. Can be used to filter the response of the creatives.list
|
|
# method.
|
|
# Corresponds to the JSON property `advertiserName`
|
|
# @return [String]
|
|
attr_accessor :advertiser_name
|
|
|
|
# Detected brand ID or zero if no brand has been detected. See https://storage.
|
|
# googleapis.com/adx-rtb-dictionaries/brands.txt for the list of possible values.
|
|
# Can be used to filter the response of the creatives.list method.
|
|
# Corresponds to the JSON property `brandId`
|
|
# @return [Fixnum]
|
|
attr_accessor :brand_id
|
|
|
|
# Brand name. Can be used to filter the response of the creatives.list method.
|
|
# Corresponds to the JSON property `brandName`
|
|
# @return [String]
|
|
attr_accessor :brand_name
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@advertiser_id = args[:advertiser_id] if args.key?(:advertiser_id)
|
|
@advertiser_name = args[:advertiser_name] if args.key?(:advertiser_name)
|
|
@brand_id = args[:brand_id] if args.key?(:brand_id)
|
|
@brand_name = args[:brand_name] if args.key?(:brand_name)
|
|
end
|
|
end
|
|
|
|
# A request to close a specified user list.
|
|
class CloseUserListRequest
|
|
include Google::Apis::Core::Hashable
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
end
|
|
end
|
|
|
|
# A creative and its classification data.
|
|
class Creative
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# Output only. ID of the buyer account that this creative is owned by. Can be
|
|
# used to filter the response of the creatives.list method with equality and
|
|
# inequality check.
|
|
# Corresponds to the JSON property `accountId`
|
|
# @return [Fixnum]
|
|
attr_accessor :account_id
|
|
|
|
# The link to AdChoices destination page. This is only supported for native ads.
|
|
# Corresponds to the JSON property `adChoicesDestinationUrl`
|
|
# @return [String]
|
|
attr_accessor :ad_choices_destination_url
|
|
|
|
# The name of the company being advertised in the creative. Can be used to
|
|
# filter the response of the creatives.list method.
|
|
# Corresponds to the JSON property `advertiserName`
|
|
# @return [String]
|
|
attr_accessor :advertiser_name
|
|
|
|
# The agency ID for this creative.
|
|
# Corresponds to the JSON property `agencyId`
|
|
# @return [Fixnum]
|
|
attr_accessor :agency_id
|
|
|
|
# Output only. The last update timestamp of the creative via API.
|
|
# Corresponds to the JSON property `apiUpdateTime`
|
|
# @return [String]
|
|
attr_accessor :api_update_time
|
|
|
|
# Output only. The format of this creative. Can be used to filter the response
|
|
# of the creatives.list method.
|
|
# Corresponds to the JSON property `creativeFormat`
|
|
# @return [String]
|
|
attr_accessor :creative_format
|
|
|
|
# Buyer-specific creative ID that references this creative in bid responses.
|
|
# This field is Ignored in update operations. Can be used to filter the response
|
|
# of the creatives.list method. The maximum length of the creative ID is 128
|
|
# bytes.
|
|
# Corresponds to the JSON property `creativeId`
|
|
# @return [String]
|
|
attr_accessor :creative_id
|
|
|
|
# Top level status and detected attributes of a creative.
|
|
# Corresponds to the JSON property `creativeServingDecision`
|
|
# @return [Google::Apis::RealtimebiddingV1::CreativeServingDecision]
|
|
attr_accessor :creative_serving_decision
|
|
|
|
# Output only. IDs of all of the deals with which this creative has been used in
|
|
# bidding. Can be used to filter the response of the creatives.list method.
|
|
# Corresponds to the JSON property `dealIds`
|
|
# @return [Array<String>]
|
|
attr_accessor :deal_ids
|
|
|
|
# All declared attributes for the ads that may be shown from this creative. Can
|
|
# be used to filter the response of the creatives.list method. If the `
|
|
# excluded_attribute` field of a [bid request](https://developers.google.com/
|
|
# authorized-buyers/rtb/downloads/realtime-bidding-proto") contains one of the
|
|
# attributes that were declared or detected for a given creative, and a bid is
|
|
# submitted with that creative, the bid will be filtered before the auction.
|
|
# Corresponds to the JSON property `declaredAttributes`
|
|
# @return [Array<String>]
|
|
attr_accessor :declared_attributes
|
|
|
|
# The set of declared destination URLs for the creative. Can be used to filter
|
|
# the response of the creatives.list method.
|
|
# Corresponds to the JSON property `declaredClickThroughUrls`
|
|
# @return [Array<String>]
|
|
attr_accessor :declared_click_through_urls
|
|
|
|
# All declared restricted categories for the ads that may be shown from this
|
|
# creative. Can be used to filter the response of the creatives.list method.
|
|
# Corresponds to the JSON property `declaredRestrictedCategories`
|
|
# @return [Array<String>]
|
|
attr_accessor :declared_restricted_categories
|
|
|
|
# IDs for the declared ad technology vendors that may be used by this creative.
|
|
# See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt for
|
|
# possible values. Can be used to filter the response of the creatives.list
|
|
# method.
|
|
# Corresponds to the JSON property `declaredVendorIds`
|
|
# @return [Array<Fixnum>]
|
|
attr_accessor :declared_vendor_ids
|
|
|
|
# HTML content for a creative.
|
|
# Corresponds to the JSON property `html`
|
|
# @return [Google::Apis::RealtimebiddingV1::HtmlContent]
|
|
attr_accessor :html
|
|
|
|
# The set of URLs to be called to record an impression.
|
|
# Corresponds to the JSON property `impressionTrackingUrls`
|
|
# @return [Array<String>]
|
|
attr_accessor :impression_tracking_urls
|
|
|
|
# Output only. Name of the creative. Follows the pattern `buyers/`buyer`/
|
|
# creatives/`creative``, where ``buyer`` represents the account ID of the buyer
|
|
# who owns the creative, and ``creative`` is the buyer-specific creative ID that
|
|
# references this creative in the bid response.
|
|
# Corresponds to the JSON property `name`
|
|
# @return [String]
|
|
attr_accessor :name
|
|
|
|
# Native content for a creative.
|
|
# Corresponds to the JSON property `native`
|
|
# @return [Google::Apis::RealtimebiddingV1::NativeContent]
|
|
attr_accessor :native
|
|
|
|
# All restricted categories for the ads that may be shown from this creative.
|
|
# Corresponds to the JSON property `restrictedCategories`
|
|
# @return [Array<String>]
|
|
attr_accessor :restricted_categories
|
|
|
|
# Output only. The version of this creative. Version for a new creative is 1 and
|
|
# it increments during subsequent creative updates.
|
|
# Corresponds to the JSON property `version`
|
|
# @return [Fixnum]
|
|
attr_accessor :version
|
|
|
|
# Video content for a creative.
|
|
# Corresponds to the JSON property `video`
|
|
# @return [Google::Apis::RealtimebiddingV1::VideoContent]
|
|
attr_accessor :video
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@account_id = args[:account_id] if args.key?(:account_id)
|
|
@ad_choices_destination_url = args[:ad_choices_destination_url] if args.key?(:ad_choices_destination_url)
|
|
@advertiser_name = args[:advertiser_name] if args.key?(:advertiser_name)
|
|
@agency_id = args[:agency_id] if args.key?(:agency_id)
|
|
@api_update_time = args[:api_update_time] if args.key?(:api_update_time)
|
|
@creative_format = args[:creative_format] if args.key?(:creative_format)
|
|
@creative_id = args[:creative_id] if args.key?(:creative_id)
|
|
@creative_serving_decision = args[:creative_serving_decision] if args.key?(:creative_serving_decision)
|
|
@deal_ids = args[:deal_ids] if args.key?(:deal_ids)
|
|
@declared_attributes = args[:declared_attributes] if args.key?(:declared_attributes)
|
|
@declared_click_through_urls = args[:declared_click_through_urls] if args.key?(:declared_click_through_urls)
|
|
@declared_restricted_categories = args[:declared_restricted_categories] if args.key?(:declared_restricted_categories)
|
|
@declared_vendor_ids = args[:declared_vendor_ids] if args.key?(:declared_vendor_ids)
|
|
@html = args[:html] if args.key?(:html)
|
|
@impression_tracking_urls = args[:impression_tracking_urls] if args.key?(:impression_tracking_urls)
|
|
@name = args[:name] if args.key?(:name)
|
|
@native = args[:native] if args.key?(:native)
|
|
@restricted_categories = args[:restricted_categories] if args.key?(:restricted_categories)
|
|
@version = args[:version] if args.key?(:version)
|
|
@video = args[:video] if args.key?(:video)
|
|
end
|
|
end
|
|
|
|
# Top level status and detected attributes of a creative.
|
|
class CreativeServingDecision
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# Detected ad technology provider information.
|
|
# Corresponds to the JSON property `adTechnologyProviders`
|
|
# @return [Google::Apis::RealtimebiddingV1::AdTechnologyProviders]
|
|
attr_accessor :ad_technology_providers
|
|
|
|
# Serving status of the creative for a transaction type or a region.
|
|
# Corresponds to the JSON property `chinaServingStatus`
|
|
# @return [Google::Apis::RealtimebiddingV1::ServingStatus]
|
|
attr_accessor :china_serving_status
|
|
|
|
# Serving status of the creative for a transaction type or a region.
|
|
# Corresponds to the JSON property `dealsServingStatus`
|
|
# @return [Google::Apis::RealtimebiddingV1::ServingStatus]
|
|
attr_accessor :deals_serving_status
|
|
|
|
# Detected advertisers and brands.
|
|
# Corresponds to the JSON property `detectedAdvertisers`
|
|
# @return [Array<Google::Apis::RealtimebiddingV1::AdvertiserAndBrand>]
|
|
attr_accessor :detected_advertisers
|
|
|
|
# Publisher-excludable attributes that were detected for this creative. Can be
|
|
# used to filter the response of the creatives.list method. If the `
|
|
# excluded_attribute` field of a [bid request](https://developers.google.com/
|
|
# authorized-buyers/rtb/downloads/realtime-bidding-proto) contains one of the
|
|
# attributes that were declared or detected for a given creative, and a bid is
|
|
# submitted with that creative, the bid will be filtered before the auction.
|
|
# Corresponds to the JSON property `detectedAttributes`
|
|
# @return [Array<String>]
|
|
attr_accessor :detected_attributes
|
|
|
|
# The set of detected destination URLs for the creative. Can be used to filter
|
|
# the response of the creatives.list method.
|
|
# Corresponds to the JSON property `detectedClickThroughUrls`
|
|
# @return [Array<String>]
|
|
attr_accessor :detected_click_through_urls
|
|
|
|
# The detected domains for this creative.
|
|
# Corresponds to the JSON property `detectedDomains`
|
|
# @return [Array<String>]
|
|
attr_accessor :detected_domains
|
|
|
|
# The detected languages for this creative. The order is arbitrary. The codes
|
|
# are 2 or 5 characters and are documented at https://developers.google.com/
|
|
# adwords/api/docs/appendix/languagecodes. Can be used to filter the response of
|
|
# the creatives.list method.
|
|
# Corresponds to the JSON property `detectedLanguages`
|
|
# @return [Array<String>]
|
|
attr_accessor :detected_languages
|
|
|
|
# Detected product categories, if any. See the ad-product-categories.txt file in
|
|
# the technical documentation for a list of IDs. Can be used to filter the
|
|
# response of the creatives.list method.
|
|
# Corresponds to the JSON property `detectedProductCategories`
|
|
# @return [Array<Fixnum>]
|
|
attr_accessor :detected_product_categories
|
|
|
|
# Detected sensitive categories, if any. Can be used to filter the response of
|
|
# the creatives.list method. See the ad-sensitive-categories.txt file in the
|
|
# technical documentation for a list of IDs. You should use these IDs along with
|
|
# the excluded-sensitive-category field in the bid request to filter your bids.
|
|
# Corresponds to the JSON property `detectedSensitiveCategories`
|
|
# @return [Array<Fixnum>]
|
|
attr_accessor :detected_sensitive_categories
|
|
|
|
# IDs of the ad technology vendors that were detected to be used by this
|
|
# creative. See https://storage.googleapis.com/adx-rtb-dictionaries/vendors.txt
|
|
# for possible values. Can be used to filter the response of the creatives.list
|
|
# method. If the `allowed_vendor_type` field of a [bid request](https://
|
|
# developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto)
|
|
# does not contain one of the vendor type IDs that were declared or detected for
|
|
# a given creative, and a bid is submitted with that creative, the bid will be
|
|
# filtered before the auction.
|
|
# Corresponds to the JSON property `detectedVendorIds`
|
|
# @return [Array<Fixnum>]
|
|
attr_accessor :detected_vendor_ids
|
|
|
|
# The last time the creative status was updated. Can be used to filter the
|
|
# response of the creatives.list method.
|
|
# Corresponds to the JSON property `lastStatusUpdate`
|
|
# @return [String]
|
|
attr_accessor :last_status_update
|
|
|
|
# Serving status of the creative for a transaction type or a region.
|
|
# Corresponds to the JSON property `openAuctionServingStatus`
|
|
# @return [Google::Apis::RealtimebiddingV1::ServingStatus]
|
|
attr_accessor :open_auction_serving_status
|
|
|
|
# Serving status of the creative for a transaction type or a region.
|
|
# Corresponds to the JSON property `russiaServingStatus`
|
|
# @return [Google::Apis::RealtimebiddingV1::ServingStatus]
|
|
attr_accessor :russia_serving_status
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@ad_technology_providers = args[:ad_technology_providers] if args.key?(:ad_technology_providers)
|
|
@china_serving_status = args[:china_serving_status] if args.key?(:china_serving_status)
|
|
@deals_serving_status = args[:deals_serving_status] if args.key?(:deals_serving_status)
|
|
@detected_advertisers = args[:detected_advertisers] if args.key?(:detected_advertisers)
|
|
@detected_attributes = args[:detected_attributes] if args.key?(:detected_attributes)
|
|
@detected_click_through_urls = args[:detected_click_through_urls] if args.key?(:detected_click_through_urls)
|
|
@detected_domains = args[:detected_domains] if args.key?(:detected_domains)
|
|
@detected_languages = args[:detected_languages] if args.key?(:detected_languages)
|
|
@detected_product_categories = args[:detected_product_categories] if args.key?(:detected_product_categories)
|
|
@detected_sensitive_categories = args[:detected_sensitive_categories] if args.key?(:detected_sensitive_categories)
|
|
@detected_vendor_ids = args[:detected_vendor_ids] if args.key?(:detected_vendor_ids)
|
|
@last_status_update = args[:last_status_update] if args.key?(:last_status_update)
|
|
@open_auction_serving_status = args[:open_auction_serving_status] if args.key?(:open_auction_serving_status)
|
|
@russia_serving_status = args[:russia_serving_status] if args.key?(:russia_serving_status)
|
|
end
|
|
end
|
|
|
|
# Represents a whole or partial calendar date, e.g. a birthday. The time of day
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent: * A full
|
|
# date, with non-zero year, month and day values * A month and day value, with a
|
|
# zero year, e.g. an anniversary * A year on its own, with zero month and day
|
|
# values * A year and month value, with a zero day, e.g. a credit card
|
|
# expiration date Related types are google.type.TimeOfDay and `google.protobuf.
|
|
# Timestamp`.
|
|
class Date
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# Day of month. Must be from 1 to 31 and valid for the year and month, or 0 if
|
|
# specifying a year by itself or a year and month where the day is not
|
|
# significant.
|
|
# Corresponds to the JSON property `day`
|
|
# @return [Fixnum]
|
|
attr_accessor :day
|
|
|
|
# Month of year. Must be from 1 to 12, or 0 if specifying a year without a month
|
|
# and day.
|
|
# Corresponds to the JSON property `month`
|
|
# @return [Fixnum]
|
|
attr_accessor :month
|
|
|
|
# Year of date. Must be from 1 to 9999, or 0 if specifying a date without a year.
|
|
# Corresponds to the JSON property `year`
|
|
# @return [Fixnum]
|
|
attr_accessor :year
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@day = args[:day] if args.key?(:day)
|
|
@month = args[:month] if args.key?(:month)
|
|
@year = args[:year] if args.key?(:year)
|
|
end
|
|
end
|
|
|
|
# Evidence that the creative's destination URL was not crawlable by Google.
|
|
class DestinationNotCrawlableEvidence
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# Approximate time of the crawl.
|
|
# Corresponds to the JSON property `crawlTime`
|
|
# @return [String]
|
|
attr_accessor :crawl_time
|
|
|
|
# Destination URL that was attempted to be crawled.
|
|
# Corresponds to the JSON property `crawledUrl`
|
|
# @return [String]
|
|
attr_accessor :crawled_url
|
|
|
|
# Reason of destination not crawlable.
|
|
# Corresponds to the JSON property `reason`
|
|
# @return [String]
|
|
attr_accessor :reason
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@crawl_time = args[:crawl_time] if args.key?(:crawl_time)
|
|
@crawled_url = args[:crawled_url] if args.key?(:crawled_url)
|
|
@reason = args[:reason] if args.key?(:reason)
|
|
end
|
|
end
|
|
|
|
# Evidence of the creative's destination URL not functioning properly or having
|
|
# been incorrectly set up.
|
|
class DestinationNotWorkingEvidence
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# DNS lookup errors.
|
|
# Corresponds to the JSON property `dnsError`
|
|
# @return [String]
|
|
attr_accessor :dns_error
|
|
|
|
# The full non-working URL.
|
|
# Corresponds to the JSON property `expandedUrl`
|
|
# @return [String]
|
|
attr_accessor :expanded_url
|
|
|
|
# HTTP error code (e.g. 404 or 5xx)
|
|
# Corresponds to the JSON property `httpError`
|
|
# @return [Fixnum]
|
|
attr_accessor :http_error
|
|
|
|
# Page was crawled successfully, but was detected as either a page with no
|
|
# content or an error page.
|
|
# Corresponds to the JSON property `invalidPage`
|
|
# @return [String]
|
|
attr_accessor :invalid_page
|
|
|
|
# Approximate time when the ad destination was last checked.
|
|
# Corresponds to the JSON property `lastCheckTime`
|
|
# @return [String]
|
|
attr_accessor :last_check_time
|
|
|
|
# Platform of the non-working URL.
|
|
# Corresponds to the JSON property `platform`
|
|
# @return [String]
|
|
attr_accessor :platform
|
|
|
|
# HTTP redirect chain error.
|
|
# Corresponds to the JSON property `redirectionError`
|
|
# @return [String]
|
|
attr_accessor :redirection_error
|
|
|
|
# Rejected because of malformed URLs or invalid requests.
|
|
# Corresponds to the JSON property `urlRejected`
|
|
# @return [String]
|
|
attr_accessor :url_rejected
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@dns_error = args[:dns_error] if args.key?(:dns_error)
|
|
@expanded_url = args[:expanded_url] if args.key?(:expanded_url)
|
|
@http_error = args[:http_error] if args.key?(:http_error)
|
|
@invalid_page = args[:invalid_page] if args.key?(:invalid_page)
|
|
@last_check_time = args[:last_check_time] if args.key?(:last_check_time)
|
|
@platform = args[:platform] if args.key?(:platform)
|
|
@redirection_error = args[:redirection_error] if args.key?(:redirection_error)
|
|
@url_rejected = args[:url_rejected] if args.key?(:url_rejected)
|
|
end
|
|
end
|
|
|
|
# The full landing page URL of the destination.
|
|
class DestinationUrlEvidence
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# The full landing page URL of the destination.
|
|
# Corresponds to the JSON property `destinationUrl`
|
|
# @return [String]
|
|
attr_accessor :destination_url
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@destination_url = args[:destination_url] if args.key?(:destination_url)
|
|
end
|
|
end
|
|
|
|
# Number of HTTP calls made by a creative, broken down by domain.
|
|
class DomainCallEvidence
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# Breakdown of the most frequent domains called via HTTP by the creative.
|
|
# Corresponds to the JSON property `topHttpCallDomains`
|
|
# @return [Array<Google::Apis::RealtimebiddingV1::DomainCalls>]
|
|
attr_accessor :top_http_call_domains
|
|
|
|
# The total number of HTTP calls made by the creative, including but not limited
|
|
# to the number of calls in the top_http_call_domains.
|
|
# Corresponds to the JSON property `totalHttpCallCount`
|
|
# @return [Fixnum]
|
|
attr_accessor :total_http_call_count
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@top_http_call_domains = args[:top_http_call_domains] if args.key?(:top_http_call_domains)
|
|
@total_http_call_count = args[:total_http_call_count] if args.key?(:total_http_call_count)
|
|
end
|
|
end
|
|
|
|
# The number of HTTP calls made to the given domain.
|
|
class DomainCalls
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# The domain name.
|
|
# Corresponds to the JSON property `domain`
|
|
# @return [String]
|
|
attr_accessor :domain
|
|
|
|
# Number of HTTP calls made to the domain.
|
|
# Corresponds to the JSON property `httpCallCount`
|
|
# @return [Fixnum]
|
|
attr_accessor :http_call_count
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@domain = args[:domain] if args.key?(:domain)
|
|
@http_call_count = args[:http_call_count] if args.key?(:http_call_count)
|
|
end
|
|
end
|
|
|
|
# Total download size and URL-level download size breakdown for resources in a
|
|
# creative.
|
|
class DownloadSizeEvidence
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# Download size broken down by URLs with the top download size.
|
|
# Corresponds to the JSON property `topUrlDownloadSizeBreakdowns`
|
|
# @return [Array<Google::Apis::RealtimebiddingV1::UrlDownloadSize>]
|
|
attr_accessor :top_url_download_size_breakdowns
|
|
|
|
# Total download size (in kilobytes) for all the resources in the creative.
|
|
# Corresponds to the JSON property `totalDownloadSizeKb`
|
|
# @return [Fixnum]
|
|
attr_accessor :total_download_size_kb
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@top_url_download_size_breakdowns = args[:top_url_download_size_breakdowns] if args.key?(:top_url_download_size_breakdowns)
|
|
@total_download_size_kb = args[:total_download_size_kb] if args.key?(:total_download_size_kb)
|
|
end
|
|
end
|
|
|
|
# Response for a request to get remarketing tag.
|
|
class GetRemarketingTagResponse
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# A HTML tag that can be placed on the advertiser's page to add users to a user
|
|
# list. For more information and code samples on using snippet on your website
|
|
# refer to [Tag your site for remarketing]( https://support.google.com/google-
|
|
# ads/answer/2476688).
|
|
# Corresponds to the JSON property `snippet`
|
|
# @return [String]
|
|
attr_accessor :snippet
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@snippet = args[:snippet] if args.key?(:snippet)
|
|
end
|
|
end
|
|
|
|
# HTML content for a creative.
|
|
class HtmlContent
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# The height of the HTML snippet in pixels. Can be used to filter the response
|
|
# of the creatives.list method.
|
|
# Corresponds to the JSON property `height`
|
|
# @return [Fixnum]
|
|
attr_accessor :height
|
|
|
|
# The HTML snippet that displays the ad when inserted in the web page.
|
|
# Corresponds to the JSON property `snippet`
|
|
# @return [String]
|
|
attr_accessor :snippet
|
|
|
|
# The width of the HTML snippet in pixels. Can be used to filter the response of
|
|
# the creatives.list method.
|
|
# Corresponds to the JSON property `width`
|
|
# @return [Fixnum]
|
|
attr_accessor :width
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@height = args[:height] if args.key?(:height)
|
|
@snippet = args[:snippet] if args.key?(:snippet)
|
|
@width = args[:width] if args.key?(:width)
|
|
end
|
|
end
|
|
|
|
# HTTP calls made by a creative that resulted in policy violations.
|
|
class HttpCallEvidence
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# URLs of HTTP calls made by the creative.
|
|
# Corresponds to the JSON property `urls`
|
|
# @return [Array<String>]
|
|
attr_accessor :urls
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@urls = args[:urls] if args.key?(:urls)
|
|
end
|
|
end
|
|
|
|
# Evidence for HTTP cookie-related policy violations.
|
|
class HttpCookieEvidence
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# Names of cookies that violate Google policies. For TOO_MANY_COOKIES policy,
|
|
# this will be the cookie names of top domains with the largest number of
|
|
# cookies. For other policies, this will be all the cookie names that violate
|
|
# the policy.
|
|
# Corresponds to the JSON property `cookieNames`
|
|
# @return [Array<String>]
|
|
attr_accessor :cookie_names
|
|
|
|
# The largest number of cookies set by a creative. If this field is set,
|
|
# cookie_names above will be set to the cookie names of top domains with the
|
|
# largest number of cookies. This field will only be set for TOO_MANY_COOKIES
|
|
# policy.
|
|
# Corresponds to the JSON property `maxCookieCount`
|
|
# @return [Fixnum]
|
|
attr_accessor :max_cookie_count
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@cookie_names = args[:cookie_names] if args.key?(:cookie_names)
|
|
@max_cookie_count = args[:max_cookie_count] if args.key?(:max_cookie_count)
|
|
end
|
|
end
|
|
|
|
# An image resource. You may provide a larger image than was requested, so long
|
|
# as the aspect ratio is preserved.
|
|
class Image
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# Image height in pixels.
|
|
# Corresponds to the JSON property `height`
|
|
# @return [Fixnum]
|
|
attr_accessor :height
|
|
|
|
# The URL of the image.
|
|
# Corresponds to the JSON property `url`
|
|
# @return [String]
|
|
attr_accessor :url
|
|
|
|
# Image width in pixels.
|
|
# Corresponds to the JSON property `width`
|
|
# @return [Fixnum]
|
|
attr_accessor :width
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@height = args[:height] if args.key?(:height)
|
|
@url = args[:url] if args.key?(:url)
|
|
@width = args[:width] if args.key?(:width)
|
|
end
|
|
end
|
|
|
|
# A response for listing creatives.
|
|
class ListCreativesResponse
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# The list of creatives.
|
|
# Corresponds to the JSON property `creatives`
|
|
# @return [Array<Google::Apis::RealtimebiddingV1::Creative>]
|
|
attr_accessor :creatives
|
|
|
|
# A token to retrieve the next page of results. Pass this value in the
|
|
# ListCreativesRequest.pageToken field in the subsequent call to the `
|
|
# ListCreatives` method to retrieve the next page of results.
|
|
# Corresponds to the JSON property `nextPageToken`
|
|
# @return [String]
|
|
attr_accessor :next_page_token
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@creatives = args[:creatives] if args.key?(:creatives)
|
|
@next_page_token = args[:next_page_token] if args.key?(:next_page_token)
|
|
end
|
|
end
|
|
|
|
# The list user list response.
|
|
class ListUserListsResponse
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# The continuation page token to send back to the server in a subsequent request.
|
|
# Due to a currently known issue, it is recommended that the caller keep
|
|
# invoking the list method till the time a next page token is not returned (even
|
|
# if the result set is empty).
|
|
# Corresponds to the JSON property `nextPageToken`
|
|
# @return [String]
|
|
attr_accessor :next_page_token
|
|
|
|
# List of user lists from the search.
|
|
# Corresponds to the JSON property `userLists`
|
|
# @return [Array<Google::Apis::RealtimebiddingV1::UserList>]
|
|
attr_accessor :user_lists
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@next_page_token = args[:next_page_token] if args.key?(:next_page_token)
|
|
@user_lists = args[:user_lists] if args.key?(:user_lists)
|
|
end
|
|
end
|
|
|
|
# Information about each media file in the VAST.
|
|
class MediaFile
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# Bitrate of the video file, in Kbps. Can be used to filter the response of the
|
|
# creatives.list method.
|
|
# Corresponds to the JSON property `bitrate`
|
|
# @return [Fixnum]
|
|
attr_accessor :bitrate
|
|
|
|
# The MIME type of this media file. Can be used to filter the response of the
|
|
# creatives.list method.
|
|
# Corresponds to the JSON property `mimeType`
|
|
# @return [String]
|
|
attr_accessor :mime_type
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@bitrate = args[:bitrate] if args.key?(:bitrate)
|
|
@mime_type = args[:mime_type] if args.key?(:mime_type)
|
|
end
|
|
end
|
|
|
|
# Native content for a creative.
|
|
class NativeContent
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# The name of the advertiser or sponsor, to be displayed in the ad creative.
|
|
# Corresponds to the JSON property `advertiserName`
|
|
# @return [String]
|
|
attr_accessor :advertiser_name
|
|
|
|
# An image resource. You may provide a larger image than was requested, so long
|
|
# as the aspect ratio is preserved.
|
|
# Corresponds to the JSON property `appIcon`
|
|
# @return [Google::Apis::RealtimebiddingV1::Image]
|
|
attr_accessor :app_icon
|
|
|
|
# A long description of the ad.
|
|
# Corresponds to the JSON property `body`
|
|
# @return [String]
|
|
attr_accessor :body
|
|
|
|
# A label for the button that the user is supposed to click.
|
|
# Corresponds to the JSON property `callToAction`
|
|
# @return [String]
|
|
attr_accessor :call_to_action
|
|
|
|
# The URL that the browser/SDK will load when the user clicks the ad.
|
|
# Corresponds to the JSON property `clickLinkUrl`
|
|
# @return [String]
|
|
attr_accessor :click_link_url
|
|
|
|
# The URL to use for click tracking.
|
|
# Corresponds to the JSON property `clickTrackingUrl`
|
|
# @return [String]
|
|
attr_accessor :click_tracking_url
|
|
|
|
# A short title for the ad.
|
|
# Corresponds to the JSON property `headline`
|
|
# @return [String]
|
|
attr_accessor :headline
|
|
|
|
# An image resource. You may provide a larger image than was requested, so long
|
|
# as the aspect ratio is preserved.
|
|
# Corresponds to the JSON property `image`
|
|
# @return [Google::Apis::RealtimebiddingV1::Image]
|
|
attr_accessor :image
|
|
|
|
# An image resource. You may provide a larger image than was requested, so long
|
|
# as the aspect ratio is preserved.
|
|
# Corresponds to the JSON property `logo`
|
|
# @return [Google::Apis::RealtimebiddingV1::Image]
|
|
attr_accessor :logo
|
|
|
|
# The price of the promoted app including currency info.
|
|
# Corresponds to the JSON property `priceDisplayText`
|
|
# @return [String]
|
|
attr_accessor :price_display_text
|
|
|
|
# The app rating in the app store. Must be in the range [0-5].
|
|
# Corresponds to the JSON property `starRating`
|
|
# @return [Float]
|
|
attr_accessor :star_rating
|
|
|
|
# The URL to fetch a native video ad.
|
|
# Corresponds to the JSON property `videoUrl`
|
|
# @return [String]
|
|
attr_accessor :video_url
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@advertiser_name = args[:advertiser_name] if args.key?(:advertiser_name)
|
|
@app_icon = args[:app_icon] if args.key?(:app_icon)
|
|
@body = args[:body] if args.key?(:body)
|
|
@call_to_action = args[:call_to_action] if args.key?(:call_to_action)
|
|
@click_link_url = args[:click_link_url] if args.key?(:click_link_url)
|
|
@click_tracking_url = args[:click_tracking_url] if args.key?(:click_tracking_url)
|
|
@headline = args[:headline] if args.key?(:headline)
|
|
@image = args[:image] if args.key?(:image)
|
|
@logo = args[:logo] if args.key?(:logo)
|
|
@price_display_text = args[:price_display_text] if args.key?(:price_display_text)
|
|
@star_rating = args[:star_rating] if args.key?(:star_rating)
|
|
@video_url = args[:video_url] if args.key?(:video_url)
|
|
end
|
|
end
|
|
|
|
# A request to open a specified user list.
|
|
class OpenUserListRequest
|
|
include Google::Apis::Core::Hashable
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
end
|
|
end
|
|
|
|
# Each policy topic entry will represent a violation of a policy topic for a
|
|
# creative, with the policy topic information and optional evidence for the
|
|
# policy violation.
|
|
class PolicyTopicEntry
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# Pieces of evidence associated with this policy topic entry.
|
|
# Corresponds to the JSON property `evidences`
|
|
# @return [Array<Google::Apis::RealtimebiddingV1::PolicyTopicEvidence>]
|
|
attr_accessor :evidences
|
|
|
|
# URL of the help center article describing this policy topic.
|
|
# Corresponds to the JSON property `helpCenterUrl`
|
|
# @return [String]
|
|
attr_accessor :help_center_url
|
|
|
|
# Policy topic this entry refers to. For example, "ALCOHOL", "
|
|
# TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible
|
|
# policy topics is not fixed for a particular API version and may change at any
|
|
# time. Can be used to filter the response of the creatives.list method
|
|
# Corresponds to the JSON property `policyTopic`
|
|
# @return [String]
|
|
attr_accessor :policy_topic
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@evidences = args[:evidences] if args.key?(:evidences)
|
|
@help_center_url = args[:help_center_url] if args.key?(:help_center_url)
|
|
@policy_topic = args[:policy_topic] if args.key?(:policy_topic)
|
|
end
|
|
end
|
|
|
|
# Evidence associated with a policy topic entry.
|
|
class PolicyTopicEvidence
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# Evidence that the creative's destination URL was not crawlable by Google.
|
|
# Corresponds to the JSON property `destinationNotCrawlable`
|
|
# @return [Google::Apis::RealtimebiddingV1::DestinationNotCrawlableEvidence]
|
|
attr_accessor :destination_not_crawlable
|
|
|
|
# Evidence of the creative's destination URL not functioning properly or having
|
|
# been incorrectly set up.
|
|
# Corresponds to the JSON property `destinationNotWorking`
|
|
# @return [Google::Apis::RealtimebiddingV1::DestinationNotWorkingEvidence]
|
|
attr_accessor :destination_not_working
|
|
|
|
# The full landing page URL of the destination.
|
|
# Corresponds to the JSON property `destinationUrl`
|
|
# @return [Google::Apis::RealtimebiddingV1::DestinationUrlEvidence]
|
|
attr_accessor :destination_url
|
|
|
|
# Number of HTTP calls made by a creative, broken down by domain.
|
|
# Corresponds to the JSON property `domainCall`
|
|
# @return [Google::Apis::RealtimebiddingV1::DomainCallEvidence]
|
|
attr_accessor :domain_call
|
|
|
|
# Total download size and URL-level download size breakdown for resources in a
|
|
# creative.
|
|
# Corresponds to the JSON property `downloadSize`
|
|
# @return [Google::Apis::RealtimebiddingV1::DownloadSizeEvidence]
|
|
attr_accessor :download_size
|
|
|
|
# HTTP calls made by a creative that resulted in policy violations.
|
|
# Corresponds to the JSON property `httpCall`
|
|
# @return [Google::Apis::RealtimebiddingV1::HttpCallEvidence]
|
|
attr_accessor :http_call
|
|
|
|
# Evidence for HTTP cookie-related policy violations.
|
|
# Corresponds to the JSON property `httpCookie`
|
|
# @return [Google::Apis::RealtimebiddingV1::HttpCookieEvidence]
|
|
attr_accessor :http_cookie
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@destination_not_crawlable = args[:destination_not_crawlable] if args.key?(:destination_not_crawlable)
|
|
@destination_not_working = args[:destination_not_working] if args.key?(:destination_not_working)
|
|
@destination_url = args[:destination_url] if args.key?(:destination_url)
|
|
@domain_call = args[:domain_call] if args.key?(:domain_call)
|
|
@download_size = args[:download_size] if args.key?(:download_size)
|
|
@http_call = args[:http_call] if args.key?(:http_call)
|
|
@http_cookie = args[:http_cookie] if args.key?(:http_cookie)
|
|
end
|
|
end
|
|
|
|
# Serving status of the creative for a transaction type or a region.
|
|
class ServingStatus
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# Serving status for the given transaction type (e.g., open auction, deals) or
|
|
# region (e.g., China, Russia). Can be used to filter the response of the
|
|
# creatives.list method.
|
|
# Corresponds to the JSON property `status`
|
|
# @return [String]
|
|
attr_accessor :status
|
|
|
|
# Policy topics related to the serving decision for this transaction type (e.g.,
|
|
# open auction, deals) or region (e.g., China, Russia). Topics may be present
|
|
# only if status is DISAPPROVED.
|
|
# Corresponds to the JSON property `topics`
|
|
# @return [Array<Google::Apis::RealtimebiddingV1::PolicyTopicEntry>]
|
|
attr_accessor :topics
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@status = args[:status] if args.key?(:status)
|
|
@topics = args[:topics] if args.key?(:topics)
|
|
end
|
|
end
|
|
|
|
# The URL-level breakdown for the download size.
|
|
class UrlDownloadSize
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# Download size of the URL in kilobytes.
|
|
# Corresponds to the JSON property `downloadSizeKb`
|
|
# @return [Fixnum]
|
|
attr_accessor :download_size_kb
|
|
|
|
# The normalized URL with query parameters and fragment removed.
|
|
# Corresponds to the JSON property `normalizedUrl`
|
|
# @return [String]
|
|
attr_accessor :normalized_url
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@download_size_kb = args[:download_size_kb] if args.key?(:download_size_kb)
|
|
@normalized_url = args[:normalized_url] if args.key?(:normalized_url)
|
|
end
|
|
end
|
|
|
|
# Represents the URL restriction (for the URL captured by the pixel callback)
|
|
# for a user list.
|
|
class UrlRestriction
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# Represents a whole or partial calendar date, e.g. a birthday. The time of day
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent: * A full
|
|
# date, with non-zero year, month and day values * A month and day value, with a
|
|
# zero year, e.g. an anniversary * A year on its own, with zero month and day
|
|
# values * A year and month value, with a zero day, e.g. a credit card
|
|
# expiration date Related types are google.type.TimeOfDay and `google.protobuf.
|
|
# Timestamp`.
|
|
# Corresponds to the JSON property `endDate`
|
|
# @return [Google::Apis::RealtimebiddingV1::Date]
|
|
attr_accessor :end_date
|
|
|
|
# The restriction type for the specified URL.
|
|
# Corresponds to the JSON property `restrictionType`
|
|
# @return [String]
|
|
attr_accessor :restriction_type
|
|
|
|
# Represents a whole or partial calendar date, e.g. a birthday. The time of day
|
|
# and time zone are either specified elsewhere or are not significant. The date
|
|
# is relative to the Proleptic Gregorian Calendar. This can represent: * A full
|
|
# date, with non-zero year, month and day values * A month and day value, with a
|
|
# zero year, e.g. an anniversary * A year on its own, with zero month and day
|
|
# values * A year and month value, with a zero day, e.g. a credit card
|
|
# expiration date Related types are google.type.TimeOfDay and `google.protobuf.
|
|
# Timestamp`.
|
|
# Corresponds to the JSON property `startDate`
|
|
# @return [Google::Apis::RealtimebiddingV1::Date]
|
|
attr_accessor :start_date
|
|
|
|
# Required. The URL to use for applying the restriction on the user list.
|
|
# 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)
|
|
@end_date = args[:end_date] if args.key?(:end_date)
|
|
@restriction_type = args[:restriction_type] if args.key?(:restriction_type)
|
|
@start_date = args[:start_date] if args.key?(:start_date)
|
|
@url = args[:url] if args.key?(:url)
|
|
end
|
|
end
|
|
|
|
# Represents an Authorized Buyers user list. Authorized Buyers can create/update/
|
|
# list user lists. Once a user list is created in the system, Authorized Buyers
|
|
# can add users to the user list using the bulk uploader API. Alternatively,
|
|
# users can be added by hosting a tag on the advertiser's page.
|
|
class UserList
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# The description for the user list.
|
|
# Corresponds to the JSON property `description`
|
|
# @return [String]
|
|
attr_accessor :description
|
|
|
|
# Required. Display name of the user list. This must be unique across all user
|
|
# lists for a given account.
|
|
# Corresponds to the JSON property `displayName`
|
|
# @return [String]
|
|
attr_accessor :display_name
|
|
|
|
# Required. The number of days a user's cookie stays on the user list. The field
|
|
# must be between 0 and 540 inclusive.
|
|
# Corresponds to the JSON property `membershipDurationDays`
|
|
# @return [Fixnum]
|
|
attr_accessor :membership_duration_days
|
|
|
|
# Output only. Name of the user list that must follow the pattern `buyers/`buyer`
|
|
# /userLists/`user_list``, where ``buyer`` represents the account ID of the
|
|
# buyer who owns the user list. For a bidder accessing user lists on behalf of a
|
|
# child seat buyer, ``buyer`` represents the account ID of the child seat buyer.
|
|
# ``user_list`` is an int64 identifier assigned by Google to uniquely identify a
|
|
# user list.
|
|
# Corresponds to the JSON property `name`
|
|
# @return [String]
|
|
attr_accessor :name
|
|
|
|
# Output only. The status of the user list. A new user list starts out as open.
|
|
# Corresponds to the JSON property `status`
|
|
# @return [String]
|
|
attr_accessor :status
|
|
|
|
# Represents the URL restriction (for the URL captured by the pixel callback)
|
|
# for a user list.
|
|
# Corresponds to the JSON property `urlRestriction`
|
|
# @return [Google::Apis::RealtimebiddingV1::UrlRestriction]
|
|
attr_accessor :url_restriction
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@description = args[:description] if args.key?(:description)
|
|
@display_name = args[:display_name] if args.key?(:display_name)
|
|
@membership_duration_days = args[:membership_duration_days] if args.key?(:membership_duration_days)
|
|
@name = args[:name] if args.key?(:name)
|
|
@status = args[:status] if args.key?(:status)
|
|
@url_restriction = args[:url_restriction] if args.key?(:url_restriction)
|
|
end
|
|
end
|
|
|
|
# Video content for a creative.
|
|
class VideoContent
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# Video metadata for a creative.
|
|
# Corresponds to the JSON property `videoMetadata`
|
|
# @return [Google::Apis::RealtimebiddingV1::VideoMetadata]
|
|
attr_accessor :video_metadata
|
|
|
|
# The URL to fetch a video ad.
|
|
# Corresponds to the JSON property `videoUrl`
|
|
# @return [String]
|
|
attr_accessor :video_url
|
|
|
|
# The contents of a VAST document for a video ad. This document should conform
|
|
# to the VAST 2.0 or 3.0 standard.
|
|
# Corresponds to the JSON property `videoVastXml`
|
|
# @return [String]
|
|
attr_accessor :video_vast_xml
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@video_metadata = args[:video_metadata] if args.key?(:video_metadata)
|
|
@video_url = args[:video_url] if args.key?(:video_url)
|
|
@video_vast_xml = args[:video_vast_xml] if args.key?(:video_vast_xml)
|
|
end
|
|
end
|
|
|
|
# Video metadata for a creative.
|
|
class VideoMetadata
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# The duration of the ad. Can be used to filter the response of the creatives.
|
|
# list method.
|
|
# Corresponds to the JSON property `duration`
|
|
# @return [String]
|
|
attr_accessor :duration
|
|
|
|
# Is this a valid VAST ad? Can be used to filter the response of the creatives.
|
|
# list method.
|
|
# Corresponds to the JSON property `isValidVast`
|
|
# @return [Boolean]
|
|
attr_accessor :is_valid_vast
|
|
alias_method :is_valid_vast?, :is_valid_vast
|
|
|
|
# Is this a VPAID ad? Can be used to filter the response of the creatives.list
|
|
# method.
|
|
# Corresponds to the JSON property `isVpaid`
|
|
# @return [Boolean]
|
|
attr_accessor :is_vpaid
|
|
alias_method :is_vpaid?, :is_vpaid
|
|
|
|
# The list of all media files declared in the VAST. If there are multiple VASTs
|
|
# in a wrapper chain, this includes the media files from the deepest one in the
|
|
# chain.
|
|
# Corresponds to the JSON property `mediaFiles`
|
|
# @return [Array<Google::Apis::RealtimebiddingV1::MediaFile>]
|
|
attr_accessor :media_files
|
|
|
|
# The minimum duration that the user has to watch before being able to skip this
|
|
# ad. If the field is not set, the ad is not skippable. If the field is set, the
|
|
# ad is skippable. Can be used to filter the response of the creatives.list
|
|
# method.
|
|
# Corresponds to the JSON property `skipOffset`
|
|
# @return [String]
|
|
attr_accessor :skip_offset
|
|
|
|
# The maximum VAST version across all wrapped VAST documents. Can be used to
|
|
# filter the response of the creatives.list method.
|
|
# Corresponds to the JSON property `vastVersion`
|
|
# @return [String]
|
|
attr_accessor :vast_version
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@duration = args[:duration] if args.key?(:duration)
|
|
@is_valid_vast = args[:is_valid_vast] if args.key?(:is_valid_vast)
|
|
@is_vpaid = args[:is_vpaid] if args.key?(:is_vpaid)
|
|
@media_files = args[:media_files] if args.key?(:media_files)
|
|
@skip_offset = args[:skip_offset] if args.key?(:skip_offset)
|
|
@vast_version = args[:vast_version] if args.key?(:vast_version)
|
|
end
|
|
end
|
|
|
|
# A request to receive push notifications when any of the creatives belonging to
|
|
# the bidder changes status.
|
|
class WatchCreativesRequest
|
|
include Google::Apis::Core::Hashable
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
end
|
|
end
|
|
|
|
# A response for the request to receive push notification when a bidder's
|
|
# creatives change status.
|
|
class WatchCreativesResponse
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# The Pub/Sub subscription that can be used to pull creative status
|
|
# notifications. This would be of the format `projects/`project_id`/
|
|
# subscriptions/`subscription_id``. Subscription is created with pull delivery.
|
|
# All service accounts belonging to the bidder will have read access to this
|
|
# subscription. Subscriptions that are inactive for more than 90 days will be
|
|
# disabled. Please use watchCreatives to re-enable the subscription.
|
|
# Corresponds to the JSON property `subscription`
|
|
# @return [String]
|
|
attr_accessor :subscription
|
|
|
|
# The Pub/Sub topic that will be used to publish creative serving status
|
|
# notifications. This would be of the format `projects/`project_id`/topics/`
|
|
# topic_id``.
|
|
# Corresponds to the JSON property `topic`
|
|
# @return [String]
|
|
attr_accessor :topic
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@subscription = args[:subscription] if args.key?(:subscription)
|
|
@topic = args[:topic] if args.key?(:topic)
|
|
end
|
|
end
|
|
end
|
|
end
|
|
end
|