4913 lines
322 KiB
Ruby
4913 lines
322 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 '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 DisplayvideoV1
|
|
# Display & Video 360 API
|
|
#
|
|
# Display & Video 360 API allows users to manage and create campaigns and
|
|
# reports.
|
|
#
|
|
# @example
|
|
# require 'google/apis/displayvideo_v1'
|
|
#
|
|
# Displayvideo = Google::Apis::DisplayvideoV1 # Alias the module
|
|
# service = Displayvideo::DisplayVideoService.new
|
|
#
|
|
# @see https://developers.google.com/display-video/
|
|
class DisplayVideoService < Google::Apis::Core::BaseService
|
|
# @return [String]
|
|
# API key. Your API key identifies your project and provides you with API access,
|
|
# quota, and reports. Required unless you provide an OAuth 2.0 token.
|
|
attr_accessor :key
|
|
|
|
# @return [String]
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
attr_accessor :quota_user
|
|
|
|
def initialize
|
|
super('https://displayvideo.googleapis.com/', '')
|
|
@batch_path = 'batch'
|
|
end
|
|
|
|
# Audits an advertiser. Returns the counts of used entities per resource type
|
|
# under the advertiser provided. Used entities count towards their respective
|
|
# resource limit. See https://support.google.com/displayvideo/answer/6071450.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the advertiser to audit.
|
|
# @param [String] read_mask
|
|
# Optional. The specific fields to return. If no mask is specified, all fields
|
|
# in the response proto will be filled. Valid values are: * usedLineItemsCount *
|
|
# usedInsertionOrdersCount * usedCampaignsCount * channelsCount *
|
|
# negativelyTargetedChannelsCount * negativeKeywordListsCount *
|
|
# adGroupCriteriaCount * campaignCriteriaCount
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::AuditAdvertiserResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::AuditAdvertiserResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def audit_advertiser(advertiser_id, read_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}:audit', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::AuditAdvertiserResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::AuditAdvertiserResponse
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['readMask'] = read_mask unless read_mask.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Bulk edits targeting options under a single advertiser. The operation will
|
|
# delete the assigned targeting options provided in
|
|
# BulkEditAdvertiserAssignedTargetingOptionsRequest.delete_requests and then
|
|
# create the assigned targeting options provided in
|
|
# BulkEditAdvertiserAssignedTargetingOptionsRequest.create_requests .
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the advertiser.
|
|
# @param [Google::Apis::DisplayvideoV1::BulkEditAdvertiserAssignedTargetingOptionsRequest] bulk_edit_advertiser_assigned_targeting_options_request_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::BulkEditAdvertiserAssignedTargetingOptionsResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::BulkEditAdvertiserAssignedTargetingOptionsResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def bulk_edit_advertiser_assigned_targeting_options(advertiser_id, bulk_edit_advertiser_assigned_targeting_options_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/advertisers/{+advertiserId}:bulkEditAdvertiserAssignedTargetingOptions', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::BulkEditAdvertiserAssignedTargetingOptionsRequest::Representation
|
|
command.request_object = bulk_edit_advertiser_assigned_targeting_options_request_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::BulkEditAdvertiserAssignedTargetingOptionsResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::BulkEditAdvertiserAssignedTargetingOptionsResponse
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists assigned targeting options of an advertiser across targeting types.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the advertiser the line item belongs to.
|
|
# @param [String] filter
|
|
# Allows filtering by assigned targeting option properties. Supported syntax: *
|
|
# Filter expressions are made up of one or more restrictions. * Restrictions can
|
|
# be combined by the logical operator `OR`.. * A restriction has the form of ``
|
|
# field` `operator` `value``. * The operator must be `EQUALS (=)`. * Supported
|
|
# fields: - `targetingType` Examples: * targetingType with value
|
|
# TARGETING_TYPE_CHANNEL `targetingType="TARGETING_TYPE_CHANNEL"` The length of
|
|
# this field should be no more than 500 characters.
|
|
# @param [String] order_by
|
|
# Field by which to sort the list. Acceptable values are: * `targetingType` (
|
|
# default) The default sorting order is ascending. To specify descending order
|
|
# for a field, a suffix "desc" should be added to the field name. Example: `
|
|
# targetingType desc`.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. The size must be an integer between `1` and `5000`. If
|
|
# unspecified, the default is '5000'. Returns error code `INVALID_ARGUMENT` if
|
|
# an invalid value is specified.
|
|
# @param [String] page_token
|
|
# A token that lets the client fetch the next page of results. Typically, this
|
|
# is the value of next_page_token returned from the previous call to `
|
|
# BulkListAdvertiserAssignedTargetingOptions` method. If not specified, the
|
|
# first page of results will be returned.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::BulkListAdvertiserAssignedTargetingOptionsResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::BulkListAdvertiserAssignedTargetingOptionsResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def bulk_advertiser_list_advertiser_assigned_targeting_options(advertiser_id, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}:bulkListAdvertiserAssignedTargetingOptions', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::BulkListAdvertiserAssignedTargetingOptionsResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::BulkListAdvertiserAssignedTargetingOptionsResponse
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['filter'] = filter unless filter.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Creates a new advertiser. Returns the newly created advertiser if successful.
|
|
# This method can take up to 180 seconds to complete.
|
|
# @param [Google::Apis::DisplayvideoV1::Advertiser] advertiser_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Advertiser] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Advertiser]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def create_advertiser(advertiser_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/advertisers', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::Advertiser::Representation
|
|
command.request_object = advertiser_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Advertiser::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Advertiser
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Deletes an advertiser. Deleting an advertiser will delete all of its child
|
|
# resources, for example, campaigns, insertion orders and line items. A deleted
|
|
# advertiser cannot be recovered.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser we need to delete.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Empty] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Empty]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def delete_advertiser(advertiser_id, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:delete, 'v1/advertisers/{+advertiserId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Empty::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Empty
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets an advertiser.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the advertiser to fetch.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Advertiser] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Advertiser]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def get_advertiser(advertiser_id, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Advertiser::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Advertiser
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists advertisers that are accessible to the current user. The order is
|
|
# defined by the order_by parameter. A single partner_id is required. Cross-
|
|
# partner listing is not supported.
|
|
# @param [String] filter
|
|
# Allows filtering by advertiser properties. Supported syntax: * Filter
|
|
# expressions are made up of one or more restrictions. * Restrictions can be
|
|
# combined by `AND` or `OR` logical operators. A sequence of restrictions
|
|
# implicitly uses `AND`. * A restriction has the form of ``field` `operator` `
|
|
# value``. * The operator must be `EQUALS (=)`. * Supported fields: - `
|
|
# advertiserId` - `displayName` - `entityStatus` Examples: * All active
|
|
# advertisers under a partner: `entityStatus="ENTITY_STATUS_ACTIVE"` The length
|
|
# of this field should be no more than 500 characters.
|
|
# @param [String] order_by
|
|
# Field by which to sort the list. Acceptable values are: * `displayName` (
|
|
# default) * `entityStatus` The default sorting order is ascending. To specify
|
|
# descending order for a field, a suffix "desc" should be added to the field
|
|
# name. For example, `displayName desc`.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. Must be between `1` and `100`. If unspecified will
|
|
# default to `100`.
|
|
# @param [String] page_token
|
|
# A token identifying a page of results the server should return. Typically,
|
|
# this is the value of next_page_token returned from the previous call to `
|
|
# ListAdvertisers` method. If not specified, the first page of results will be
|
|
# returned.
|
|
# @param [Fixnum] partner_id
|
|
# Required. The ID of the partner that the fetched advertisers should all belong
|
|
# to. The system only supports listing advertisers for one partner at a time.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::ListAdvertisersResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::ListAdvertisersResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def list_advertisers(filter: nil, order_by: nil, page_size: nil, page_token: nil, partner_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/advertisers', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::ListAdvertisersResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::ListAdvertisersResponse
|
|
command.query['filter'] = filter unless filter.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing advertiser. Returns the updated advertiser if successful.
|
|
# @param [Fixnum] advertiser_id
|
|
# Output only. The unique ID of the advertiser. Assigned by the system.
|
|
# @param [Google::Apis::DisplayvideoV1::Advertiser] advertiser_object
|
|
# @param [String] update_mask
|
|
# Required. The mask to control which fields to update.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Advertiser] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Advertiser]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def patch_advertiser(advertiser_id, advertiser_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'v1/advertisers/{+advertiserId}', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::Advertiser::Representation
|
|
command.request_object = advertiser_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Advertiser::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Advertiser
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['updateMask'] = update_mask unless update_mask.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Uploads an asset. Returns the ID of the newly uploaded asset if successful.
|
|
# The asset file size should be no more than 10 MB for images, 200 MB for ZIP
|
|
# files, and 1 GB for videos.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the advertiser this asset belongs to.
|
|
# @param [Google::Apis::DisplayvideoV1::CreateAssetRequest] create_asset_request_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [IO, String] upload_source
|
|
# IO stream or filename containing content to upload
|
|
# @param [String] content_type
|
|
# Content type of the uploaded content.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::CreateAssetResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::CreateAssetResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def upload_advertiser_asset(advertiser_id, create_asset_request_object = nil, fields: nil, quota_user: nil, upload_source: nil, content_type: nil, options: nil, &block)
|
|
if upload_source.nil?
|
|
command = make_simple_command(:post, 'v1/advertisers/{+advertiserId}/assets', options)
|
|
else
|
|
command = make_upload_command(:post, 'v1/advertisers/{+advertiserId}/assets', options)
|
|
command.upload_source = upload_source
|
|
command.upload_content_type = content_type
|
|
end
|
|
command.request_representation = Google::Apis::DisplayvideoV1::CreateAssetRequest::Representation
|
|
command.request_object = create_asset_request_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::CreateAssetResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::CreateAssetResponse
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Creates a new campaign. Returns the newly created campaign if successful.
|
|
# @param [Fixnum] advertiser_id
|
|
# Output only. The unique ID of the advertiser the campaign belongs to.
|
|
# @param [Google::Apis::DisplayvideoV1::Campaign] campaign_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Campaign] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Campaign]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def create_advertiser_campaign(advertiser_id, campaign_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/advertisers/{+advertiserId}/campaigns', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::Campaign::Representation
|
|
command.request_object = campaign_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Campaign::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Campaign
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Permanently deletes a campaign. A deleted campaign cannot be recovered. The
|
|
# campaign should be archived first, i.e. set entity_status to `
|
|
# ENTITY_STATUS_ARCHIVED`, to be able to delete it.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser this campaign belongs to.
|
|
# @param [Fixnum] campaign_id
|
|
# The ID of the campaign we need to delete.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Empty] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Empty]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def delete_advertiser_campaign(advertiser_id, campaign_id, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:delete, 'v1/advertisers/{+advertiserId}/campaigns/{+campaignId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Empty::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Empty
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['campaignId'] = campaign_id unless campaign_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets a campaign.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the advertiser this campaign belongs to.
|
|
# @param [Fixnum] campaign_id
|
|
# Required. The ID of the campaign to fetch.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Campaign] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Campaign]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def get_advertiser_campaign(advertiser_id, campaign_id, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}/campaigns/{+campaignId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Campaign::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Campaign
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['campaignId'] = campaign_id unless campaign_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists campaigns in an advertiser. The order is defined by the order_by
|
|
# parameter. If a filter by entity_status is not specified, campaigns with `
|
|
# ENTITY_STATUS_ARCHIVED` will not be included in the results.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser to list campaigns for.
|
|
# @param [String] filter
|
|
# Allows filtering by campaign properties. Supported syntax: * Filter
|
|
# expressions are made up of one or more restrictions. * Restrictions can be
|
|
# combined by `AND` or `OR` logical operators. A sequence of restrictions
|
|
# implicitly uses `AND`. * A restriction has the form of ``field` `operator` `
|
|
# value``. * The operator must be `EQUALS (=)`. * Supported fields: - `
|
|
# campaignId` - `displayName` - `entityStatus` Examples: * All `
|
|
# ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` campaigns under an advertiser:
|
|
# `(entityStatus="ENTITY_STATUS_ACTIVE" OR entityStatus="ENTITY_STATUS_PAUSED")`
|
|
# The length of this field should be no more than 500 characters.
|
|
# @param [String] order_by
|
|
# Field by which to sort the list. Acceptable values are: * `displayName` (
|
|
# default) * `entityStatus` The default sorting order is ascending. To specify
|
|
# descending order for a field, a suffix "desc" should be added to the field
|
|
# name. Example: `displayName desc`.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. Must be between `1` and `100`. If unspecified will
|
|
# default to `100`.
|
|
# @param [String] page_token
|
|
# A token identifying a page of results the server should return. Typically,
|
|
# this is the value of next_page_token returned from the previous call to `
|
|
# ListCampaigns` method. If not specified, the first page of results will be
|
|
# returned.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::ListCampaignsResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::ListCampaignsResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def list_advertiser_campaigns(advertiser_id, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}/campaigns', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::ListCampaignsResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::ListCampaignsResponse
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['filter'] = filter unless filter.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing campaign. Returns the updated campaign if successful.
|
|
# @param [Fixnum] advertiser_id
|
|
# Output only. The unique ID of the advertiser the campaign belongs to.
|
|
# @param [Fixnum] campaign_id
|
|
# Output only. The unique ID of the campaign. Assigned by the system.
|
|
# @param [Google::Apis::DisplayvideoV1::Campaign] campaign_object
|
|
# @param [String] update_mask
|
|
# Required. The mask to control which fields to update.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Campaign] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Campaign]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def patch_advertiser_campaign(advertiser_id, campaign_id, campaign_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'v1/advertisers/{+advertiserId}/campaigns/{+campaignId}', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::Campaign::Representation
|
|
command.request_object = campaign_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Campaign::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Campaign
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['campaignId'] = campaign_id unless campaign_id.nil?
|
|
command.query['updateMask'] = update_mask unless update_mask.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Creates a new channel. Returns the newly created channel if successful.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that owns the created channel.
|
|
# @param [Google::Apis::DisplayvideoV1::Channel] channel_object
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that owns the created channel.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Channel] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Channel]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def create_advertiser_channel(advertiser_id, channel_object = nil, partner_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/advertisers/{+advertiserId}/channels', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::Channel::Representation
|
|
command.request_object = channel_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Channel::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Channel
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets a channel for a partner or advertiser.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that owns the fetched channel.
|
|
# @param [Fixnum] channel_id
|
|
# Required. The ID of the channel to fetch.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that owns the fetched channel.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Channel] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Channel]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def get_advertiser_channel(advertiser_id, channel_id, partner_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}/channels/{+channelId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Channel::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Channel
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['channelId'] = channel_id unless channel_id.nil?
|
|
command.query['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists channels for a partner or advertiser.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that owns the channels.
|
|
# @param [String] filter
|
|
# Allows filtering by channel fields. Supported syntax: * Filter expressions for
|
|
# channel currently can only contain at most one * restriction. * A restriction
|
|
# has the form of ``field` `operator` `value``. * The operator must be `CONTAINS
|
|
# (:)`. * Supported fields: - `displayName` Examples: * All channels for which
|
|
# the display name contains "google": `displayName : "google"`. The length of
|
|
# this field should be no more than 500 characters.
|
|
# @param [String] order_by
|
|
# Field by which to sort the list. Acceptable values are: * `displayName` (
|
|
# default) * `channelId` The default sorting order is ascending. To specify
|
|
# descending order for a field, a suffix " desc" should be added to the field
|
|
# name. Example: `displayName desc`.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. Must be between `1` and `100`. If unspecified will
|
|
# default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is
|
|
# specified.
|
|
# @param [String] page_token
|
|
# A token identifying a page of results the server should return. Typically,
|
|
# this is the value of next_page_token returned from the previous call to `
|
|
# ListChannels` method. If not specified, the first page of results will be
|
|
# returned.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that owns the channels.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::ListChannelsResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::ListChannelsResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def list_advertiser_channels(advertiser_id, filter: nil, order_by: nil, page_size: nil, page_token: nil, partner_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}/channels', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::ListChannelsResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::ListChannelsResponse
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['filter'] = filter unless filter.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates a channel. Returns the updated channel if successful.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that owns the created channel.
|
|
# @param [Fixnum] channel_id
|
|
# Output only. The unique ID of the channel. Assigned by the system.
|
|
# @param [Google::Apis::DisplayvideoV1::Channel] channel_object
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that owns the created channel.
|
|
# @param [String] update_mask
|
|
# Required. The mask to control which fields to update.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Channel] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Channel]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def patch_advertiser_channel(advertiser_id, channel_id, channel_object = nil, partner_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'v1/advertisers/{+advertiserId}/channels/{channelId}', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::Channel::Representation
|
|
command.request_object = channel_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Channel::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Channel
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['channelId'] = channel_id unless channel_id.nil?
|
|
command.query['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['updateMask'] = update_mask unless update_mask.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Bulk edits sites under a single channel. The operation will delete the sites
|
|
# provided in BulkEditSitesRequest.deleted_sites and then create the sites
|
|
# provided in BulkEditSitesRequest.created_sites.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that owns the parent channel.
|
|
# @param [Fixnum] channel_id
|
|
# Required. The ID of the parent channel to which the sites belong.
|
|
# @param [Google::Apis::DisplayvideoV1::BulkEditSitesRequest] bulk_edit_sites_request_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::BulkEditSitesResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::BulkEditSitesResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def bulk_advertiser_channel_site_edit(advertiser_id, channel_id, bulk_edit_sites_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/advertisers/{advertiserId}/channels/{+channelId}/sites:bulkEdit', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::BulkEditSitesRequest::Representation
|
|
command.request_object = bulk_edit_sites_request_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::BulkEditSitesResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::BulkEditSitesResponse
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['channelId'] = channel_id unless channel_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Creates a site in a channel.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that owns the parent channel.
|
|
# @param [Fixnum] channel_id
|
|
# Required. The ID of the parent channel in which the site will be created.
|
|
# @param [Google::Apis::DisplayvideoV1::Site] site_object
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that owns the parent channel.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Site] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Site]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def create_advertiser_channel_site(advertiser_id, channel_id, site_object = nil, partner_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/advertisers/{advertiserId}/channels/{+channelId}/sites', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::Site::Representation
|
|
command.request_object = site_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Site::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Site
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['channelId'] = channel_id unless channel_id.nil?
|
|
command.query['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Deletes a site from a channel.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that owns the parent channel.
|
|
# @param [Fixnum] channel_id
|
|
# Required. The ID of the parent channel to which the site belongs.
|
|
# @param [String] url_or_app_id
|
|
# Required. The URL or app ID of the site to delete.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that owns the parent channel.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Empty] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Empty]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def delete_advertiser_channel_site(advertiser_id, channel_id, url_or_app_id, partner_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:delete, 'v1/advertisers/{advertiserId}/channels/{+channelId}/sites/{+urlOrAppId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Empty::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Empty
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['channelId'] = channel_id unless channel_id.nil?
|
|
command.params['urlOrAppId'] = url_or_app_id unless url_or_app_id.nil?
|
|
command.query['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists sites in a channel.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that owns the parent channel.
|
|
# @param [Fixnum] channel_id
|
|
# Required. The ID of the parent channel to which the requested sites belong.
|
|
# @param [String] filter
|
|
# Allows filtering by site fields. Supported syntax: * Filter expressions for
|
|
# site currently can only contain at most one * restriction. * A restriction has
|
|
# the form of ``field` `operator` `value``. * The operator must be `CONTAINS (:)`
|
|
# . * Supported fields: - `urlOrAppId` Examples: * All sites for which the URL
|
|
# or app ID contains "google": `urlOrAppId : "google"`
|
|
# @param [String] order_by
|
|
# Field by which to sort the list. Acceptable values are: * `urlOrAppId` (
|
|
# default) The default sorting order is ascending. To specify descending order
|
|
# for a field, a suffix " desc" should be added to the field name. Example: `
|
|
# urlOrAppId desc`.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. Must be between `1` and `100`. If unspecified will
|
|
# default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is
|
|
# specified.
|
|
# @param [String] page_token
|
|
# A token identifying a page of results the server should return. Typically,
|
|
# this is the value of next_page_token returned from the previous call to `
|
|
# ListSites` method. If not specified, the first page of results will be
|
|
# returned.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that owns the parent channel.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::ListSitesResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::ListSitesResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def list_advertiser_channel_sites(advertiser_id, channel_id, filter: nil, order_by: nil, page_size: nil, page_token: nil, partner_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}/channels/{+channelId}/sites', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::ListSitesResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::ListSitesResponse
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['channelId'] = channel_id unless channel_id.nil?
|
|
command.query['filter'] = filter unless filter.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Creates a new creative. Returns the newly created creative if successful.
|
|
# @param [Fixnum] advertiser_id
|
|
# Output only. The unique ID of the advertiser the creative belongs to.
|
|
# @param [Google::Apis::DisplayvideoV1::Creative] creative_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Creative] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Creative]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def create_advertiser_creative(advertiser_id, creative_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/advertisers/{+advertiserId}/creatives', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::Creative::Representation
|
|
command.request_object = creative_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Creative::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Creative
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Deletes a creative. Returns error code `NOT_FOUND` if the creative does not
|
|
# exist. The creative should be archived first, i.e. set entity_status to `
|
|
# ENTITY_STATUS_ARCHIVED`, before it can be deleted.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser this creative belongs to.
|
|
# @param [Fixnum] creative_id
|
|
# The ID of the creative to be deleted.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Empty] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Empty]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def delete_advertiser_creative(advertiser_id, creative_id, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:delete, 'v1/advertisers/{+advertiserId}/creatives/{+creativeId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Empty::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Empty
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['creativeId'] = creative_id unless creative_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets a creative.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the advertiser this creative belongs to.
|
|
# @param [Fixnum] creative_id
|
|
# Required. The ID of the creative to fetch.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Creative] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Creative]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def get_advertiser_creative(advertiser_id, creative_id, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}/creatives/{+creativeId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Creative::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Creative
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['creativeId'] = creative_id unless creative_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists creatives in an advertiser. The order is defined by the order_by
|
|
# parameter. If a filter by entity_status is not specified, creatives with `
|
|
# ENTITY_STATUS_ARCHIVED` will not be included in the results.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the advertiser to list creatives for.
|
|
# @param [String] filter
|
|
# Allows filtering by creative properties. Supported syntax: * Filter
|
|
# expressions are made up of one or more restrictions. * Restriction for the
|
|
# same field must be combined by `OR`. * Restriction for different fields must
|
|
# be combined by `AND`. * Between `(` and `)` there can only be restrictions
|
|
# combined by `OR` for the same field. * A restriction has the form of ``field` `
|
|
# operator` `value``. * The operator must be `EQUALS (=)` for the following
|
|
# fields: - `entityStatus` - `creativeType`. - `dimensions` - `minDuration` - `
|
|
# maxDuration` - `approvalStatus` - `exchangeReviewStatus` - `dynamic` - `
|
|
# creativeId` * The operator must be `HAS (:)` for the following fields: - `
|
|
# lineItemIds` * For `entityStatus`, `minDuration`, `maxDuration`, and `dynamic`
|
|
# there may be at most one restriction. * For `dimensions`, the value is in the
|
|
# form of `"`width`x`height`"`. * For `exchangeReviewStatus`, the value is in
|
|
# the form of ``exchange`-`reviewStatus``. * For `minDuration` and `maxDuration`,
|
|
# the value is in the form of `"`duration`s"`. Only seconds are supported with
|
|
# millisecond granularity. * There may be multiple `lineItemIds` restrictions in
|
|
# order to search against multiple possible line item IDs. * There may be
|
|
# multiple `creativeId` restrictions in order to search against multiple
|
|
# possible creative IDs. Examples: * All native creatives: `creativeType="
|
|
# CREATIVE_TYPE_NATIVE"` * All active creatives with 300x400 or 50x100
|
|
# dimensions: `entityStatus="ENTITY_STATUS_ACTIVE" AND (dimensions="300x400" OR
|
|
# dimensions="50x100")` * All dynamic creatives that are approved by AdX or
|
|
# AppNexus, with a minimum duration of 5 seconds and 200ms. `dynamic="true" AND
|
|
# minDuration="5.2s" AND (exchangeReviewStatus="EXCHANGE_GOOGLE_AD_MANAGER-
|
|
# REVIEW_STATUS_APPROVED" OR exchangeReviewStatus="EXCHANGE_APPNEXUS-
|
|
# REVIEW_STATUS_APPROVED")` * All video creatives that are associated with line
|
|
# item ID 1 or 2: `creativeType="CREATIVE_TYPE_VIDEO" AND (lineItemIds:1 OR
|
|
# lineItemIds:2)` * Find creatives by multiple creative IDs: `creativeId=1 OR
|
|
# creativeId=2` The length of this field should be no more than 500 characters.
|
|
# @param [String] order_by
|
|
# Field by which to sort the list. Acceptable values are: * `creativeId` (
|
|
# default) * `createTime` * `mediaDuration` * `dimensions` (sorts by width first,
|
|
# then by height) The default sorting order is ascending. To specify descending
|
|
# order for a field, a suffix "desc" should be added to the field name. Example:
|
|
# `createTime desc`.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. Must be between `1` and `100`. If unspecified will
|
|
# default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is
|
|
# specified.
|
|
# @param [String] page_token
|
|
# A token identifying a page of results the server should return. Typically,
|
|
# this is the value of next_page_token returned from the previous call to `
|
|
# ListCreatives` method. If not specified, the first page of results will be
|
|
# returned.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::ListCreativesResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::ListCreativesResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def list_advertiser_creatives(advertiser_id, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}/creatives', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::ListCreativesResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::ListCreativesResponse
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['filter'] = filter unless filter.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing creative. Returns the updated creative if successful.
|
|
# @param [Fixnum] advertiser_id
|
|
# Output only. The unique ID of the advertiser the creative belongs to.
|
|
# @param [Fixnum] creative_id
|
|
# Output only. The unique ID of the creative. Assigned by the system.
|
|
# @param [Google::Apis::DisplayvideoV1::Creative] creative_object
|
|
# @param [String] update_mask
|
|
# Required. The mask to control which fields to update.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Creative] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Creative]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def patch_advertiser_creative(advertiser_id, creative_id, creative_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'v1/advertisers/{+advertiserId}/creatives/{+creativeId}', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::Creative::Representation
|
|
command.request_object = creative_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Creative::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Creative
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['creativeId'] = creative_id unless creative_id.nil?
|
|
command.query['updateMask'] = update_mask unless update_mask.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Creates a new insertion order. Returns the newly created insertion order if
|
|
# successful.
|
|
# @param [Fixnum] advertiser_id
|
|
# Output only. The unique ID of the advertiser the insertion order belongs to.
|
|
# @param [Google::Apis::DisplayvideoV1::InsertionOrder] insertion_order_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::InsertionOrder] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::InsertionOrder]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def create_advertiser_insertion_order(advertiser_id, insertion_order_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/advertisers/{+advertiserId}/insertionOrders', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::InsertionOrder::Representation
|
|
command.request_object = insertion_order_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::InsertionOrder::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::InsertionOrder
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Deletes an insertion order. Returns error code `NOT_FOUND` if the insertion
|
|
# order does not exist. The insertion order should be archived first, i.e. set
|
|
# entity_status to `ENTITY_STATUS_ARCHIVED`, to be able to delete it.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser this insertion order belongs to.
|
|
# @param [Fixnum] insertion_order_id
|
|
# The ID of the insertion order we need to delete.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Empty] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Empty]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def delete_advertiser_insertion_order(advertiser_id, insertion_order_id, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:delete, 'v1/advertisers/{+advertiserId}/insertionOrders/{+insertionOrderId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Empty::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Empty
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['insertionOrderId'] = insertion_order_id unless insertion_order_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets an insertion order. Returns error code `NOT_FOUND` if the insertion order
|
|
# does not exist.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the advertiser this insertion order belongs to.
|
|
# @param [Fixnum] insertion_order_id
|
|
# Required. The ID of the insertion order to fetch.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::InsertionOrder] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::InsertionOrder]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def get_advertiser_insertion_order(advertiser_id, insertion_order_id, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}/insertionOrders/{+insertionOrderId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::InsertionOrder::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::InsertionOrder
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['insertionOrderId'] = insertion_order_id unless insertion_order_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists insertion orders in an advertiser. The order is defined by the order_by
|
|
# parameter. If a filter by entity_status is not specified, insertion orders
|
|
# with `ENTITY_STATUS_ARCHIVED` will not be included in the results.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the advertiser to list insertion orders for.
|
|
# @param [String] filter
|
|
# Allows filtering by insertion order properties. Supported syntax: * Filter
|
|
# expressions are made up of one or more restrictions. * Restrictions can be
|
|
# combined by `AND` or `OR` logical operators. A sequence of restrictions
|
|
# implicitly uses `AND`. * A restriction has the form of ``field` `operator` `
|
|
# value``. * The operator used on `budget.budget_segments.date_range.end_date`
|
|
# must be LESS THAN (<). * The operators used on all other fields must be `
|
|
# EQUALS (=)`. * Supported fields: - `campaignId` - `displayName` - `
|
|
# entityStatus` - `budget.budget_segments.date_range.end_date` (input as YYYY-MM-
|
|
# DD) Examples: * All insertion orders under a campaign: `campaignId="1234"` *
|
|
# All `ENTITY_STATUS_ACTIVE` or `ENTITY_STATUS_PAUSED` insertion orders under an
|
|
# advertiser: `(entityStatus="ENTITY_STATUS_ACTIVE" OR entityStatus="
|
|
# ENTITY_STATUS_PAUSED")` * All insertion orders whose budget segments' dates
|
|
# end before March 28, 2019: `budget.budget_segments.date_range.end_date<"2019-
|
|
# 03-28"` The length of this field should be no more than 500 characters.
|
|
# @param [String] order_by
|
|
# Field by which to sort the list. Acceptable values are: * "displayName" (
|
|
# default) * "entityStatus" The default sorting order is ascending. To specify
|
|
# descending order for a field, a suffix "desc" should be added to the field
|
|
# name. Example: `displayName desc`.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. Must be between `1` and `100`. If unspecified will
|
|
# default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is
|
|
# specified.
|
|
# @param [String] page_token
|
|
# A token identifying a page of results the server should return. Typically,
|
|
# this is the value of next_page_token returned from the previous call to `
|
|
# ListInsertionOrders` method. If not specified, the first page of results will
|
|
# be returned.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::ListInsertionOrdersResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::ListInsertionOrdersResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def list_advertiser_insertion_orders(advertiser_id, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}/insertionOrders', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::ListInsertionOrdersResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::ListInsertionOrdersResponse
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['filter'] = filter unless filter.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing insertion order. Returns the updated insertion order if
|
|
# successful.
|
|
# @param [Fixnum] advertiser_id
|
|
# Output only. The unique ID of the advertiser the insertion order belongs to.
|
|
# @param [Fixnum] insertion_order_id
|
|
# Output only. The unique ID of the insertion order. Assigned by the system.
|
|
# @param [Google::Apis::DisplayvideoV1::InsertionOrder] insertion_order_object
|
|
# @param [String] update_mask
|
|
# Required. The mask to control which fields to update.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::InsertionOrder] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::InsertionOrder]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def patch_advertiser_insertion_order(advertiser_id, insertion_order_id, insertion_order_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'v1/advertisers/{+advertiserId}/insertionOrders/{+insertionOrderId}', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::InsertionOrder::Representation
|
|
command.request_object = insertion_order_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::InsertionOrder::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::InsertionOrder
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['insertionOrderId'] = insertion_order_id unless insertion_order_id.nil?
|
|
command.query['updateMask'] = update_mask unless update_mask.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Bulk edits targeting options under a single line item. The operation will
|
|
# delete the assigned targeting options provided in
|
|
# BulkEditLineItemAssignedTargetingOptionsRequest.delete_requests and then
|
|
# create the assigned targeting options provided in
|
|
# BulkEditLineItemAssignedTargetingOptionsRequest.create_requests .
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the advertiser the line item belongs to.
|
|
# @param [Fixnum] line_item_id
|
|
# Required. The ID of the line item the assigned targeting option will belong to.
|
|
# @param [Google::Apis::DisplayvideoV1::BulkEditLineItemAssignedTargetingOptionsRequest] bulk_edit_line_item_assigned_targeting_options_request_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::BulkEditLineItemAssignedTargetingOptionsResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::BulkEditLineItemAssignedTargetingOptionsResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def bulk_edit_line_item_assigned_targeting_options(advertiser_id, line_item_id, bulk_edit_line_item_assigned_targeting_options_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/advertisers/{+advertiserId}/lineItems/{+lineItemId}:bulkEditLineItemAssignedTargetingOptions', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::BulkEditLineItemAssignedTargetingOptionsRequest::Representation
|
|
command.request_object = bulk_edit_line_item_assigned_targeting_options_request_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::BulkEditLineItemAssignedTargetingOptionsResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::BulkEditLineItemAssignedTargetingOptionsResponse
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['lineItemId'] = line_item_id unless line_item_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists assigned targeting options of a line item across targeting types.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the advertiser the line item belongs to.
|
|
# @param [Fixnum] line_item_id
|
|
# Required. The ID of the line item to list assigned targeting options for.
|
|
# @param [String] filter
|
|
# Allows filtering by assigned targeting option properties. Supported syntax: *
|
|
# Filter expressions are made up of one or more restrictions. * Restrictions can
|
|
# be combined by the logical operator `OR` on the same field. * A restriction
|
|
# has the form of ``field` `operator` `value``. * The operator must be `EQUALS (=
|
|
# )`. * Supported fields: - `targetingType` - `inheritance` Examples: *
|
|
# AssignedTargetingOptions of targeting type
|
|
# TARGETING_TYPE_PROXIMITY_LOCATION_LIST or TARGETING_TYPE_CHANNEL `
|
|
# targetingType="TARGETING_TYPE_PROXIMITY_LOCATION_LIST" OR targetingType="
|
|
# TARGETING_TYPE_CHANNEL"` * AssignedTargetingOptions with inheritance status of
|
|
# NOT_INHERITED or INHERITED_FROM_PARTNER `inheritance="NOT_INHERITED" OR
|
|
# inheritance="INHERITED_FROM_PARTNER"` The length of this field should be no
|
|
# more than 500 characters.
|
|
# @param [String] order_by
|
|
# Field by which to sort the list. Acceptable values are: * `targetingType` (
|
|
# default) The default sorting order is ascending. To specify descending order
|
|
# for a field, a suffix "desc" should be added to the field name. Example: `
|
|
# targetingType desc`.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. The size must be an integer between `1` and `5000`. If
|
|
# unspecified, the default is '5000'. Returns error code `INVALID_ARGUMENT` if
|
|
# an invalid value is specified.
|
|
# @param [String] page_token
|
|
# A token that lets the client fetch the next page of results. Typically, this
|
|
# is the value of next_page_token returned from the previous call to `
|
|
# BulkListLineItemAssignedTargetingOptions` method. If not specified, the first
|
|
# page of results will be returned.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::BulkListLineItemAssignedTargetingOptionsResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::BulkListLineItemAssignedTargetingOptionsResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def bulk_advertiser_line_item_list_line_item_assigned_targeting_options(advertiser_id, line_item_id, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}/lineItems/{+lineItemId}:bulkListLineItemAssignedTargetingOptions', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::BulkListLineItemAssignedTargetingOptionsResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::BulkListLineItemAssignedTargetingOptionsResponse
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['lineItemId'] = line_item_id unless line_item_id.nil?
|
|
command.query['filter'] = filter unless filter.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Creates a new line item. Returns the newly created line item if successful.
|
|
# @param [Fixnum] advertiser_id
|
|
# Output only. The unique ID of the advertiser the line item belongs to.
|
|
# @param [Google::Apis::DisplayvideoV1::LineItem] line_item_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::LineItem] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::LineItem]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def create_advertiser_line_item(advertiser_id, line_item_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/advertisers/{+advertiserId}/lineItems', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::LineItem::Representation
|
|
command.request_object = line_item_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::LineItem::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::LineItem
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Deletes a line item. Returns error code `NOT_FOUND` if the line item does not
|
|
# exist. The line item should be archived first, i.e. set entity_status to `
|
|
# ENTITY_STATUS_ARCHIVED`, to be able to delete it.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser this line item belongs to.
|
|
# @param [Fixnum] line_item_id
|
|
# The ID of the line item we need to fetch.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Empty] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Empty]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def delete_advertiser_line_item(advertiser_id, line_item_id, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:delete, 'v1/advertisers/{+advertiserId}/lineItems/{+lineItemId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Empty::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Empty
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['lineItemId'] = line_item_id unless line_item_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets a line item.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the advertiser this line item belongs to.
|
|
# @param [Fixnum] line_item_id
|
|
# Required. The ID of the line item to fetch.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::LineItem] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::LineItem]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def get_advertiser_line_item(advertiser_id, line_item_id, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}/lineItems/{+lineItemId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::LineItem::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::LineItem
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['lineItemId'] = line_item_id unless line_item_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists line items in an advertiser. The order is defined by the order_by
|
|
# parameter. If a filter by entity_status is not specified, line items with `
|
|
# ENTITY_STATUS_ARCHIVED` will not be included in the results.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the advertiser to list line items for.
|
|
# @param [String] filter
|
|
# Allows filtering by line item properties. Supported syntax: * Filter
|
|
# expressions are made up of one or more restrictions. * Restrictions can be
|
|
# combined by `AND` or `OR` logical operators. A sequence of restrictions
|
|
# implicitly uses `AND`. * A restriction has the form of ``field` `operator` `
|
|
# value``. * The operator used on `flight.dateRange.endDate` must be LESS THAN (<
|
|
# ). * The operator used on `warningMessages` must be `HAS (:)`. * The operators
|
|
# used on all other fields must be `EQUALS (=)`. * Supported fields: - `
|
|
# campaignId` - `displayName` - `insertionOrderId` - `entityStatus` - `
|
|
# lineItemId` - `lineItemType` - `flight.dateRange.endDate` (input formatted as
|
|
# YYYY-MM-DD) - `warningMessages` Examples: * All line items under an insertion
|
|
# order: `insertionOrderId="1234"` * All `ENTITY_STATUS_ACTIVE` or `
|
|
# ENTITY_STATUS_PAUSED` and `LINE_ITEM_TYPE_DISPLAY_DEFAULT` line items under an
|
|
# advertiser: `(entityStatus="ENTITY_STATUS_ACTIVE" OR entityStatus="
|
|
# ENTITY_STATUS_PAUSED") AND lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"` *
|
|
# All line items whose flight dates end before March 28, 2019: `flight.dateRange.
|
|
# endDate<"2019-03-28"` * All line items that have `NO_VALID_CREATIVE` in `
|
|
# warningMessages`: `warningMessages:"NO_VALID_CREATIVE"` The length of this
|
|
# field should be no more than 500 characters.
|
|
# @param [String] order_by
|
|
# Field by which to sort the list. Acceptable values are: * "displayName" (
|
|
# default) * "entityStatus" * “flight.dateRange.endDate” The default sorting
|
|
# order is ascending. To specify descending order for a field, a suffix "desc"
|
|
# should be added to the field name. Example: `displayName desc`.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. Must be between `1` and `100`. If unspecified will
|
|
# default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is
|
|
# specified.
|
|
# @param [String] page_token
|
|
# A token identifying a page of results the server should return. Typically,
|
|
# this is the value of next_page_token returned from the previous call to `
|
|
# ListLineItems` method. If not specified, the first page of results will be
|
|
# returned.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::ListLineItemsResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::ListLineItemsResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def list_advertiser_line_items(advertiser_id, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}/lineItems', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::ListLineItemsResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::ListLineItemsResponse
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['filter'] = filter unless filter.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing line item. Returns the updated line item if successful.
|
|
# @param [Fixnum] advertiser_id
|
|
# Output only. The unique ID of the advertiser the line item belongs to.
|
|
# @param [Fixnum] line_item_id
|
|
# Output only. The unique ID of the line item. Assigned by the system.
|
|
# @param [Google::Apis::DisplayvideoV1::LineItem] line_item_object
|
|
# @param [String] update_mask
|
|
# Required. The mask to control which fields to update.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::LineItem] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::LineItem]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def patch_advertiser_line_item(advertiser_id, line_item_id, line_item_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'v1/advertisers/{+advertiserId}/lineItems/{+lineItemId}', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::LineItem::Representation
|
|
command.request_object = line_item_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::LineItem::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::LineItem
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['lineItemId'] = line_item_id unless line_item_id.nil?
|
|
command.query['updateMask'] = update_mask unless update_mask.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Assigns a targeting option to a line item. Returns the assigned targeting
|
|
# option if successful.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the advertiser the line item belongs to.
|
|
# @param [Fixnum] line_item_id
|
|
# Required. The ID of the line item the assigned targeting option will belong to.
|
|
# @param [String] targeting_type
|
|
# Required. Identifies the type of this assigned targeting option.
|
|
# @param [Google::Apis::DisplayvideoV1::AssignedTargetingOption] assigned_targeting_option_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::AssignedTargetingOption] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::AssignedTargetingOption]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def create_advertiser_line_item_targeting_type_assigned_targeting_option(advertiser_id, line_item_id, targeting_type, assigned_targeting_option_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/advertisers/{+advertiserId}/lineItems/{+lineItemId}/targetingTypes/{+targetingType}/assignedTargetingOptions', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::AssignedTargetingOption::Representation
|
|
command.request_object = assigned_targeting_option_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::AssignedTargetingOption::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::AssignedTargetingOption
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['lineItemId'] = line_item_id unless line_item_id.nil?
|
|
command.params['targetingType'] = targeting_type unless targeting_type.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Deletes an assigned targeting option from a line item.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the advertiser the line item belongs to.
|
|
# @param [Fixnum] line_item_id
|
|
# Required. The ID of the line item the assigned targeting option belongs to.
|
|
# @param [String] targeting_type
|
|
# Required. Identifies the type of this assigned targeting option.
|
|
# @param [String] assigned_targeting_option_id
|
|
# Required. The ID of the assigned targeting option to delete.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Empty] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Empty]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def delete_advertiser_line_item_targeting_type_assigned_targeting_option(advertiser_id, line_item_id, targeting_type, assigned_targeting_option_id, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:delete, 'v1/advertisers/{+advertiserId}/lineItems/{+lineItemId}/targetingTypes/{+targetingType}/assignedTargetingOptions/{+assignedTargetingOptionId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Empty::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Empty
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['lineItemId'] = line_item_id unless line_item_id.nil?
|
|
command.params['targetingType'] = targeting_type unless targeting_type.nil?
|
|
command.params['assignedTargetingOptionId'] = assigned_targeting_option_id unless assigned_targeting_option_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets a single targeting option assigned to a line item.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the advertiser the line item belongs to.
|
|
# @param [Fixnum] line_item_id
|
|
# Required. The ID of the line item the assigned targeting option belongs to.
|
|
# @param [String] targeting_type
|
|
# Required. Identifies the type of this assigned targeting option.
|
|
# @param [String] assigned_targeting_option_id
|
|
# Required. An identifier unique to the targeting type in this line item that
|
|
# identifies the assigned targeting option being requested.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::AssignedTargetingOption] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::AssignedTargetingOption]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def get_advertiser_line_item_targeting_type_assigned_targeting_option(advertiser_id, line_item_id, targeting_type, assigned_targeting_option_id, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}/lineItems/{+lineItemId}/targetingTypes/{+targetingType}/assignedTargetingOptions/{+assignedTargetingOptionId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::AssignedTargetingOption::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::AssignedTargetingOption
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['lineItemId'] = line_item_id unless line_item_id.nil?
|
|
command.params['targetingType'] = targeting_type unless targeting_type.nil?
|
|
command.params['assignedTargetingOptionId'] = assigned_targeting_option_id unless assigned_targeting_option_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists the targeting options assigned to a line item.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the advertiser the line item belongs to.
|
|
# @param [Fixnum] line_item_id
|
|
# Required. The ID of the line item to list assigned targeting options for.
|
|
# @param [String] targeting_type
|
|
# Required. Identifies the type of assigned targeting options to list.
|
|
# @param [String] filter
|
|
# Allows filtering by assigned targeting option properties. Supported syntax: *
|
|
# Filter expressions are made up of one or more restrictions. * Restrictions can
|
|
# be combined by the logical operator `OR`. * A restriction has the form of ``
|
|
# field` `operator` `value``. * The operator must be `EQUALS (=)`. * Supported
|
|
# fields: - `assignedTargetingOptionId` - `inheritance` Examples: *
|
|
# AssignedTargetingOptions with ID 1 or 2 `assignedTargetingOptionId="1" OR
|
|
# assignedTargetingOptionId="2"` * AssignedTargetingOptions with inheritance
|
|
# status of NOT_INHERITED or INHERITED_FROM_PARTNER `inheritance="NOT_INHERITED"
|
|
# OR inheritance="INHERITED_FROM_PARTNER"` The length of this field should be no
|
|
# more than 500 characters.
|
|
# @param [String] order_by
|
|
# Field by which to sort the list. Acceptable values are: * `
|
|
# assignedTargetingOptionId` (default) The default sorting order is ascending.
|
|
# To specify descending order for a field, a suffix "desc" should be added to
|
|
# the field name. Example: `assignedTargetingOptionId desc`.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. Must be between `1` and `100`. If unspecified will
|
|
# default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is
|
|
# specified.
|
|
# @param [String] page_token
|
|
# A token identifying a page of results the server should return. Typically,
|
|
# this is the value of next_page_token returned from the previous call to `
|
|
# ListLineItemAssignedTargetingOptions` method. If not specified, the first page
|
|
# of results will be returned.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::ListLineItemAssignedTargetingOptionsResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::ListLineItemAssignedTargetingOptionsResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def list_advertiser_line_item_targeting_type_assigned_targeting_options(advertiser_id, line_item_id, targeting_type, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}/lineItems/{+lineItemId}/targetingTypes/{+targetingType}/assignedTargetingOptions', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::ListLineItemAssignedTargetingOptionsResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::ListLineItemAssignedTargetingOptionsResponse
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['lineItemId'] = line_item_id unless line_item_id.nil?
|
|
command.params['targetingType'] = targeting_type unless targeting_type.nil?
|
|
command.query['filter'] = filter unless filter.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Creates a new location list. Returns the newly created location list if
|
|
# successful.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the DV360 advertiser to which the location list belongs.
|
|
# @param [Google::Apis::DisplayvideoV1::LocationList] location_list_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::LocationList] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::LocationList]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def create_advertiser_location_list(advertiser_id, location_list_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/advertisers/{+advertiserId}/locationLists', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::LocationList::Representation
|
|
command.request_object = location_list_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::LocationList::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::LocationList
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets a location list.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the DV360 advertiser to which the fetched location list
|
|
# belongs.
|
|
# @param [Fixnum] location_list_id
|
|
# Required. The ID of the location list to fetch.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::LocationList] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::LocationList]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def get_advertiser_location_list(advertiser_id, location_list_id, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}/locationLists/{+locationListId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::LocationList::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::LocationList
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['locationListId'] = location_list_id unless location_list_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists location lists based on a given advertiser id.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the DV360 advertiser to which the fetched location lists
|
|
# belong.
|
|
# @param [String] filter
|
|
# Allows filtering by location list fields. Supported syntax: * Filter
|
|
# expressions are made up of one or more restrictions. * Restrictions can be
|
|
# combined by `AND` or `OR` logical operators. A sequence of restrictions
|
|
# implicitly uses `AND`. * A restriction has the form of ``field` `operator` `
|
|
# value``. * The operator must be `EQUALS (=)`. * Supported fields: - `
|
|
# locationType` Examples: * All regional location list: `locationType="
|
|
# TARGETING_LOCATION_TYPE_REGIONAL"` * All proximity location list: `
|
|
# locationType="TARGETING_LOCATION_TYPE_PROXIMITY"`
|
|
# @param [String] order_by
|
|
# Field by which to sort the list. Acceptable values are: * `locationListId` (
|
|
# default) * `displayName` The default sorting order is ascending. To specify
|
|
# descending order for a field, a suffix "desc" should be added to the field
|
|
# name. Example: `displayName desc`.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. Must be between `1` and `100`. Defaults to `100` if not
|
|
# set. Returns error code `INVALID_ARGUMENT` if an invalid value is specified.
|
|
# @param [String] page_token
|
|
# A token identifying a page of results the server should return. Typically,
|
|
# this is the value of next_page_token returned from the previous call to `
|
|
# ListLocationLists` method. If not specified, the first page of results will be
|
|
# returned.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::ListLocationListsResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::ListLocationListsResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def list_advertiser_location_lists(advertiser_id, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}/locationLists', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::ListLocationListsResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::ListLocationListsResponse
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['filter'] = filter unless filter.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates a location list. Returns the updated location list if successful.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the DV360 advertiser to which the location lists belongs.
|
|
# @param [Fixnum] location_list_id
|
|
# Output only. The unique ID of the location list. Assigned by the system.
|
|
# @param [Google::Apis::DisplayvideoV1::LocationList] location_list_object
|
|
# @param [String] update_mask
|
|
# Required. The mask to control which fields to update.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::LocationList] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::LocationList]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def patch_advertiser_location_list(advertiser_id, location_list_id, location_list_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'v1/advertisers/{+advertiserId}/locationLists/{locationListId}', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::LocationList::Representation
|
|
command.request_object = location_list_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::LocationList::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::LocationList
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['locationListId'] = location_list_id unless location_list_id.nil?
|
|
command.query['updateMask'] = update_mask unless update_mask.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Bulk edits multiple assignments between locations and a single location list.
|
|
# The operation will delete the assigned locations provided in
|
|
# BulkEditAssignedLocationsRequest.deleted_assigned_locations and then create
|
|
# the assigned locations provided in BulkEditAssignedLocationsRequest.
|
|
# created_assigned_locations.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the DV360 advertiser to which the location list belongs.
|
|
# @param [Fixnum] location_list_id
|
|
# Required. The ID of the location list to which these assignments are assigned.
|
|
# @param [Google::Apis::DisplayvideoV1::BulkEditAssignedLocationsRequest] bulk_edit_assigned_locations_request_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::BulkEditAssignedLocationsResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::BulkEditAssignedLocationsResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def bulk_edit_assigned_locations(advertiser_id, location_list_id, bulk_edit_assigned_locations_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/advertisers/{advertiserId}/locationLists/{+locationListId}/assignedLocations:bulkEdit', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::BulkEditAssignedLocationsRequest::Representation
|
|
command.request_object = bulk_edit_assigned_locations_request_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::BulkEditAssignedLocationsResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::BulkEditAssignedLocationsResponse
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['locationListId'] = location_list_id unless location_list_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Creates an assignment between a location and a location list.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the DV360 advertiser to which the location list belongs.
|
|
# @param [Fixnum] location_list_id
|
|
# Required. The ID of the location list for which the assignment will be created.
|
|
# @param [Google::Apis::DisplayvideoV1::AssignedLocation] assigned_location_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::AssignedLocation] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::AssignedLocation]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def create_advertiser_location_list_assigned_location(advertiser_id, location_list_id, assigned_location_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::AssignedLocation::Representation
|
|
command.request_object = assigned_location_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::AssignedLocation::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::AssignedLocation
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['locationListId'] = location_list_id unless location_list_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Deletes the assignment between a location and a location list.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the DV360 advertiser to which the location list belongs.
|
|
# @param [Fixnum] location_list_id
|
|
# Required. The ID of the location list to which this assignment is assigned.
|
|
# @param [Fixnum] assigned_location_id
|
|
# Required. The ID of the assigned location to delete.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Empty] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Empty]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def delete_advertiser_location_list_assigned_location(advertiser_id, location_list_id, assigned_location_id, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:delete, 'v1/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations/{+assignedLocationId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Empty::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Empty
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['locationListId'] = location_list_id unless location_list_id.nil?
|
|
command.params['assignedLocationId'] = assigned_location_id unless assigned_location_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists locations assigned to a location list.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the DV360 advertiser to which the location list belongs.
|
|
# @param [Fixnum] location_list_id
|
|
# Required. The ID of the location list to which these assignments are assigned.
|
|
# @param [String] filter
|
|
# Allows filtering by location list assignment fields. Supported syntax: *
|
|
# Filter expressions are made up of one or more restrictions. * Restrictions can
|
|
# be combined by the logical operator `OR`. * A restriction has the form of ``
|
|
# field` `operator` `value``. * The operator must be `EQUALS (=)`. * Supported
|
|
# fields: - `assignedLocationId` The length of this field should be no more than
|
|
# 500 characters.
|
|
# @param [String] order_by
|
|
# Field by which to sort the list. Acceptable values are: * `assignedLocationId`
|
|
# (default) The default sorting order is ascending. To specify descending order
|
|
# for a field, a suffix " desc" should be added to the field name. Example: `
|
|
# assignedLocationId desc`.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. Must be between `1` and `100`. If unspecified will
|
|
# default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is
|
|
# specified.
|
|
# @param [String] page_token
|
|
# A token identifying a page of results the server should return. Typically,
|
|
# this is the value of next_page_token returned from the previous call to `
|
|
# ListAssignedLocations` method. If not specified, the first page of results
|
|
# will be returned.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::ListAssignedLocationsResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::ListAssignedLocationsResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def list_advertiser_location_list_assigned_locations(advertiser_id, location_list_id, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::ListAssignedLocationsResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::ListAssignedLocationsResponse
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['locationListId'] = location_list_id unless location_list_id.nil?
|
|
command.query['filter'] = filter unless filter.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Creates a new negative keyword list. Returns the newly created negative
|
|
# keyword list if successful.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the DV360 advertiser to which the negative keyword list
|
|
# will belong.
|
|
# @param [Google::Apis::DisplayvideoV1::NegativeKeywordList] negative_keyword_list_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::NegativeKeywordList] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::NegativeKeywordList]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def create_advertiser_negative_keyword_list(advertiser_id, negative_keyword_list_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/advertisers/{+advertiserId}/negativeKeywordLists', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::NegativeKeywordList::Representation
|
|
command.request_object = negative_keyword_list_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::NegativeKeywordList::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::NegativeKeywordList
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Deletes a negative keyword list given an advertiser ID and a negative keyword
|
|
# list ID.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the DV360 advertiser to which the negative keyword list
|
|
# belongs.
|
|
# @param [Fixnum] negative_keyword_list_id
|
|
# Required. The ID of the negative keyword list to delete.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Empty] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Empty]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def delete_advertiser_negative_keyword_list(advertiser_id, negative_keyword_list_id, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:delete, 'v1/advertisers/{+advertiserId}/negativeKeywordLists/{+negativeKeywordListId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Empty::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Empty
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['negativeKeywordListId'] = negative_keyword_list_id unless negative_keyword_list_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets a negative keyword list given an advertiser ID and a negative keyword
|
|
# list ID.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the DV360 advertiser to which the fetched negative keyword
|
|
# list belongs.
|
|
# @param [Fixnum] negative_keyword_list_id
|
|
# Required. The ID of the negative keyword list to fetch.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::NegativeKeywordList] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::NegativeKeywordList]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def get_advertiser_negative_keyword_list(advertiser_id, negative_keyword_list_id, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}/negativeKeywordLists/{+negativeKeywordListId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::NegativeKeywordList::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::NegativeKeywordList
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['negativeKeywordListId'] = negative_keyword_list_id unless negative_keyword_list_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists negative keyword lists based on a given advertiser id.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the DV360 advertiser to which the fetched negative keyword
|
|
# lists belong.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. Must be between `1` and `100`. Defaults to `100` if not
|
|
# set. Returns error code `INVALID_ARGUMENT` if an invalid value is specified.
|
|
# @param [String] page_token
|
|
# A token identifying a page of results the server should return. Typically,
|
|
# this is the value of next_page_token returned from the previous call to `
|
|
# ListNegativeKeywordLists` method. If not specified, the first page of results
|
|
# will be returned.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::ListNegativeKeywordListsResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::ListNegativeKeywordListsResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def list_advertiser_negative_keyword_lists(advertiser_id, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}/negativeKeywordLists', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::ListNegativeKeywordListsResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::ListNegativeKeywordListsResponse
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates a negative keyword list. Returns the updated negative keyword list if
|
|
# successful.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the DV360 advertiser to which the negative keyword list
|
|
# belongs.
|
|
# @param [Fixnum] negative_keyword_list_id
|
|
# Output only. The unique ID of the negative keyword list. Assigned by the
|
|
# system.
|
|
# @param [Google::Apis::DisplayvideoV1::NegativeKeywordList] negative_keyword_list_object
|
|
# @param [String] update_mask
|
|
# Required. The mask to control which fields to update.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::NegativeKeywordList] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::NegativeKeywordList]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def patch_advertiser_negative_keyword_list(advertiser_id, negative_keyword_list_id, negative_keyword_list_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'v1/advertisers/{+advertiserId}/negativeKeywordLists/{negativeKeywordListId}', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::NegativeKeywordList::Representation
|
|
command.request_object = negative_keyword_list_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::NegativeKeywordList::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::NegativeKeywordList
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['negativeKeywordListId'] = negative_keyword_list_id unless negative_keyword_list_id.nil?
|
|
command.query['updateMask'] = update_mask unless update_mask.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Bulk edits negative keywords in a single negative keyword list. The operation
|
|
# will delete the negative keywords provided in BulkEditNegativeKeywordsRequest.
|
|
# deleted_negative_keywords and then create the negative keywords provided in
|
|
# BulkEditNegativeKeywordsRequest.created_negative_keywords. This operation is
|
|
# guaranteed to be atomic and will never result in a partial success or partial
|
|
# failure.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the DV360 advertiser to which the parent negative keyword
|
|
# list belongs.
|
|
# @param [Fixnum] negative_keyword_list_id
|
|
# Required. The ID of the parent negative keyword list to which the negative
|
|
# keywords belong.
|
|
# @param [Google::Apis::DisplayvideoV1::BulkEditNegativeKeywordsRequest] bulk_edit_negative_keywords_request_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::BulkEditNegativeKeywordsResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::BulkEditNegativeKeywordsResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def bulk_edit_negative_keywords(advertiser_id, negative_keyword_list_id, bulk_edit_negative_keywords_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/advertisers/{advertiserId}/negativeKeywordLists/{+negativeKeywordListId}/negativeKeywords:bulkEdit', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::BulkEditNegativeKeywordsRequest::Representation
|
|
command.request_object = bulk_edit_negative_keywords_request_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::BulkEditNegativeKeywordsResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::BulkEditNegativeKeywordsResponse
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['negativeKeywordListId'] = negative_keyword_list_id unless negative_keyword_list_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Creates a negative keyword in a negative keyword list.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the DV360 advertiser to which the parent negative keyword
|
|
# list belongs.
|
|
# @param [Fixnum] negative_keyword_list_id
|
|
# Required. The ID of the parent negative keyword list in which the negative
|
|
# keyword will be created.
|
|
# @param [Google::Apis::DisplayvideoV1::NegativeKeyword] negative_keyword_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::NegativeKeyword] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::NegativeKeyword]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def create_advertiser_negative_keyword_list_negative_keyword(advertiser_id, negative_keyword_list_id, negative_keyword_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/advertisers/{advertiserId}/negativeKeywordLists/{+negativeKeywordListId}/negativeKeywords', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::NegativeKeyword::Representation
|
|
command.request_object = negative_keyword_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::NegativeKeyword::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::NegativeKeyword
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['negativeKeywordListId'] = negative_keyword_list_id unless negative_keyword_list_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Deletes a negative keyword from a negative keyword list.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the DV360 advertiser to which the parent negative keyword
|
|
# list belongs.
|
|
# @param [Fixnum] negative_keyword_list_id
|
|
# Required. The ID of the parent negative keyword list to which the negative
|
|
# keyword belongs.
|
|
# @param [String] keyword_value
|
|
# Required. The keyword value of the negative keyword to delete.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Empty] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Empty]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def delete_advertiser_negative_keyword_list_negative_keyword(advertiser_id, negative_keyword_list_id, keyword_value, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:delete, 'v1/advertisers/{advertiserId}/negativeKeywordLists/{+negativeKeywordListId}/negativeKeywords/{+keywordValue}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Empty::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Empty
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['negativeKeywordListId'] = negative_keyword_list_id unless negative_keyword_list_id.nil?
|
|
command.params['keywordValue'] = keyword_value unless keyword_value.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists negative keywords in a negative keyword list.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the DV360 advertiser to which the parent negative keyword
|
|
# list belongs.
|
|
# @param [Fixnum] negative_keyword_list_id
|
|
# Required. The ID of the parent negative keyword list to which the requested
|
|
# negative keywords belong.
|
|
# @param [String] filter
|
|
# Allows filtering by negative keyword fields. Supported syntax: * Filter
|
|
# expressions for negative keyword currently can only contain at most one *
|
|
# restriction. * A restriction has the form of ``field` `operator` `value``. *
|
|
# The operator must be `CONTAINS (:)`. * Supported fields: - `keywordValue`
|
|
# Examples: * All negative keywords for which the keyword value contains "google"
|
|
# : `keywordValue : "google"`
|
|
# @param [String] order_by
|
|
# Field by which to sort the list. Acceptable values are: * `keywordValue` (
|
|
# default) The default sorting order is ascending. To specify descending order
|
|
# for a field, a suffix " desc" should be added to the field name. Example: `
|
|
# keywordValue desc`.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. Must be between `1` and `100`. If unspecified will
|
|
# default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is
|
|
# specified.
|
|
# @param [String] page_token
|
|
# A token identifying a page of results the server should return. Typically,
|
|
# this is the value of next_page_token returned from the previous call to `
|
|
# ListNegativeKeywords` method. If not specified, the first page of results will
|
|
# be returned.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::ListNegativeKeywordsResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::ListNegativeKeywordsResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def list_advertiser_negative_keyword_list_negative_keywords(advertiser_id, negative_keyword_list_id, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}/negativeKeywordLists/{+negativeKeywordListId}/negativeKeywords', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::ListNegativeKeywordsResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::ListNegativeKeywordsResponse
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['negativeKeywordListId'] = negative_keyword_list_id unless negative_keyword_list_id.nil?
|
|
command.query['filter'] = filter unless filter.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Assigns a targeting option to an advertiser. Returns the assigned targeting
|
|
# option if successful.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the advertiser.
|
|
# @param [String] targeting_type
|
|
# Required. Identifies the type of this assigned targeting option.
|
|
# @param [Google::Apis::DisplayvideoV1::AssignedTargetingOption] assigned_targeting_option_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::AssignedTargetingOption] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::AssignedTargetingOption]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def create_advertiser_targeting_type_assigned_targeting_option(advertiser_id, targeting_type, assigned_targeting_option_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/advertisers/{+advertiserId}/targetingTypes/{+targetingType}/assignedTargetingOptions', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::AssignedTargetingOption::Representation
|
|
command.request_object = assigned_targeting_option_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::AssignedTargetingOption::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::AssignedTargetingOption
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['targetingType'] = targeting_type unless targeting_type.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Deletes an assigned targeting option from an advertiser.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the advertiser.
|
|
# @param [String] targeting_type
|
|
# Required. Identifies the type of this assigned targeting option.
|
|
# @param [String] assigned_targeting_option_id
|
|
# Required. The ID of the assigned targeting option to delete.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Empty] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Empty]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def delete_advertiser_targeting_type_assigned_targeting_option(advertiser_id, targeting_type, assigned_targeting_option_id, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:delete, 'v1/advertisers/{+advertiserId}/targetingTypes/{+targetingType}/assignedTargetingOptions/{+assignedTargetingOptionId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Empty::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Empty
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['targetingType'] = targeting_type unless targeting_type.nil?
|
|
command.params['assignedTargetingOptionId'] = assigned_targeting_option_id unless assigned_targeting_option_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets a single targeting option assigned to an advertiser.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the advertiser.
|
|
# @param [String] targeting_type
|
|
# Required. Identifies the type of this assigned targeting option.
|
|
# @param [String] assigned_targeting_option_id
|
|
# Required. An identifier unique to the targeting type in this advertiser that
|
|
# identifies the assigned targeting option being requested.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::AssignedTargetingOption] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::AssignedTargetingOption]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def get_advertiser_targeting_type_assigned_targeting_option(advertiser_id, targeting_type, assigned_targeting_option_id, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}/targetingTypes/{+targetingType}/assignedTargetingOptions/{+assignedTargetingOptionId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::AssignedTargetingOption::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::AssignedTargetingOption
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['targetingType'] = targeting_type unless targeting_type.nil?
|
|
command.params['assignedTargetingOptionId'] = assigned_targeting_option_id unless assigned_targeting_option_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists the targeting options assigned to an advertiser.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The ID of the advertiser.
|
|
# @param [String] targeting_type
|
|
# Required. Identifies the type of assigned targeting options to list.
|
|
# @param [String] filter
|
|
# Allows filtering by assigned targeting option properties. Supported syntax: *
|
|
# Filter expressions are made up of one or more restrictions. * Restrictions can
|
|
# be combined by the logical operator `OR`. * A restriction has the form of ``
|
|
# field` `operator` `value``. * The operator must be `EQUALS (=)`. * Supported
|
|
# fields: - `assignedTargetingOptionId` Examples: * AssignedTargetingOption with
|
|
# ID 123456 `assignedTargetingOptionId="123456"` The length of this field should
|
|
# be no more than 500 characters.
|
|
# @param [String] order_by
|
|
# Field by which to sort the list. Acceptable values are: * `
|
|
# assignedTargetingOptionId` (default) The default sorting order is ascending.
|
|
# To specify descending order for a field, a suffix "desc" should be added to
|
|
# the field name. Example: `assignedTargetingOptionId desc`.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. Must be between `1` and `100`. If unspecified will
|
|
# default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is
|
|
# specified.
|
|
# @param [String] page_token
|
|
# A token identifying a page of results the server should return. Typically,
|
|
# this is the value of next_page_token returned from the previous call to `
|
|
# ListAdvertiserAssignedTargetingOptions` method. If not specified, the first
|
|
# page of results will be returned.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::ListAdvertiserAssignedTargetingOptionsResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::ListAdvertiserAssignedTargetingOptionsResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def list_advertiser_targeting_type_assigned_targeting_options(advertiser_id, targeting_type, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/advertisers/{+advertiserId}/targetingTypes/{+targetingType}/assignedTargetingOptions', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::ListAdvertiserAssignedTargetingOptionsResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::ListAdvertiserAssignedTargetingOptionsResponse
|
|
command.params['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.params['targetingType'] = targeting_type unless targeting_type.nil?
|
|
command.query['filter'] = filter unless filter.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets a combined audience.
|
|
# @param [Fixnum] combined_audience_id
|
|
# Required. The ID of the combined audience to fetch.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that has access to the fetched combined audience.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that has access to the fetched combined audience.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::CombinedAudience] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::CombinedAudience]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def get_combined_audience(combined_audience_id, advertiser_id: nil, partner_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/combinedAudiences/{+combinedAudienceId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::CombinedAudience::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::CombinedAudience
|
|
command.params['combinedAudienceId'] = combined_audience_id unless combined_audience_id.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists combined audiences. The order is defined by the order_by parameter.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that has access to the fetched combined audiences.
|
|
# @param [String] filter
|
|
# Allows filtering by combined audience fields. Supported syntax: * Filter
|
|
# expressions for combined audiences currently can only contain at most one
|
|
# restriction. * A restriction has the form of ``field` `operator` `value``. *
|
|
# The operator must be `CONTAINS (:)`. * Supported fields: - `displayName`
|
|
# Examples: * All combined audiences for which the display name contains "Google"
|
|
# : `displayName : "Google"`. The length of this field should be no more than
|
|
# 500 characters.
|
|
# @param [String] order_by
|
|
# Field by which to sort the list. Acceptable values are: * `combinedAudienceId`
|
|
# (default) * `displayName` The default sorting order is ascending. To specify
|
|
# descending order for a field, a suffix "desc" should be added to the field
|
|
# name. Example: `displayName desc`.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. Must be between `1` and `100`. If unspecified will
|
|
# default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is
|
|
# specified.
|
|
# @param [String] page_token
|
|
# A token identifying a page of results the server should return. Typically,
|
|
# this is the value of next_page_token returned from the previous call to `
|
|
# ListCombinedAudiences` method. If not specified, the first page of results
|
|
# will be returned.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that has access to the fetched combined audiences.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::ListCombinedAudiencesResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::ListCombinedAudiencesResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def list_combined_audiences(advertiser_id: nil, filter: nil, order_by: nil, page_size: nil, page_token: nil, partner_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/combinedAudiences', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::ListCombinedAudiencesResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::ListCombinedAudiencesResponse
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['filter'] = filter unless filter.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets a custom bidding algorithm.
|
|
# @param [Fixnum] custom_bidding_algorithm_id
|
|
# Required. The ID of the custom bidding algorithm to fetch.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the DV360 partner that has access to the custom bidding algorithm.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the DV360 partner that has access to the custom bidding algorithm.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::CustomBiddingAlgorithm] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::CustomBiddingAlgorithm]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def get_custom_bidding_algorithm(custom_bidding_algorithm_id, advertiser_id: nil, partner_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/customBiddingAlgorithms/{+customBiddingAlgorithmId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::CustomBiddingAlgorithm::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::CustomBiddingAlgorithm
|
|
command.params['customBiddingAlgorithmId'] = custom_bidding_algorithm_id unless custom_bidding_algorithm_id.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists custom bidding algorithms that are accessible to the current user and
|
|
# can be used in bidding stratgies. The order is defined by the order_by
|
|
# parameter.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the DV360 advertiser that has access to the custom bidding algorithm.
|
|
# @param [String] filter
|
|
# Allows filtering by custom bidding algorithm fields. Supported syntax: *
|
|
# Filter expressions are made up of one or more restrictions. * Restrictions can
|
|
# be combined by `AND`. A sequence of restrictions * implicitly uses `AND`. * A
|
|
# restriction has the form of ``field` `operator` `value``. * The operator must
|
|
# be `CONTAINS (:)` or `EQUALS (=)`. * The operator must be `CONTAINS (:)` for
|
|
# the following field: - `displayName` * The operator must be `EQUALS (=)` for
|
|
# the following field: - `customBiddingAlgorithmType` * For `displayName`, the
|
|
# value is a string. We return all custom bidding algorithms whose display_name
|
|
# contains such string. * For `customBiddingAlgorithmType`, the value is a
|
|
# string. We return all algorithms whose custom_bidding_algorithm_type is equal
|
|
# to the given type. Examples: * All custom bidding algorithms for which the
|
|
# display name contains "politics": `displayName:politics`. * All custom bidding
|
|
# algorithms for which the type is "SCRIPT_BASED": `customBiddingAlgorithmType=
|
|
# SCRIPT_BASED` The length of this field should be no more than 500 characters.
|
|
# @param [String] order_by
|
|
# Field by which to sort the list. Acceptable values are: * `displayName` (
|
|
# default) The default sorting order is ascending. To specify descending order
|
|
# for a field, a suffix "desc" should be added to the field name. Example: `
|
|
# displayName desc`.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. Must be between `1` and `100`. If unspecified will
|
|
# default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is
|
|
# specified.
|
|
# @param [String] page_token
|
|
# A token identifying a page of results the server should return. Typically,
|
|
# this is the value of next_page_token returned from the previous call to `
|
|
# ListCustomBiddingAlgorithms` method. If not specified, the first page of
|
|
# results will be returned.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the DV360 partner that has access to the custom bidding algorithm.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::ListCustomBiddingAlgorithmsResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::ListCustomBiddingAlgorithmsResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def list_custom_bidding_algorithms(advertiser_id: nil, filter: nil, order_by: nil, page_size: nil, page_token: nil, partner_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/customBiddingAlgorithms', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::ListCustomBiddingAlgorithmsResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::ListCustomBiddingAlgorithmsResponse
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['filter'] = filter unless filter.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets a custom list.
|
|
# @param [Fixnum] custom_list_id
|
|
# Required. The ID of the custom list to fetch.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the DV360 advertiser that has access to the fetched custom lists.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::CustomList] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::CustomList]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def get_custom_list(custom_list_id, advertiser_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/customLists/{+customListId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::CustomList::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::CustomList
|
|
command.params['customListId'] = custom_list_id unless custom_list_id.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists custom lists. The order is defined by the order_by parameter.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the DV360 advertiser that has access to the fetched custom lists.
|
|
# @param [String] filter
|
|
# Allows filtering by custom list fields. Supported syntax: * Filter expressions
|
|
# for custom lists currently can only contain at most one restriction. * A
|
|
# restriction has the form of ``field` `operator` `value``. * The operator must
|
|
# be `CONTAINS (:)`. * Supported fields: - `displayName` Examples: * All custom
|
|
# lists for which the display name contains "Google": `displayName : "Google"`.
|
|
# The length of this field should be no more than 500 characters.
|
|
# @param [String] order_by
|
|
# Field by which to sort the list. Acceptable values are: * `customListId` (
|
|
# default) * `displayName` The default sorting order is ascending. To specify
|
|
# descending order for a field, a suffix "desc" should be added to the field
|
|
# name. Example: `displayName desc`.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. Must be between `1` and `100`. If unspecified will
|
|
# default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is
|
|
# specified.
|
|
# @param [String] page_token
|
|
# A token identifying a page of results the server should return. Typically,
|
|
# this is the value of next_page_token returned from the previous call to `
|
|
# ListCustomLists` method. If not specified, the first page of results will be
|
|
# returned.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::ListCustomListsResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::ListCustomListsResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def list_custom_lists(advertiser_id: nil, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/customLists', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::ListCustomListsResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::ListCustomListsResponse
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['filter'] = filter unless filter.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets a first and third party audience.
|
|
# @param [Fixnum] first_and_third_party_audience_id
|
|
# Required. The ID of the first and third party audience to fetch.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that has access to the fetched first and third party
|
|
# audience.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that has access to the fetched first and third party
|
|
# audience.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::FirstAndThirdPartyAudience] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::FirstAndThirdPartyAudience]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def get_first_and_third_party_audience(first_and_third_party_audience_id, advertiser_id: nil, partner_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/firstAndThirdPartyAudiences/{+firstAndThirdPartyAudienceId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::FirstAndThirdPartyAudience::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::FirstAndThirdPartyAudience
|
|
command.params['firstAndThirdPartyAudienceId'] = first_and_third_party_audience_id unless first_and_third_party_audience_id.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists first and third party audiences. The order is defined by the order_by
|
|
# parameter.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that has access to the fetched first and third party
|
|
# audiences.
|
|
# @param [String] filter
|
|
# Allows filtering by first and third party audience fields. Supported syntax: *
|
|
# Filter expressions for first and third party audiences currently can only
|
|
# contain at most one restriction. * A restriction has the form of ``field` `
|
|
# operator` `value``. * The operator must be `CONTAINS (:)`. * Supported fields:
|
|
# - `displayName` Examples: * All first and third party audiences for which the
|
|
# display name contains "Google": `displayName : "Google"`. The length of this
|
|
# field should be no more than 500 characters.
|
|
# @param [String] order_by
|
|
# Field by which to sort the list. Acceptable values are: * `
|
|
# firstAndThirdPartyAudienceId` (default) * `displayName` The default sorting
|
|
# order is ascending. To specify descending order for a field, a suffix "desc"
|
|
# should be added to the field name. Example: `displayName desc`.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. Must be between `1` and `100`. If unspecified will
|
|
# default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is
|
|
# specified.
|
|
# @param [String] page_token
|
|
# A token identifying a page of results the server should return. Typically,
|
|
# this is the value of next_page_token returned from the previous call to `
|
|
# ListFirstAndThirdPartyAudiences` method. If not specified, the first page of
|
|
# results will be returned.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that has access to the fetched first and third party
|
|
# audiences.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::ListFirstAndThirdPartyAudiencesResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::ListFirstAndThirdPartyAudiencesResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def list_first_and_third_party_audiences(advertiser_id: nil, filter: nil, order_by: nil, page_size: nil, page_token: nil, partner_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/firstAndThirdPartyAudiences', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::ListFirstAndThirdPartyAudiencesResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::ListFirstAndThirdPartyAudiencesResponse
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['filter'] = filter unless filter.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets a Floodlight group.
|
|
# @param [Fixnum] floodlight_group_id
|
|
# Required. The ID of the Floodlight group to fetch.
|
|
# @param [Fixnum] partner_id
|
|
# Required. The partner context by which the Floodlight group is being accessed.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::FloodlightGroup] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::FloodlightGroup]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def get_floodlight_group(floodlight_group_id, partner_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/floodlightGroups/{+floodlightGroupId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::FloodlightGroup::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::FloodlightGroup
|
|
command.params['floodlightGroupId'] = floodlight_group_id unless floodlight_group_id.nil?
|
|
command.query['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing Floodlight group. Returns the updated Floodlight group if
|
|
# successful.
|
|
# @param [Fixnum] floodlight_group_id
|
|
# Output only. The unique ID of the Floodlight group. Assigned by the system.
|
|
# @param [Google::Apis::DisplayvideoV1::FloodlightGroup] floodlight_group_object
|
|
# @param [Fixnum] partner_id
|
|
# Required. The partner context by which the Floodlight group is being accessed.
|
|
# @param [String] update_mask
|
|
# Required. The mask to control which fields to update.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::FloodlightGroup] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::FloodlightGroup]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def patch_floodlight_group(floodlight_group_id, floodlight_group_object = nil, partner_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'v1/floodlightGroups/{floodlightGroupId}', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::FloodlightGroup::Representation
|
|
command.request_object = floodlight_group_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::FloodlightGroup::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::FloodlightGroup
|
|
command.params['floodlightGroupId'] = floodlight_group_id unless floodlight_group_id.nil?
|
|
command.query['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['updateMask'] = update_mask unless update_mask.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets a Google audience.
|
|
# @param [Fixnum] google_audience_id
|
|
# Required. The ID of the Google audience to fetch.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that has access to the fetched Google audience.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that has access to the fetched Google audience.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::GoogleAudience] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::GoogleAudience]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def get_google_audience(google_audience_id, advertiser_id: nil, partner_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/googleAudiences/{+googleAudienceId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::GoogleAudience::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::GoogleAudience
|
|
command.params['googleAudienceId'] = google_audience_id unless google_audience_id.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists Google audiences. The order is defined by the order_by parameter.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that has access to the fetched Google audiences.
|
|
# @param [String] filter
|
|
# Allows filtering by Google audience fields. Supported syntax: * Filter
|
|
# expressions for Google audiences currently can only contain at most one
|
|
# restriction. * A restriction has the form of ``field` `operator` `value``. *
|
|
# The operator must be `CONTAINS (:)`. * Supported fields: - `displayName`
|
|
# Examples: * All Google audiences for which the display name contains "Google":
|
|
# `displayName : "Google"`. The length of this field should be no more than 500
|
|
# characters.
|
|
# @param [String] order_by
|
|
# Field by which to sort the list. Acceptable values are: * `googleAudienceId` (
|
|
# default) * `displayName` The default sorting order is ascending. To specify
|
|
# descending order for a field, a suffix "desc" should be added to the field
|
|
# name. Example: `displayName desc`.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. Must be between `1` and `100`. If unspecified will
|
|
# default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is
|
|
# specified.
|
|
# @param [String] page_token
|
|
# A token identifying a page of results the server should return. Typically,
|
|
# this is the value of next_page_token returned from the previous call to `
|
|
# ListGoogleAudiences` method. If not specified, the first page of results will
|
|
# be returned.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that has access to the fetched Google audiences.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::ListGoogleAudiencesResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::ListGoogleAudiencesResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def list_google_audiences(advertiser_id: nil, filter: nil, order_by: nil, page_size: nil, page_token: nil, partner_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/googleAudiences', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::ListGoogleAudiencesResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::ListGoogleAudiencesResponse
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['filter'] = filter unless filter.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Creates a new inventory source group. Returns the newly created inventory
|
|
# source group if successful.
|
|
# @param [Google::Apis::DisplayvideoV1::InventorySourceGroup] inventory_source_group_object
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that owns the inventory source group. The parent
|
|
# partner will not have access to this group.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that owns the inventory source group. Only this partner
|
|
# will have write access to this group. Only advertisers to which this group is
|
|
# explicitly shared will have read access to this group.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::InventorySourceGroup] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::InventorySourceGroup]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def create_inventory_source_group(inventory_source_group_object = nil, advertiser_id: nil, partner_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/inventorySourceGroups', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::InventorySourceGroup::Representation
|
|
command.request_object = inventory_source_group_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::InventorySourceGroup::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::InventorySourceGroup
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Deletes an inventory source group.
|
|
# @param [Fixnum] inventory_source_group_id
|
|
# Required. The ID of the inventory source group to delete.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that owns the inventory source group. The parent
|
|
# partner does not have access to this group.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that owns the inventory source group. Only this partner
|
|
# has write access to this group.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Empty] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Empty]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def delete_inventory_source_group(inventory_source_group_id, advertiser_id: nil, partner_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:delete, 'v1/inventorySourceGroups/{+inventorySourceGroupId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Empty::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Empty
|
|
command.params['inventorySourceGroupId'] = inventory_source_group_id unless inventory_source_group_id.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets an inventory source group.
|
|
# @param [Fixnum] inventory_source_group_id
|
|
# Required. The ID of the inventory source group to fetch.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that has access to the inventory source group. If an
|
|
# inventory source group is partner-owned, only advertisers to which the group
|
|
# is explicitly shared can access the group.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that has access to the inventory source group. A partner
|
|
# cannot access an advertiser-owned inventory source group.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::InventorySourceGroup] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::InventorySourceGroup]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def get_inventory_source_group(inventory_source_group_id, advertiser_id: nil, partner_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/inventorySourceGroups/{+inventorySourceGroupId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::InventorySourceGroup::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::InventorySourceGroup
|
|
command.params['inventorySourceGroupId'] = inventory_source_group_id unless inventory_source_group_id.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists inventory source groups that are accessible to the current user. The
|
|
# order is defined by the order_by parameter.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that has access to the inventory source group. If an
|
|
# inventory source group is partner-owned, only advertisers to which the group
|
|
# is explicitly shared can access the group.
|
|
# @param [String] filter
|
|
# Allows filtering by inventory source group properties. Supported syntax: *
|
|
# Filter expressions are made up of one or more restrictions. * Restrictions can
|
|
# be combined by the logical operator `OR`. * A restriction has the form of ``
|
|
# field` `operator` `value``. * The operator must be `EQUALS (=)`. * Supported
|
|
# fields: - `inventorySourceGroupId` The length of this field should be no more
|
|
# than 500 characters.
|
|
# @param [String] order_by
|
|
# Field by which to sort the list. Acceptable values are: * `displayName` (
|
|
# default) * `inventorySourceGroupId` The default sorting order is ascending. To
|
|
# specify descending order for a field, a suffix "desc" should be added to the
|
|
# field name. For example, `displayName desc`.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. Must be between `1` and `100`. If unspecified will
|
|
# default to `100`.
|
|
# @param [String] page_token
|
|
# A token identifying a page of results the server should return. Typically,
|
|
# this is the value of next_page_token returned from the previous call to `
|
|
# ListInventorySources` method. If not specified, the first page of results will
|
|
# be returned.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that has access to the inventory source group. A partner
|
|
# cannot access advertiser-owned inventory source groups.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::ListInventorySourceGroupsResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::ListInventorySourceGroupsResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def list_inventory_source_groups(advertiser_id: nil, filter: nil, order_by: nil, page_size: nil, page_token: nil, partner_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/inventorySourceGroups', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::ListInventorySourceGroupsResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::ListInventorySourceGroupsResponse
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['filter'] = filter unless filter.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an inventory source group. Returns the updated inventory source group
|
|
# if successful.
|
|
# @param [Fixnum] inventory_source_group_id
|
|
# Output only. The unique ID of the inventory source group. Assigned by the
|
|
# system.
|
|
# @param [Google::Apis::DisplayvideoV1::InventorySourceGroup] inventory_source_group_object
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that owns the inventory source group. The parent
|
|
# partner does not have access to this group.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that owns the inventory source group. Only this partner
|
|
# has write access to this group.
|
|
# @param [String] update_mask
|
|
# Required. The mask to control which fields to update.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::InventorySourceGroup] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::InventorySourceGroup]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def patch_inventory_source_group(inventory_source_group_id, inventory_source_group_object = nil, advertiser_id: nil, partner_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'v1/inventorySourceGroups/{inventorySourceGroupId}', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::InventorySourceGroup::Representation
|
|
command.request_object = inventory_source_group_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::InventorySourceGroup::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::InventorySourceGroup
|
|
command.params['inventorySourceGroupId'] = inventory_source_group_id unless inventory_source_group_id.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['updateMask'] = update_mask unless update_mask.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Bulk edits multiple assignments between inventory sources and a single
|
|
# inventory source group. The operation will delete the assigned inventory
|
|
# sources provided in BulkEditAssignedInventorySourcesRequest.
|
|
# deleted_assigned_inventory_sources and then create the assigned inventory
|
|
# sources provided in BulkEditAssignedInventorySourcesRequest.
|
|
# created_assigned_inventory_sources.
|
|
# @param [Fixnum] inventory_source_group_id
|
|
# Required. The ID of the inventory source group to which the assignments are
|
|
# assigned.
|
|
# @param [Google::Apis::DisplayvideoV1::BulkEditAssignedInventorySourcesRequest] bulk_edit_assigned_inventory_sources_request_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::BulkEditAssignedInventorySourcesResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::BulkEditAssignedInventorySourcesResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def bulk_edit_assigned_inventory_sources(inventory_source_group_id, bulk_edit_assigned_inventory_sources_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/inventorySourceGroups/{+inventorySourceGroupId}/assignedInventorySources:bulkEdit', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::BulkEditAssignedInventorySourcesRequest::Representation
|
|
command.request_object = bulk_edit_assigned_inventory_sources_request_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::BulkEditAssignedInventorySourcesResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::BulkEditAssignedInventorySourcesResponse
|
|
command.params['inventorySourceGroupId'] = inventory_source_group_id unless inventory_source_group_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Creates an assignment between an inventory source and an inventory source
|
|
# group.
|
|
# @param [Fixnum] inventory_source_group_id
|
|
# Required. The ID of the inventory source group to which the assignment will be
|
|
# assigned.
|
|
# @param [Google::Apis::DisplayvideoV1::AssignedInventorySource] assigned_inventory_source_object
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that owns the parent inventory source group. The
|
|
# parent partner will not have access to this assigned inventory source.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that owns the parent inventory source group. Only this
|
|
# partner will have write access to this assigned inventory source.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::AssignedInventorySource] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::AssignedInventorySource]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def create_inventory_source_group_assigned_inventory_source(inventory_source_group_id, assigned_inventory_source_object = nil, advertiser_id: nil, partner_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/inventorySourceGroups/{+inventorySourceGroupId}/assignedInventorySources', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::AssignedInventorySource::Representation
|
|
command.request_object = assigned_inventory_source_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::AssignedInventorySource::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::AssignedInventorySource
|
|
command.params['inventorySourceGroupId'] = inventory_source_group_id unless inventory_source_group_id.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Deletes the assignment between an inventory source and an inventory source
|
|
# group.
|
|
# @param [Fixnum] inventory_source_group_id
|
|
# Required. The ID of the inventory source group to which this assignment is
|
|
# assigned.
|
|
# @param [Fixnum] assigned_inventory_source_id
|
|
# Required. The ID of the assigned inventory source to delete.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that owns the parent inventory source group. The
|
|
# parent partner does not have access to this assigned inventory source.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that owns the parent inventory source group. Only this
|
|
# partner has write access to this assigned inventory source.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Empty] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Empty]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def delete_inventory_source_group_assigned_inventory_source(inventory_source_group_id, assigned_inventory_source_id, advertiser_id: nil, partner_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:delete, 'v1/inventorySourceGroups/{+inventorySourceGroupId}/assignedInventorySources/{+assignedInventorySourceId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Empty::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Empty
|
|
command.params['inventorySourceGroupId'] = inventory_source_group_id unless inventory_source_group_id.nil?
|
|
command.params['assignedInventorySourceId'] = assigned_inventory_source_id unless assigned_inventory_source_id.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists inventory sources assigned to an inventory source group.
|
|
# @param [Fixnum] inventory_source_group_id
|
|
# Required. The ID of the inventory source group to which these assignments are
|
|
# assigned.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that has access to the assignment. If the parent
|
|
# inventory source group is partner-owned, only advertisers to which the parent
|
|
# group is explicitly shared can access the assigned inventory source.
|
|
# @param [String] filter
|
|
# Allows filtering by assigned inventory source fields. Supported syntax: *
|
|
# Filter expressions are made up of one or more restrictions. * Restrictions can
|
|
# be combined by the logical operator `OR`. * A restriction has the form of ``
|
|
# field` `operator` `value``. * The operator must be `EQUALS (=)`. * Supported
|
|
# fields: - `assignedInventorySourceId` The length of this field should be no
|
|
# more than 500 characters.
|
|
# @param [String] order_by
|
|
# Field by which to sort the list. Acceptable values are: * `
|
|
# assignedInventorySourceId` (default) The default sorting order is ascending.
|
|
# To specify descending order for a field, a suffix " desc" should be added to
|
|
# the field name. Example: `assignedInventorySourceId desc`.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. Must be between `1` and `100`. If unspecified will
|
|
# default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is
|
|
# specified.
|
|
# @param [String] page_token
|
|
# A token identifying a page of results the server should return. Typically,
|
|
# this is the value of next_page_token returned from the previous call to `
|
|
# ListAssignedInventorySources` method. If not specified, the first page of
|
|
# results will be returned.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that has access to the assignment. If the parent
|
|
# inventory source group is advertiser-owned, the assignment cannot be accessed
|
|
# via a partner.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::ListAssignedInventorySourcesResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::ListAssignedInventorySourcesResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def list_inventory_source_group_assigned_inventory_sources(inventory_source_group_id, advertiser_id: nil, filter: nil, order_by: nil, page_size: nil, page_token: nil, partner_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/inventorySourceGroups/{+inventorySourceGroupId}/assignedInventorySources', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::ListAssignedInventorySourcesResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::ListAssignedInventorySourcesResponse
|
|
command.params['inventorySourceGroupId'] = inventory_source_group_id unless inventory_source_group_id.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['filter'] = filter unless filter.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets an inventory source.
|
|
# @param [Fixnum] inventory_source_id
|
|
# Required. The ID of the inventory source to fetch.
|
|
# @param [Fixnum] partner_id
|
|
# Required. The ID of the DV360 partner to which the fetched inventory source is
|
|
# permissioned.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::InventorySource] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::InventorySource]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def get_inventory_source(inventory_source_id, partner_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/inventorySources/{+inventorySourceId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::InventorySource::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::InventorySource
|
|
command.params['inventorySourceId'] = inventory_source_id unless inventory_source_id.nil?
|
|
command.query['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists inventory sources that are accessible to the current user. The order is
|
|
# defined by the order_by parameter. If a filter by entity_status is not
|
|
# specified, inventory sources with entity status `ENTITY_STATUS_ARCHIVED` will
|
|
# not be included in the results.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that has access to the inventory source.
|
|
# @param [String] filter
|
|
# Allows filtering by inventory source properties. Supported syntax: * Filter
|
|
# expressions are made up of one or more restrictions. * Restrictions can be
|
|
# combined by `AND` or `OR` logical operators. A sequence of restrictions
|
|
# implicitly uses `AND`. * A restriction has the form of ``field` `operator` `
|
|
# value``. * The operator must be `EQUALS (=)`. * Supported fields: - `status.
|
|
# entityStatus` - `commitment` - `deliveryMethod` - `rateDetails.rateType` - `
|
|
# exchange` Examples: * All active inventory sources: `status.entityStatus="
|
|
# ENTITY_STATUS_ACTIVE"` * Inventory sources belonging to Google Ad Manager or
|
|
# Rubicon exchanges: `exchange="EXCHANGE_GOOGLE_AD_MANAGER" OR exchange="
|
|
# EXCHANGE_RUBICON"` The length of this field should be no more than 500
|
|
# characters.
|
|
# @param [String] order_by
|
|
# Field by which to sort the list. Acceptable values are: * `displayName` (
|
|
# default) The default sorting order is ascending. To specify descending order
|
|
# for a field, a suffix "desc" should be added to the field name. For example, `
|
|
# displayName desc`.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. Must be between `1` and `100`. If unspecified will
|
|
# default to `100`.
|
|
# @param [String] page_token
|
|
# A token identifying a page of results the server should return. Typically,
|
|
# this is the value of next_page_token returned from the previous call to `
|
|
# ListInventorySources` method. If not specified, the first page of results will
|
|
# be returned.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that has access to the inventory source.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::ListInventorySourcesResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::ListInventorySourcesResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def list_inventory_sources(advertiser_id: nil, filter: nil, order_by: nil, page_size: nil, page_token: nil, partner_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/inventorySources', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::ListInventorySourcesResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::ListInventorySourcesResponse
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['filter'] = filter unless filter.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Downloads media. Download is supported on the URI `/download/`resource_name=**`
|
|
# ?alt=media.` **Note**: Download requests will not be successful without
|
|
# including `alt=media` query string.
|
|
# @param [String] resource_name
|
|
# Name of the media that is being downloaded. See ReadRequest.resource_name.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [IO, String] download_dest
|
|
# IO stream or filename to receive content download
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::GoogleBytestreamMedia] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::GoogleBytestreamMedia]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def download_medium(resource_name, fields: nil, quota_user: nil, download_dest: nil, options: nil, &block)
|
|
if download_dest.nil?
|
|
command = make_simple_command(:get, 'download/{+resourceName}', options)
|
|
else
|
|
command = make_download_command(:get, 'download/{+resourceName}', options)
|
|
command.download_dest = download_dest
|
|
end
|
|
command.response_representation = Google::Apis::DisplayvideoV1::GoogleBytestreamMedia::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::GoogleBytestreamMedia
|
|
command.params['resourceName'] = resource_name unless resource_name.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Bulk edits targeting options under a single partner. The operation will delete
|
|
# the assigned targeting options provided in
|
|
# BulkEditPartnerAssignedTargetingOptionsRequest.deleteRequests and then create
|
|
# the assigned targeting options provided in
|
|
# BulkEditPartnerAssignedTargetingOptionsRequest.createRequests .
|
|
# @param [Fixnum] partner_id
|
|
# Required. The ID of the partner.
|
|
# @param [Google::Apis::DisplayvideoV1::BulkEditPartnerAssignedTargetingOptionsRequest] bulk_edit_partner_assigned_targeting_options_request_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::BulkEditPartnerAssignedTargetingOptionsResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::BulkEditPartnerAssignedTargetingOptionsResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def bulk_edit_partner_assigned_targeting_options(partner_id, bulk_edit_partner_assigned_targeting_options_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/partners/{+partnerId}:bulkEditPartnerAssignedTargetingOptions', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::BulkEditPartnerAssignedTargetingOptionsRequest::Representation
|
|
command.request_object = bulk_edit_partner_assigned_targeting_options_request_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::BulkEditPartnerAssignedTargetingOptionsResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::BulkEditPartnerAssignedTargetingOptionsResponse
|
|
command.params['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets a partner.
|
|
# @param [Fixnum] partner_id
|
|
# Required. The ID of the partner to fetch.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Partner] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Partner]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def get_partner(partner_id, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/partners/{+partnerId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Partner::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Partner
|
|
command.params['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists partners that are accessible to the current user. The order is defined
|
|
# by the order_by parameter.
|
|
# @param [String] filter
|
|
# Allows filtering by partner properties. Supported syntax: * Filter expressions
|
|
# are made up of one or more restrictions. * Restrictions can be combined by `
|
|
# AND` or `OR` logical operators. A sequence of restrictions implicitly uses `
|
|
# AND`. * A restriction has the form of ``field` `operator` `value``. * The
|
|
# operator must be `EQUALS (=)`. * Supported fields: - `entityStatus` Examples: *
|
|
# All active partners: `entityStatus="ENTITY_STATUS_ACTIVE"` The length of this
|
|
# field should be no more than 500 characters.
|
|
# @param [String] order_by
|
|
# Field by which to sort the list. Acceptable values are: * `displayName` The
|
|
# default sorting order is ascending. To specify descending order for a field, a
|
|
# suffix "desc" should be added to the field name. For example, `displayName
|
|
# desc`.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. Must be between `1` and `100`. If unspecified will
|
|
# default to `100`.
|
|
# @param [String] page_token
|
|
# A token identifying a page of results the server should return. Typically,
|
|
# this is the value of next_page_token returned from the previous call to `
|
|
# ListPartners` method. If not specified, the first page of results will be
|
|
# returned.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::ListPartnersResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::ListPartnersResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def list_partners(filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/partners', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::ListPartnersResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::ListPartnersResponse
|
|
command.query['filter'] = filter unless filter.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Creates a new channel. Returns the newly created channel if successful.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that owns the created channel.
|
|
# @param [Google::Apis::DisplayvideoV1::Channel] channel_object
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that owns the created channel.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Channel] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Channel]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def create_partner_channel(partner_id, channel_object = nil, advertiser_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/partners/{+partnerId}/channels', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::Channel::Representation
|
|
command.request_object = channel_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Channel::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Channel
|
|
command.params['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets a channel for a partner or advertiser.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that owns the fetched channel.
|
|
# @param [Fixnum] channel_id
|
|
# Required. The ID of the channel to fetch.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that owns the fetched channel.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Channel] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Channel]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def get_partner_channel(partner_id, channel_id, advertiser_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/partners/{+partnerId}/channels/{+channelId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Channel::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Channel
|
|
command.params['partnerId'] = partner_id unless partner_id.nil?
|
|
command.params['channelId'] = channel_id unless channel_id.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists channels for a partner or advertiser.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that owns the channels.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that owns the channels.
|
|
# @param [String] filter
|
|
# Allows filtering by channel fields. Supported syntax: * Filter expressions for
|
|
# channel currently can only contain at most one * restriction. * A restriction
|
|
# has the form of ``field` `operator` `value``. * The operator must be `CONTAINS
|
|
# (:)`. * Supported fields: - `displayName` Examples: * All channels for which
|
|
# the display name contains "google": `displayName : "google"`. The length of
|
|
# this field should be no more than 500 characters.
|
|
# @param [String] order_by
|
|
# Field by which to sort the list. Acceptable values are: * `displayName` (
|
|
# default) * `channelId` The default sorting order is ascending. To specify
|
|
# descending order for a field, a suffix " desc" should be added to the field
|
|
# name. Example: `displayName desc`.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. Must be between `1` and `100`. If unspecified will
|
|
# default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is
|
|
# specified.
|
|
# @param [String] page_token
|
|
# A token identifying a page of results the server should return. Typically,
|
|
# this is the value of next_page_token returned from the previous call to `
|
|
# ListChannels` method. If not specified, the first page of results will be
|
|
# returned.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::ListChannelsResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::ListChannelsResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def list_partner_channels(partner_id, advertiser_id: nil, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/partners/{+partnerId}/channels', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::ListChannelsResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::ListChannelsResponse
|
|
command.params['partnerId'] = partner_id unless partner_id.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['filter'] = filter unless filter.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates a channel. Returns the updated channel if successful.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that owns the created channel.
|
|
# @param [Fixnum] channel_id
|
|
# Output only. The unique ID of the channel. Assigned by the system.
|
|
# @param [Google::Apis::DisplayvideoV1::Channel] channel_object
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that owns the created channel.
|
|
# @param [String] update_mask
|
|
# Required. The mask to control which fields to update.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Channel] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Channel]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def patch_partner_channel(partner_id, channel_id, channel_object = nil, advertiser_id: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'v1/partners/{+partnerId}/channels/{channelId}', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::Channel::Representation
|
|
command.request_object = channel_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Channel::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Channel
|
|
command.params['partnerId'] = partner_id unless partner_id.nil?
|
|
command.params['channelId'] = channel_id unless channel_id.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['updateMask'] = update_mask unless update_mask.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Bulk edits sites under a single channel. The operation will delete the sites
|
|
# provided in BulkEditSitesRequest.deleted_sites and then create the sites
|
|
# provided in BulkEditSitesRequest.created_sites.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that owns the parent channel.
|
|
# @param [Fixnum] channel_id
|
|
# Required. The ID of the parent channel to which the sites belong.
|
|
# @param [Google::Apis::DisplayvideoV1::BulkEditSitesRequest] bulk_edit_sites_request_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::BulkEditSitesResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::BulkEditSitesResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def bulk_partner_channel_site_edit(partner_id, channel_id, bulk_edit_sites_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/partners/{partnerId}/channels/{+channelId}/sites:bulkEdit', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::BulkEditSitesRequest::Representation
|
|
command.request_object = bulk_edit_sites_request_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::BulkEditSitesResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::BulkEditSitesResponse
|
|
command.params['partnerId'] = partner_id unless partner_id.nil?
|
|
command.params['channelId'] = channel_id unless channel_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Creates a site in a channel.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that owns the parent channel.
|
|
# @param [Fixnum] channel_id
|
|
# Required. The ID of the parent channel in which the site will be created.
|
|
# @param [Google::Apis::DisplayvideoV1::Site] site_object
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that owns the parent channel.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Site] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Site]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def create_partner_channel_site(partner_id, channel_id, site_object = nil, advertiser_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/partners/{partnerId}/channels/{+channelId}/sites', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::Site::Representation
|
|
command.request_object = site_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Site::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Site
|
|
command.params['partnerId'] = partner_id unless partner_id.nil?
|
|
command.params['channelId'] = channel_id unless channel_id.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Deletes a site from a channel.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that owns the parent channel.
|
|
# @param [Fixnum] channel_id
|
|
# Required. The ID of the parent channel to which the site belongs.
|
|
# @param [String] url_or_app_id
|
|
# Required. The URL or app ID of the site to delete.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that owns the parent channel.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Empty] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Empty]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def delete_partner_channel_site(partner_id, channel_id, url_or_app_id, advertiser_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:delete, 'v1/partners/{partnerId}/channels/{+channelId}/sites/{+urlOrAppId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Empty::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Empty
|
|
command.params['partnerId'] = partner_id unless partner_id.nil?
|
|
command.params['channelId'] = channel_id unless channel_id.nil?
|
|
command.params['urlOrAppId'] = url_or_app_id unless url_or_app_id.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists sites in a channel.
|
|
# @param [Fixnum] partner_id
|
|
# The ID of the partner that owns the parent channel.
|
|
# @param [Fixnum] channel_id
|
|
# Required. The ID of the parent channel to which the requested sites belong.
|
|
# @param [Fixnum] advertiser_id
|
|
# The ID of the advertiser that owns the parent channel.
|
|
# @param [String] filter
|
|
# Allows filtering by site fields. Supported syntax: * Filter expressions for
|
|
# site currently can only contain at most one * restriction. * A restriction has
|
|
# the form of ``field` `operator` `value``. * The operator must be `CONTAINS (:)`
|
|
# . * Supported fields: - `urlOrAppId` Examples: * All sites for which the URL
|
|
# or app ID contains "google": `urlOrAppId : "google"`
|
|
# @param [String] order_by
|
|
# Field by which to sort the list. Acceptable values are: * `urlOrAppId` (
|
|
# default) The default sorting order is ascending. To specify descending order
|
|
# for a field, a suffix " desc" should be added to the field name. Example: `
|
|
# urlOrAppId desc`.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. Must be between `1` and `100`. If unspecified will
|
|
# default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is
|
|
# specified.
|
|
# @param [String] page_token
|
|
# A token identifying a page of results the server should return. Typically,
|
|
# this is the value of next_page_token returned from the previous call to `
|
|
# ListSites` method. If not specified, the first page of results will be
|
|
# returned.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::ListSitesResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::ListSitesResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def list_partner_channel_sites(partner_id, channel_id, advertiser_id: nil, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/partners/{+partnerId}/channels/{+channelId}/sites', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::ListSitesResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::ListSitesResponse
|
|
command.params['partnerId'] = partner_id unless partner_id.nil?
|
|
command.params['channelId'] = channel_id unless channel_id.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['filter'] = filter unless filter.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Assigns a targeting option to a partner. Returns the assigned targeting option
|
|
# if successful.
|
|
# @param [Fixnum] partner_id
|
|
# Required. The ID of the partner.
|
|
# @param [String] targeting_type
|
|
# Required. Identifies the type of this assigned targeting option. Supported
|
|
# targeting types: * `TARGETING_TYPE_CHANNEL`
|
|
# @param [Google::Apis::DisplayvideoV1::AssignedTargetingOption] assigned_targeting_option_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::AssignedTargetingOption] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::AssignedTargetingOption]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def create_partner_targeting_type_assigned_targeting_option(partner_id, targeting_type, assigned_targeting_option_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/partners/{+partnerId}/targetingTypes/{+targetingType}/assignedTargetingOptions', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::AssignedTargetingOption::Representation
|
|
command.request_object = assigned_targeting_option_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::AssignedTargetingOption::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::AssignedTargetingOption
|
|
command.params['partnerId'] = partner_id unless partner_id.nil?
|
|
command.params['targetingType'] = targeting_type unless targeting_type.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Deletes an assigned targeting option from a partner.
|
|
# @param [Fixnum] partner_id
|
|
# Required. The ID of the partner.
|
|
# @param [String] targeting_type
|
|
# Required. Identifies the type of this assigned targeting option. Supported
|
|
# targeting types: * `TARGETING_TYPE_CHANNEL`
|
|
# @param [String] assigned_targeting_option_id
|
|
# Required. The ID of the assigned targeting option to delete.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Empty] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Empty]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def delete_partner_targeting_type_assigned_targeting_option(partner_id, targeting_type, assigned_targeting_option_id, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:delete, 'v1/partners/{+partnerId}/targetingTypes/{+targetingType}/assignedTargetingOptions/{+assignedTargetingOptionId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Empty::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Empty
|
|
command.params['partnerId'] = partner_id unless partner_id.nil?
|
|
command.params['targetingType'] = targeting_type unless targeting_type.nil?
|
|
command.params['assignedTargetingOptionId'] = assigned_targeting_option_id unless assigned_targeting_option_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets a single targeting option assigned to a partner.
|
|
# @param [Fixnum] partner_id
|
|
# Required. The ID of the partner.
|
|
# @param [String] targeting_type
|
|
# Required. Identifies the type of this assigned targeting option. Supported
|
|
# targeting types: * `TARGETING_TYPE_CHANNEL`
|
|
# @param [String] assigned_targeting_option_id
|
|
# Required. An identifier unique to the targeting type in this partner that
|
|
# identifies the assigned targeting option being requested.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::AssignedTargetingOption] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::AssignedTargetingOption]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def get_partner_targeting_type_assigned_targeting_option(partner_id, targeting_type, assigned_targeting_option_id, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/partners/{+partnerId}/targetingTypes/{+targetingType}/assignedTargetingOptions/{+assignedTargetingOptionId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::AssignedTargetingOption::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::AssignedTargetingOption
|
|
command.params['partnerId'] = partner_id unless partner_id.nil?
|
|
command.params['targetingType'] = targeting_type unless targeting_type.nil?
|
|
command.params['assignedTargetingOptionId'] = assigned_targeting_option_id unless assigned_targeting_option_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists the targeting options assigned to a partner.
|
|
# @param [Fixnum] partner_id
|
|
# Required. The ID of the partner.
|
|
# @param [String] targeting_type
|
|
# Required. Identifies the type of assigned targeting options to list. Supported
|
|
# targeting types: * `TARGETING_TYPE_CHANNEL`
|
|
# @param [String] filter
|
|
# Allows filtering by assigned targeting option properties. Supported syntax: *
|
|
# Filter expressions are made up of one or more restrictions. * Restrictions can
|
|
# be combined by the logical operator `OR`. * A restriction has the form of ``
|
|
# field` `operator` `value``. * The operator must be `EQUALS (=)`. * Supported
|
|
# fields: - `assignedTargetingOptionId` Examples: * AssignedTargetingOption with
|
|
# ID 123456 `assignedTargetingOptionId="123456"` The length of this field should
|
|
# be no more than 500 characters.
|
|
# @param [String] order_by
|
|
# Field by which to sort the list. Acceptable values are: * `
|
|
# assignedTargetingOptionId` (default) The default sorting order is ascending.
|
|
# To specify descending order for a field, a suffix "desc" should be added to
|
|
# the field name. Example: `assignedTargetingOptionId desc`.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. Must be between `1` and `100`. If unspecified will
|
|
# default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is
|
|
# specified.
|
|
# @param [String] page_token
|
|
# A token identifying a page of results the server should return. Typically,
|
|
# this is the value of next_page_token returned from the previous call to `
|
|
# ListPartnerAssignedTargetingOptions` method. If not specified, the first page
|
|
# of results will be returned.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::ListPartnerAssignedTargetingOptionsResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::ListPartnerAssignedTargetingOptionsResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def list_partner_targeting_type_assigned_targeting_options(partner_id, targeting_type, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/partners/{+partnerId}/targetingTypes/{+targetingType}/assignedTargetingOptions', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::ListPartnerAssignedTargetingOptionsResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::ListPartnerAssignedTargetingOptionsResponse
|
|
command.params['partnerId'] = partner_id unless partner_id.nil?
|
|
command.params['targetingType'] = targeting_type unless targeting_type.nil?
|
|
command.query['filter'] = filter unless filter.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Creates an SDF Download Task. Returns an Operation. An SDF Download Task is a
|
|
# long-running, asynchronous operation. The metadata type of this operation is
|
|
# SdfDownloadTaskMetadata. If the request is successful, the response type of
|
|
# the operation is SdfDownloadTask. The response will not include the download
|
|
# files, which must be retrieved with media.download. The state of operation can
|
|
# be retrieved with sdfdownloadtask.operations.get. Any errors can be found in
|
|
# the error.message. Note that error.details is expected to be empty.
|
|
# @param [Google::Apis::DisplayvideoV1::CreateSdfDownloadTaskRequest] create_sdf_download_task_request_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Operation] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Operation]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def create_sdfdownloadtask_sdf_download_task(create_sdf_download_task_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/sdfdownloadtasks', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::CreateSdfDownloadTaskRequest::Representation
|
|
command.request_object = create_sdf_download_task_request_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Operation::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Operation
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets the latest state of an asynchronous SDF download task operation. Clients
|
|
# should poll this method at intervals of 30 seconds.
|
|
# @param [String] name
|
|
# The name of the operation resource.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Operation] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Operation]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def get_sdfdownloadtask_operation(name, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/{+name}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Operation::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Operation
|
|
command.params['name'] = name unless name.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets a single targeting option.
|
|
# @param [String] targeting_type
|
|
# Required. The type of targeting option to retrieve.
|
|
# @param [String] targeting_option_id
|
|
# Required. The ID of the of targeting option to retrieve.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The Advertiser this request is being made in the context of.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::TargetingOption] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::TargetingOption]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def get_targeting_type_targeting_option(targeting_type, targeting_option_id, advertiser_id: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/targetingTypes/{+targetingType}/targetingOptions/{+targetingOptionId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::TargetingOption::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::TargetingOption
|
|
command.params['targetingType'] = targeting_type unless targeting_type.nil?
|
|
command.params['targetingOptionId'] = targeting_option_id unless targeting_option_id.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists targeting options of a given type.
|
|
# @param [String] targeting_type
|
|
# Required. The type of targeting option to be listed.
|
|
# @param [Fixnum] advertiser_id
|
|
# Required. The Advertiser this request is being made in the context of.
|
|
# @param [String] filter
|
|
# Allows filtering by targeting option properties. Supported syntax: * Filter
|
|
# expressions are made up of one or more restrictions. * Restrictions can be
|
|
# combined by `OR` logical operators. * A restriction has the form of ``field` `
|
|
# operator` `value``. * The operator must be "=" (equal sign). * Supported
|
|
# fields: - `carrierAndIspDetails.type` - `geoRegionDetails.geoRegionType` - `
|
|
# targetingOptionId` Examples: * All `GEO REGION` targeting options that belong
|
|
# to sub type `GEO_REGION_TYPE_COUNTRY` or `GEO_REGION_TYPE_STATE`: `
|
|
# geoRegionDetails.geoRegionType="GEO_REGION_TYPE_COUNTRY" OR geoRegionDetails.
|
|
# geoRegionType="GEO_REGION_TYPE_STATE"` * All `CARRIER AND ISP` targeting
|
|
# options that belong to sub type `CARRIER_AND_ISP_TYPE_CARRIER`: `
|
|
# carrierAndIspDetails.type="CARRIER_AND_ISP_TYPE_CARRIER"`. The length of this
|
|
# field should be no more than 500 characters.
|
|
# @param [String] order_by
|
|
# Field by which to sort the list. Acceptable values are: * `targetingOptionId` (
|
|
# default) The default sorting order is ascending. To specify descending order
|
|
# for a field, a suffix "desc" should be added to the field name. Example: `
|
|
# targetingOptionId desc`.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. Must be between `1` and `100`. If unspecified will
|
|
# default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is
|
|
# specified.
|
|
# @param [String] page_token
|
|
# A token identifying a page of results the server should return. Typically,
|
|
# this is the value of next_page_token returned from the previous call to `
|
|
# ListTargetingOptions` method. If not specified, the first page of results will
|
|
# be returned.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::ListTargetingOptionsResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::ListTargetingOptionsResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def list_targeting_type_targeting_options(targeting_type, advertiser_id: nil, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/targetingTypes/{+targetingType}/targetingOptions', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::ListTargetingOptionsResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::ListTargetingOptionsResponse
|
|
command.params['targetingType'] = targeting_type unless targeting_type.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['filter'] = filter unless filter.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Bulk edits user roles for a user. The operation will delete the assigned user
|
|
# roles provided in BulkEditAssignedUserRolesRequest.deletedAssignedUserRoles
|
|
# and then assign the user roles provided in BulkEditAssignedUserRolesRequest.
|
|
# createdAssignedUserRoles.
|
|
# @param [Fixnum] user_id
|
|
# Required. The ID of the user to which the assigned user roles belong.
|
|
# @param [Google::Apis::DisplayvideoV1::BulkEditAssignedUserRolesRequest] bulk_edit_assigned_user_roles_request_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::BulkEditAssignedUserRolesResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::BulkEditAssignedUserRolesResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def bulk_edit_assigned_user_roles(user_id, bulk_edit_assigned_user_roles_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/users/{+userId}:bulkEditAssignedUserRoles', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::BulkEditAssignedUserRolesRequest::Representation
|
|
command.request_object = bulk_edit_assigned_user_roles_request_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::BulkEditAssignedUserRolesResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::BulkEditAssignedUserRolesResponse
|
|
command.params['userId'] = user_id unless user_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Creates a new user. Returns the newly created user if successful.
|
|
# @param [Google::Apis::DisplayvideoV1::User] user_object
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::User] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::User]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def create_user(user_object = nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'v1/users', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::User::Representation
|
|
command.request_object = user_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::User::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::User
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Deletes a user.
|
|
# @param [Fixnum] user_id
|
|
# Required. The ID of the user to delete.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::Empty] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::Empty]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def delete_user(user_id, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:delete, 'v1/users/{+userId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::Empty::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::Empty
|
|
command.params['userId'] = user_id unless user_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets a user.
|
|
# @param [Fixnum] user_id
|
|
# Required. The ID of the user to fetch.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::User] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::User]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def get_user(user_id, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/users/{+userId}', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::User::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::User
|
|
command.params['userId'] = user_id unless user_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists users that are accessible to the current user. If two users have user
|
|
# roles on the same partner or advertiser, they can access each other.
|
|
# @param [String] filter
|
|
# Allows filtering by user properties. Supported syntax: * Filter expressions
|
|
# are made up of one or more restrictions. * Restrictions can be combined by the
|
|
# logical operator `AND`. * A restriction has the form of ``field` `operator` `
|
|
# value``. * The operator must be `CONTAINS (:)` or `EQUALS (=)`. * The operator
|
|
# must be `CONTAINS (:)` for the following fields: - `displayName` - `email` *
|
|
# The operator must be `EQUALS (=)` for the following fields: - `
|
|
# assignedUserRole.userRole` - `assignedUserRole.partnerId` - `assignedUserRole.
|
|
# advertiserId` - `assignedUserRole.entityType`: A synthetic field of
|
|
# AssignedUserRole used for filtering. Identifies the type of entity to which
|
|
# the user role is assigned. Valid values are `Partner` and `Advertiser`. - `
|
|
# assignedUserRole.parentPartnerId`: A synthetic field of AssignedUserRole used
|
|
# for filtering. Identifies the parent partner of the entity to which the user
|
|
# role is assigned." Examples: * The user with displayName containing `foo`: `
|
|
# displayName:"foo"` * The user with email containing `bar`: `email:"bar"` * All
|
|
# users with standard user roles: `assignedUserRole.userRole="STANDARD"` * All
|
|
# users with user roles for partner 123: `assignedUserRole.partnerId="123"` *
|
|
# All users with user roles for advertiser 123: `assignedUserRole.advertiserId="
|
|
# 123"` * All users with partner level user roles: `entityType="PARTNER"` * All
|
|
# users with user roles for partner 123 and advertisers under partner 123: `
|
|
# parentPartnerId="123"` The length of this field should be no more than 500
|
|
# characters.
|
|
# @param [String] order_by
|
|
# Field by which to sort the list. Acceptable values are: * `displayName` (
|
|
# default) The default sorting order is ascending. To specify descending order
|
|
# for a field, a suffix "desc" should be added to the field name. For example, `
|
|
# displayName desc`.
|
|
# @param [Fixnum] page_size
|
|
# Requested page size. Must be between `1` and `100`. If unspecified will
|
|
# default to `100`.
|
|
# @param [String] page_token
|
|
# A token identifying a page of results the server should return. Typically,
|
|
# this is the value of next_page_token returned from the previous call to `
|
|
# ListUsers` method. If not specified, the first page of results will be
|
|
# returned.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::ListUsersResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::ListUsersResponse]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def list_users(filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'v1/users', options)
|
|
command.response_representation = Google::Apis::DisplayvideoV1::ListUsersResponse::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::ListUsersResponse
|
|
command.query['filter'] = filter unless filter.nil?
|
|
command.query['orderBy'] = order_by unless order_by.nil?
|
|
command.query['pageSize'] = page_size unless page_size.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing user. Returns the updated user if successful.
|
|
# @param [Fixnum] user_id
|
|
# Output only. The unique ID of the user. Assigned by the system.
|
|
# @param [Google::Apis::DisplayvideoV1::User] user_object
|
|
# @param [String] update_mask
|
|
# Required. The mask to control which fields to update.
|
|
# @param [String] fields
|
|
# Selector specifying which fields to include in a partial response.
|
|
# @param [String] quota_user
|
|
# Available to use for quota purposes for server-side applications. Can be any
|
|
# arbitrary string assigned to a user, but should not exceed 40 characters.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DisplayvideoV1::User] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DisplayvideoV1::User]
|
|
#
|
|
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
|
|
# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
|
|
# @raise [Google::Apis::AuthorizationError] Authorization is required
|
|
def patch_user(user_id, user_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'v1/users/{+userId}', options)
|
|
command.request_representation = Google::Apis::DisplayvideoV1::User::Representation
|
|
command.request_object = user_object
|
|
command.response_representation = Google::Apis::DisplayvideoV1::User::Representation
|
|
command.response_class = Google::Apis::DisplayvideoV1::User
|
|
command.params['userId'] = user_id unless user_id.nil?
|
|
command.query['updateMask'] = update_mask unless update_mask.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
protected
|
|
|
|
def apply_command_defaults(command)
|
|
command.query['key'] = key unless key.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
end
|
|
end
|
|
end
|
|
end
|
|
end
|