9137 lines
560 KiB
Ruby
9137 lines
560 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 DfareportingV2_8
|
|
# DCM/DFA Reporting And Trafficking API
|
|
#
|
|
# Manages your DoubleClick Campaign Manager ad campaigns and reports.
|
|
#
|
|
# @example
|
|
# require 'google/apis/dfareporting_v2_8'
|
|
#
|
|
# Dfareporting = Google::Apis::DfareportingV2_8 # Alias the module
|
|
# service = Dfareporting::DfareportingService.new
|
|
#
|
|
# @see https://developers.google.com/doubleclick-advertisers/
|
|
class DfareportingService < 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.
|
|
# Overrides userIp if both are provided.
|
|
attr_accessor :quota_user
|
|
|
|
# @return [String]
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
attr_accessor :user_ip
|
|
|
|
def initialize
|
|
super('https://www.googleapis.com/', 'dfareporting/v2.8/')
|
|
@batch_path = 'batch'
|
|
end
|
|
|
|
# Gets the account's active ad summary by account ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] summary_account_id
|
|
# Account ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::AccountActiveAdSummary] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::AccountActiveAdSummary]
|
|
#
|
|
# @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_account_active_ad_summary(profile_id, summary_account_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/accountActiveAdSummaries/{summaryAccountId}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::AccountActiveAdSummary::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::AccountActiveAdSummary
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['summaryAccountId'] = summary_account_id unless summary_account_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one account permission group by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Account permission group ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::AccountPermissionGroup] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::AccountPermissionGroup]
|
|
#
|
|
# @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_account_permission_group(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/accountPermissionGroups/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::AccountPermissionGroup::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::AccountPermissionGroup
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves the list of account permission groups.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::AccountPermissionGroupsListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::AccountPermissionGroupsListResponse]
|
|
#
|
|
# @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_account_permission_groups(profile_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/accountPermissionGroups', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::AccountPermissionGroupsListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::AccountPermissionGroupsListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one account permission by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Account permission ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::AccountPermission] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::AccountPermission]
|
|
#
|
|
# @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_account_permission(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/accountPermissions/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::AccountPermission::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::AccountPermission
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves the list of account permissions.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::AccountPermissionsListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::AccountPermissionsListResponse]
|
|
#
|
|
# @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_account_permissions(profile_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/accountPermissions', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::AccountPermissionsListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::AccountPermissionsListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one account user profile by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# User profile ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::AccountUserProfile] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::AccountUserProfile]
|
|
#
|
|
# @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_account_user_profile(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/accountUserProfiles/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::AccountUserProfile::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::AccountUserProfile
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Inserts a new account user profile.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::AccountUserProfile] account_user_profile_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::AccountUserProfile] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::AccountUserProfile]
|
|
#
|
|
# @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 insert_account_user_profile(profile_id, account_user_profile_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/accountUserProfiles', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::AccountUserProfile::Representation
|
|
command.request_object = account_user_profile_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::AccountUserProfile::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::AccountUserProfile
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of account user profiles, possibly filtered. This method
|
|
# supports paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Boolean] active
|
|
# Select only active user profiles.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only user profiles with these IDs.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [String] search_string
|
|
# Allows searching for objects by name, ID or email. Wildcards (*) are allowed.
|
|
# For example, "user profile*2015" will return objects with names like "user
|
|
# profile June 2015", "user profile April 2015", or simply "user profile 2015".
|
|
# Most of the searches also add wildcards implicitly at the start and the end of
|
|
# the search string. For example, a search string of "user profile" will match
|
|
# objects with name "my user profile", "user profile 2015", or simply "user
|
|
# profile".
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @param [Fixnum] subaccount_id
|
|
# Select only user profiles with the specified subaccount ID.
|
|
# @param [Fixnum] user_role_id
|
|
# Select only user profiles with the specified user role ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::AccountUserProfilesListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::AccountUserProfilesListResponse]
|
|
#
|
|
# @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_account_user_profiles(profile_id, active: nil, ids: nil, max_results: nil, page_token: nil, search_string: nil, sort_field: nil, sort_order: nil, subaccount_id: nil, user_role_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/accountUserProfiles', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::AccountUserProfilesListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::AccountUserProfilesListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['active'] = active unless active.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['searchString'] = search_string unless search_string.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['subaccountId'] = subaccount_id unless subaccount_id.nil?
|
|
command.query['userRoleId'] = user_role_id unless user_role_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing account user profile. This method supports patch semantics.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# User profile ID.
|
|
# @param [Google::Apis::DfareportingV2_8::AccountUserProfile] account_user_profile_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::AccountUserProfile] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::AccountUserProfile]
|
|
#
|
|
# @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_account_user_profile(profile_id, id, account_user_profile_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'userprofiles/{profileId}/accountUserProfiles', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::AccountUserProfile::Representation
|
|
command.request_object = account_user_profile_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::AccountUserProfile::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::AccountUserProfile
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing account user profile.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::AccountUserProfile] account_user_profile_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::AccountUserProfile] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::AccountUserProfile]
|
|
#
|
|
# @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 update_account_user_profile(profile_id, account_user_profile_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:put, 'userprofiles/{profileId}/accountUserProfiles', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::AccountUserProfile::Representation
|
|
command.request_object = account_user_profile_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::AccountUserProfile::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::AccountUserProfile
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one account by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Account ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Account] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::Account]
|
|
#
|
|
# @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_account(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/accounts/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Account::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Account
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves the list of accounts, possibly filtered. This method supports paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Boolean] active
|
|
# Select only active accounts. Don't set this field to select both active and
|
|
# non-active accounts.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only accounts with these IDs.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [String] search_string
|
|
# Allows searching for objects by name or ID. Wildcards (*) are allowed. For
|
|
# example, "account*2015" will return objects with names like "account June 2015"
|
|
# , "account April 2015", or simply "account 2015". Most of the searches also
|
|
# add wildcards implicitly at the start and the end of the search string. For
|
|
# example, a search string of "account" will match objects with name "my account"
|
|
# , "account 2015", or simply "account".
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::AccountsListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::AccountsListResponse]
|
|
#
|
|
# @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_accounts(profile_id, active: nil, ids: nil, max_results: nil, page_token: nil, search_string: nil, sort_field: nil, sort_order: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/accounts', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::AccountsListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::AccountsListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['active'] = active unless active.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['searchString'] = search_string unless search_string.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing account. This method supports patch semantics.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Account ID.
|
|
# @param [Google::Apis::DfareportingV2_8::Account] account_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Account] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::Account]
|
|
#
|
|
# @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_account(profile_id, id, account_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'userprofiles/{profileId}/accounts', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::Account::Representation
|
|
command.request_object = account_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Account::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Account
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing account.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::Account] account_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Account] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::Account]
|
|
#
|
|
# @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 update_account(profile_id, account_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:put, 'userprofiles/{profileId}/accounts', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::Account::Representation
|
|
command.request_object = account_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Account::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Account
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one ad by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Ad ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Ad] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::Ad]
|
|
#
|
|
# @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_ad(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/ads/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Ad::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Ad
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Inserts a new ad.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::Ad] ad_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Ad] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::Ad]
|
|
#
|
|
# @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 insert_ad(profile_id, ad_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/ads', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::Ad::Representation
|
|
command.request_object = ad_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Ad::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Ad
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of ads, possibly filtered. This method supports paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Boolean] active
|
|
# Select only active ads.
|
|
# @param [Fixnum] advertiser_id
|
|
# Select only ads with this advertiser ID.
|
|
# @param [Boolean] archived
|
|
# Select only archived ads.
|
|
# @param [Array<Fixnum>, Fixnum] audience_segment_ids
|
|
# Select only ads with these audience segment IDs.
|
|
# @param [Array<Fixnum>, Fixnum] campaign_ids
|
|
# Select only ads with these campaign IDs.
|
|
# @param [String] compatibility
|
|
# Select default ads with the specified compatibility. Applicable when type is
|
|
# AD_SERVING_DEFAULT_AD. DISPLAY and DISPLAY_INTERSTITIAL refer to rendering
|
|
# either on desktop or on mobile devices for regular or interstitial ads,
|
|
# respectively. APP and APP_INTERSTITIAL are for rendering in mobile apps.
|
|
# IN_STREAM_VIDEO refers to rendering an in-stream video ads developed with the
|
|
# VAST standard.
|
|
# @param [Array<Fixnum>, Fixnum] creative_ids
|
|
# Select only ads with these creative IDs assigned.
|
|
# @param [Array<Fixnum>, Fixnum] creative_optimization_configuration_ids
|
|
# Select only ads with these creative optimization configuration IDs.
|
|
# @param [Boolean] dynamic_click_tracker
|
|
# Select only dynamic click trackers. Applicable when type is
|
|
# AD_SERVING_CLICK_TRACKER. If true, select dynamic click trackers. If false,
|
|
# select static click trackers. Leave unset to select both.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only ads with these IDs.
|
|
# @param [Array<Fixnum>, Fixnum] landing_page_ids
|
|
# Select only ads with these landing page IDs.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [Fixnum] overridden_event_tag_id
|
|
# Select only ads with this event tag override ID.
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [Array<Fixnum>, Fixnum] placement_ids
|
|
# Select only ads with these placement IDs assigned.
|
|
# @param [Array<Fixnum>, Fixnum] remarketing_list_ids
|
|
# Select only ads whose list targeting expression use these remarketing list IDs.
|
|
# @param [String] search_string
|
|
# Allows searching for objects by name or ID. Wildcards (*) are allowed. For
|
|
# example, "ad*2015" will return objects with names like "ad June 2015", "ad
|
|
# April 2015", or simply "ad 2015". Most of the searches also add wildcards
|
|
# implicitly at the start and the end of the search string. For example, a
|
|
# search string of "ad" will match objects with name "my ad", "ad 2015", or
|
|
# simply "ad".
|
|
# @param [Array<Fixnum>, Fixnum] size_ids
|
|
# Select only ads with these size IDs.
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @param [Boolean] ssl_compliant
|
|
# Select only ads that are SSL-compliant.
|
|
# @param [Boolean] ssl_required
|
|
# Select only ads that require SSL.
|
|
# @param [Array<String>, String] type
|
|
# Select only ads with these types.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::AdsListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::AdsListResponse]
|
|
#
|
|
# @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_ads(profile_id, active: nil, advertiser_id: nil, archived: nil, audience_segment_ids: nil, campaign_ids: nil, compatibility: nil, creative_ids: nil, creative_optimization_configuration_ids: nil, dynamic_click_tracker: nil, ids: nil, landing_page_ids: nil, max_results: nil, overridden_event_tag_id: nil, page_token: nil, placement_ids: nil, remarketing_list_ids: nil, search_string: nil, size_ids: nil, sort_field: nil, sort_order: nil, ssl_compliant: nil, ssl_required: nil, type: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/ads', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::AdsListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::AdsListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['active'] = active unless active.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['archived'] = archived unless archived.nil?
|
|
command.query['audienceSegmentIds'] = audience_segment_ids unless audience_segment_ids.nil?
|
|
command.query['campaignIds'] = campaign_ids unless campaign_ids.nil?
|
|
command.query['compatibility'] = compatibility unless compatibility.nil?
|
|
command.query['creativeIds'] = creative_ids unless creative_ids.nil?
|
|
command.query['creativeOptimizationConfigurationIds'] = creative_optimization_configuration_ids unless creative_optimization_configuration_ids.nil?
|
|
command.query['dynamicClickTracker'] = dynamic_click_tracker unless dynamic_click_tracker.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['landingPageIds'] = landing_page_ids unless landing_page_ids.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['overriddenEventTagId'] = overridden_event_tag_id unless overridden_event_tag_id.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['placementIds'] = placement_ids unless placement_ids.nil?
|
|
command.query['remarketingListIds'] = remarketing_list_ids unless remarketing_list_ids.nil?
|
|
command.query['searchString'] = search_string unless search_string.nil?
|
|
command.query['sizeIds'] = size_ids unless size_ids.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['sslCompliant'] = ssl_compliant unless ssl_compliant.nil?
|
|
command.query['sslRequired'] = ssl_required unless ssl_required.nil?
|
|
command.query['type'] = type unless type.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing ad. This method supports patch semantics.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Ad ID.
|
|
# @param [Google::Apis::DfareportingV2_8::Ad] ad_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Ad] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::Ad]
|
|
#
|
|
# @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_ad(profile_id, id, ad_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'userprofiles/{profileId}/ads', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::Ad::Representation
|
|
command.request_object = ad_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Ad::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Ad
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing ad.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::Ad] ad_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Ad] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::Ad]
|
|
#
|
|
# @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 update_ad(profile_id, ad_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:put, 'userprofiles/{profileId}/ads', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::Ad::Representation
|
|
command.request_object = ad_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Ad::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Ad
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Deletes an existing advertiser group.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Advertiser group ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [NilClass] No result returned for this method
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [void]
|
|
#
|
|
# @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_group(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:delete, 'userprofiles/{profileId}/advertiserGroups/{id}', options)
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one advertiser group by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Advertiser group ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::AdvertiserGroup] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::AdvertiserGroup]
|
|
#
|
|
# @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_group(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/advertiserGroups/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::AdvertiserGroup::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::AdvertiserGroup
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Inserts a new advertiser group.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::AdvertiserGroup] advertiser_group_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::AdvertiserGroup] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::AdvertiserGroup]
|
|
#
|
|
# @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 insert_advertiser_group(profile_id, advertiser_group_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/advertiserGroups', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::AdvertiserGroup::Representation
|
|
command.request_object = advertiser_group_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::AdvertiserGroup::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::AdvertiserGroup
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of advertiser groups, possibly filtered. This method supports
|
|
# paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only advertiser groups with these IDs.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [String] search_string
|
|
# Allows searching for objects by name or ID. Wildcards (*) are allowed. For
|
|
# example, "advertiser*2015" will return objects with names like "advertiser
|
|
# group June 2015", "advertiser group April 2015", or simply "advertiser group
|
|
# 2015". Most of the searches also add wildcards implicitly at the start and the
|
|
# end of the search string. For example, a search string of "advertisergroup"
|
|
# will match objects with name "my advertisergroup", "advertisergroup 2015", or
|
|
# simply "advertisergroup".
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::AdvertiserGroupsListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::AdvertiserGroupsListResponse]
|
|
#
|
|
# @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_groups(profile_id, ids: nil, max_results: nil, page_token: nil, search_string: nil, sort_field: nil, sort_order: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/advertiserGroups', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::AdvertiserGroupsListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::AdvertiserGroupsListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['searchString'] = search_string unless search_string.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing advertiser group. This method supports patch semantics.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Advertiser group ID.
|
|
# @param [Google::Apis::DfareportingV2_8::AdvertiserGroup] advertiser_group_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::AdvertiserGroup] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::AdvertiserGroup]
|
|
#
|
|
# @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_group(profile_id, id, advertiser_group_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'userprofiles/{profileId}/advertiserGroups', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::AdvertiserGroup::Representation
|
|
command.request_object = advertiser_group_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::AdvertiserGroup::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::AdvertiserGroup
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing advertiser group.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::AdvertiserGroup] advertiser_group_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::AdvertiserGroup] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::AdvertiserGroup]
|
|
#
|
|
# @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 update_advertiser_group(profile_id, advertiser_group_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:put, 'userprofiles/{profileId}/advertiserGroups', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::AdvertiserGroup::Representation
|
|
command.request_object = advertiser_group_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::AdvertiserGroup::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::AdvertiserGroup
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one advertiser by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Advertiser ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Advertiser] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::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(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/advertisers/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Advertiser::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Advertiser
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Inserts a new advertiser.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Advertiser] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::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 insert_advertiser(profile_id, advertiser_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/advertisers', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::Advertiser::Representation
|
|
command.request_object = advertiser_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Advertiser::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Advertiser
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of advertisers, possibly filtered. This method supports
|
|
# paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Array<Fixnum>, Fixnum] advertiser_group_ids
|
|
# Select only advertisers with these advertiser group IDs.
|
|
# @param [Array<Fixnum>, Fixnum] floodlight_configuration_ids
|
|
# Select only advertisers with these floodlight configuration IDs.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only advertisers with these IDs.
|
|
# @param [Boolean] include_advertisers_without_groups_only
|
|
# Select only advertisers which do not belong to any advertiser group.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [Boolean] only_parent
|
|
# Select only advertisers which use another advertiser's floodlight
|
|
# configuration.
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [String] search_string
|
|
# Allows searching for objects by name or ID. Wildcards (*) are allowed. For
|
|
# example, "advertiser*2015" will return objects with names like "advertiser
|
|
# June 2015", "advertiser April 2015", or simply "advertiser 2015". Most of the
|
|
# searches also add wildcards implicitly at the start and the end of the search
|
|
# string. For example, a search string of "advertiser" will match objects with
|
|
# name "my advertiser", "advertiser 2015", or simply "advertiser".
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @param [String] status
|
|
# Select only advertisers with the specified status.
|
|
# @param [Fixnum] subaccount_id
|
|
# Select only advertisers with these subaccount IDs.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::AdvertisersListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::AdvertisersListResponse]
|
|
#
|
|
# @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(profile_id, advertiser_group_ids: nil, floodlight_configuration_ids: nil, ids: nil, include_advertisers_without_groups_only: nil, max_results: nil, only_parent: nil, page_token: nil, search_string: nil, sort_field: nil, sort_order: nil, status: nil, subaccount_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/advertisers', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::AdvertisersListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::AdvertisersListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['advertiserGroupIds'] = advertiser_group_ids unless advertiser_group_ids.nil?
|
|
command.query['floodlightConfigurationIds'] = floodlight_configuration_ids unless floodlight_configuration_ids.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['includeAdvertisersWithoutGroupsOnly'] = include_advertisers_without_groups_only unless include_advertisers_without_groups_only.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['onlyParent'] = only_parent unless only_parent.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['searchString'] = search_string unless search_string.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['status'] = status unless status.nil?
|
|
command.query['subaccountId'] = subaccount_id unless subaccount_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing advertiser. This method supports patch semantics.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Advertiser ID.
|
|
# @param [Google::Apis::DfareportingV2_8::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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Advertiser] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::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(profile_id, id, advertiser_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'userprofiles/{profileId}/advertisers', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::Advertiser::Representation
|
|
command.request_object = advertiser_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Advertiser::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Advertiser
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing advertiser.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Advertiser] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::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 update_advertiser(profile_id, advertiser_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:put, 'userprofiles/{profileId}/advertisers', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::Advertiser::Representation
|
|
command.request_object = advertiser_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Advertiser::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Advertiser
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of browsers.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::BrowsersListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::BrowsersListResponse]
|
|
#
|
|
# @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_browsers(profile_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/browsers', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::BrowsersListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::BrowsersListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Associates a creative with the specified campaign. This method creates a
|
|
# default ad with dimensions matching the creative in the campaign if such a
|
|
# default ad does not exist already.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] campaign_id
|
|
# Campaign ID in this association.
|
|
# @param [Google::Apis::DfareportingV2_8::CampaignCreativeAssociation] campaign_creative_association_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::CampaignCreativeAssociation] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::CampaignCreativeAssociation]
|
|
#
|
|
# @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 insert_campaign_creative_association(profile_id, campaign_id, campaign_creative_association_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/campaigns/{campaignId}/campaignCreativeAssociations', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::CampaignCreativeAssociation::Representation
|
|
command.request_object = campaign_creative_association_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::CampaignCreativeAssociation::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::CampaignCreativeAssociation
|
|
command.params['profileId'] = profile_id unless profile_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?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves the list of creative IDs associated with the specified campaign.
|
|
# This method supports paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] campaign_id
|
|
# Campaign ID in this association.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::CampaignCreativeAssociationsListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::CampaignCreativeAssociationsListResponse]
|
|
#
|
|
# @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_campaign_creative_associations(profile_id, campaign_id, max_results: nil, page_token: nil, sort_order: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/campaigns/{campaignId}/campaignCreativeAssociations', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::CampaignCreativeAssociationsListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::CampaignCreativeAssociationsListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['campaignId'] = campaign_id unless campaign_id.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one campaign by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Campaign ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Campaign] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::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_campaign(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/campaigns/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Campaign::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Campaign
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Inserts a new campaign.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [String] default_landing_page_name
|
|
# Default landing page name for this new campaign. Must be less than 256
|
|
# characters long.
|
|
# @param [String] default_landing_page_url
|
|
# Default landing page URL for this new campaign.
|
|
# @param [Google::Apis::DfareportingV2_8::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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Campaign] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::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 insert_campaign(profile_id, default_landing_page_name, default_landing_page_url, campaign_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/campaigns', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::Campaign::Representation
|
|
command.request_object = campaign_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Campaign::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Campaign
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['defaultLandingPageName'] = default_landing_page_name unless default_landing_page_name.nil?
|
|
command.query['defaultLandingPageUrl'] = default_landing_page_url unless default_landing_page_url.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of campaigns, possibly filtered. This method supports paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Array<Fixnum>, Fixnum] advertiser_group_ids
|
|
# Select only campaigns whose advertisers belong to these advertiser groups.
|
|
# @param [Array<Fixnum>, Fixnum] advertiser_ids
|
|
# Select only campaigns that belong to these advertisers.
|
|
# @param [Boolean] archived
|
|
# Select only archived campaigns. Don't set this field to select both archived
|
|
# and non-archived campaigns.
|
|
# @param [Boolean] at_least_one_optimization_activity
|
|
# Select only campaigns that have at least one optimization activity.
|
|
# @param [Array<Fixnum>, Fixnum] excluded_ids
|
|
# Exclude campaigns with these IDs.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only campaigns with these IDs.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [Fixnum] overridden_event_tag_id
|
|
# Select only campaigns that have overridden this event tag ID.
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [String] search_string
|
|
# Allows searching for campaigns by name or ID. Wildcards (*) are allowed. For
|
|
# example, "campaign*2015" will return campaigns with names like "campaign June
|
|
# 2015", "campaign April 2015", or simply "campaign 2015". Most of the searches
|
|
# also add wildcards implicitly at the start and the end of the search string.
|
|
# For example, a search string of "campaign" will match campaigns with name "my
|
|
# campaign", "campaign 2015", or simply "campaign".
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @param [Fixnum] subaccount_id
|
|
# Select only campaigns that belong to this subaccount.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::CampaignsListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::CampaignsListResponse]
|
|
#
|
|
# @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_campaigns(profile_id, advertiser_group_ids: nil, advertiser_ids: nil, archived: nil, at_least_one_optimization_activity: nil, excluded_ids: nil, ids: nil, max_results: nil, overridden_event_tag_id: nil, page_token: nil, search_string: nil, sort_field: nil, sort_order: nil, subaccount_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/campaigns', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::CampaignsListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::CampaignsListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['advertiserGroupIds'] = advertiser_group_ids unless advertiser_group_ids.nil?
|
|
command.query['advertiserIds'] = advertiser_ids unless advertiser_ids.nil?
|
|
command.query['archived'] = archived unless archived.nil?
|
|
command.query['atLeastOneOptimizationActivity'] = at_least_one_optimization_activity unless at_least_one_optimization_activity.nil?
|
|
command.query['excludedIds'] = excluded_ids unless excluded_ids.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['overriddenEventTagId'] = overridden_event_tag_id unless overridden_event_tag_id.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['searchString'] = search_string unless search_string.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['subaccountId'] = subaccount_id unless subaccount_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing campaign. This method supports patch semantics.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Campaign ID.
|
|
# @param [Google::Apis::DfareportingV2_8::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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Campaign] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::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_campaign(profile_id, id, campaign_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'userprofiles/{profileId}/campaigns', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::Campaign::Representation
|
|
command.request_object = campaign_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Campaign::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Campaign
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing campaign.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Campaign] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::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 update_campaign(profile_id, campaign_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:put, 'userprofiles/{profileId}/campaigns', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::Campaign::Representation
|
|
command.request_object = campaign_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Campaign::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Campaign
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one change log by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Change log ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::ChangeLog] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::ChangeLog]
|
|
#
|
|
# @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_change_log(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/changeLogs/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::ChangeLog::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::ChangeLog
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of change logs. This method supports paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [String] action
|
|
# Select only change logs with the specified action.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only change logs with these IDs.
|
|
# @param [String] max_change_time
|
|
# Select only change logs whose change time is before the specified
|
|
# maxChangeTime.The time should be formatted as an RFC3339 date/time string. For
|
|
# example, for 10:54 PM on July 18th, 2015, in the America/New York time zone,
|
|
# the format is "2015-07-18T22:54:00-04:00". In other words, the year, month,
|
|
# day, the letter T, the hour (24-hour clock system), minute, second, and then
|
|
# the time zone offset.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] min_change_time
|
|
# Select only change logs whose change time is before the specified
|
|
# minChangeTime.The time should be formatted as an RFC3339 date/time string. For
|
|
# example, for 10:54 PM on July 18th, 2015, in the America/New York time zone,
|
|
# the format is "2015-07-18T22:54:00-04:00". In other words, the year, month,
|
|
# day, the letter T, the hour (24-hour clock system), minute, second, and then
|
|
# the time zone offset.
|
|
# @param [Array<Fixnum>, Fixnum] object_ids
|
|
# Select only change logs with these object IDs.
|
|
# @param [String] object_type
|
|
# Select only change logs with the specified object type.
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [String] search_string
|
|
# Select only change logs whose object ID, user name, old or new values match
|
|
# the search string.
|
|
# @param [Array<Fixnum>, Fixnum] user_profile_ids
|
|
# Select only change logs with these user profile IDs.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::ChangeLogsListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::ChangeLogsListResponse]
|
|
#
|
|
# @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_change_logs(profile_id, action: nil, ids: nil, max_change_time: nil, max_results: nil, min_change_time: nil, object_ids: nil, object_type: nil, page_token: nil, search_string: nil, user_profile_ids: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/changeLogs', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::ChangeLogsListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::ChangeLogsListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['action'] = action unless action.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['maxChangeTime'] = max_change_time unless max_change_time.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['minChangeTime'] = min_change_time unless min_change_time.nil?
|
|
command.query['objectIds'] = object_ids unless object_ids.nil?
|
|
command.query['objectType'] = object_type unless object_type.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['searchString'] = search_string unless search_string.nil?
|
|
command.query['userProfileIds'] = user_profile_ids unless user_profile_ids.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of cities, possibly filtered.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Array<Fixnum>, Fixnum] country_dart_ids
|
|
# Select only cities from these countries.
|
|
# @param [Array<Fixnum>, Fixnum] dart_ids
|
|
# Select only cities with these DART IDs.
|
|
# @param [String] name_prefix
|
|
# Select only cities with names starting with this prefix.
|
|
# @param [Array<Fixnum>, Fixnum] region_dart_ids
|
|
# Select only cities from these regions.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::CitiesListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::CitiesListResponse]
|
|
#
|
|
# @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_cities(profile_id, country_dart_ids: nil, dart_ids: nil, name_prefix: nil, region_dart_ids: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/cities', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::CitiesListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::CitiesListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['countryDartIds'] = country_dart_ids unless country_dart_ids.nil?
|
|
command.query['dartIds'] = dart_ids unless dart_ids.nil?
|
|
command.query['namePrefix'] = name_prefix unless name_prefix.nil?
|
|
command.query['regionDartIds'] = region_dart_ids unless region_dart_ids.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one connection type by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Connection type ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::ConnectionType] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::ConnectionType]
|
|
#
|
|
# @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_connection_type(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/connectionTypes/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::ConnectionType::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::ConnectionType
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of connection types.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::ConnectionTypesListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::ConnectionTypesListResponse]
|
|
#
|
|
# @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_connection_types(profile_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/connectionTypes', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::ConnectionTypesListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::ConnectionTypesListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Deletes an existing content category.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Content category ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [NilClass] No result returned for this method
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [void]
|
|
#
|
|
# @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_content_category(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:delete, 'userprofiles/{profileId}/contentCategories/{id}', options)
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one content category by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Content category ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::ContentCategory] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::ContentCategory]
|
|
#
|
|
# @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_content_category(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/contentCategories/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::ContentCategory::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::ContentCategory
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Inserts a new content category.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::ContentCategory] content_category_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::ContentCategory] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::ContentCategory]
|
|
#
|
|
# @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 insert_content_category(profile_id, content_category_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/contentCategories', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::ContentCategory::Representation
|
|
command.request_object = content_category_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::ContentCategory::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::ContentCategory
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of content categories, possibly filtered. This method
|
|
# supports paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only content categories with these IDs.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [String] search_string
|
|
# Allows searching for objects by name or ID. Wildcards (*) are allowed. For
|
|
# example, "contentcategory*2015" will return objects with names like "
|
|
# contentcategory June 2015", "contentcategory April 2015", or simply "
|
|
# contentcategory 2015". Most of the searches also add wildcards implicitly at
|
|
# the start and the end of the search string. For example, a search string of "
|
|
# contentcategory" will match objects with name "my contentcategory", "
|
|
# contentcategory 2015", or simply "contentcategory".
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::ContentCategoriesListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::ContentCategoriesListResponse]
|
|
#
|
|
# @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_content_categories(profile_id, ids: nil, max_results: nil, page_token: nil, search_string: nil, sort_field: nil, sort_order: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/contentCategories', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::ContentCategoriesListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::ContentCategoriesListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['searchString'] = search_string unless search_string.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing content category. This method supports patch semantics.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Content category ID.
|
|
# @param [Google::Apis::DfareportingV2_8::ContentCategory] content_category_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::ContentCategory] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::ContentCategory]
|
|
#
|
|
# @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_content_category(profile_id, id, content_category_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'userprofiles/{profileId}/contentCategories', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::ContentCategory::Representation
|
|
command.request_object = content_category_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::ContentCategory::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::ContentCategory
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing content category.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::ContentCategory] content_category_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::ContentCategory] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::ContentCategory]
|
|
#
|
|
# @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 update_content_category(profile_id, content_category_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:put, 'userprofiles/{profileId}/contentCategories', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::ContentCategory::Representation
|
|
command.request_object = content_category_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::ContentCategory::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::ContentCategory
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Inserts conversions.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::ConversionsBatchInsertRequest] conversions_batch_insert_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::ConversionsBatchInsertResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::ConversionsBatchInsertResponse]
|
|
#
|
|
# @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 batchinsert_conversion(profile_id, conversions_batch_insert_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/conversions/batchinsert', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::ConversionsBatchInsertRequest::Representation
|
|
command.request_object = conversions_batch_insert_request_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::ConversionsBatchInsertResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::ConversionsBatchInsertResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates existing conversions.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::ConversionsBatchUpdateRequest] conversions_batch_update_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::ConversionsBatchUpdateResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::ConversionsBatchUpdateResponse]
|
|
#
|
|
# @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 batchupdate_conversion(profile_id, conversions_batch_update_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/conversions/batchupdate', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::ConversionsBatchUpdateRequest::Representation
|
|
command.request_object = conversions_batch_update_request_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::ConversionsBatchUpdateResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::ConversionsBatchUpdateResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one country by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] dart_id
|
|
# Country DART ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Country] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::Country]
|
|
#
|
|
# @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_country(profile_id, dart_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/countries/{dartId}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Country::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Country
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['dartId'] = dart_id unless dart_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of countries.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::CountriesListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::CountriesListResponse]
|
|
#
|
|
# @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_countries(profile_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/countries', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::CountriesListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::CountriesListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Inserts a new creative asset.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] advertiser_id
|
|
# Advertiser ID of this creative. This is a required field.
|
|
# @param [Google::Apis::DfareportingV2_8::CreativeAssetMetadata] creative_asset_metadata_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @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::DfareportingV2_8::CreativeAssetMetadata] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::CreativeAssetMetadata]
|
|
#
|
|
# @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 insert_creative_asset(profile_id, advertiser_id, creative_asset_metadata_object = nil, fields: nil, quota_user: nil, user_ip: nil, upload_source: nil, content_type: nil, options: nil, &block)
|
|
if upload_source.nil?
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/creativeAssets/{advertiserId}/creativeAssets', options)
|
|
else
|
|
command = make_upload_command(:post, 'userprofiles/{profileId}/creativeAssets/{advertiserId}/creativeAssets', options)
|
|
command.upload_source = upload_source
|
|
command.upload_content_type = content_type
|
|
end
|
|
command.request_representation = Google::Apis::DfareportingV2_8::CreativeAssetMetadata::Representation
|
|
command.request_object = creative_asset_metadata_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::CreativeAssetMetadata::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::CreativeAssetMetadata
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
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?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Deletes an existing creative field value.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] creative_field_id
|
|
# Creative field ID for this creative field value.
|
|
# @param [Fixnum] id
|
|
# Creative Field Value ID
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [NilClass] No result returned for this method
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [void]
|
|
#
|
|
# @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_creative_field_value(profile_id, creative_field_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:delete, 'userprofiles/{profileId}/creativeFields/{creativeFieldId}/creativeFieldValues/{id}', options)
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['creativeFieldId'] = creative_field_id unless creative_field_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one creative field value by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] creative_field_id
|
|
# Creative field ID for this creative field value.
|
|
# @param [Fixnum] id
|
|
# Creative Field Value ID
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::CreativeFieldValue] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::CreativeFieldValue]
|
|
#
|
|
# @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_creative_field_value(profile_id, creative_field_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/creativeFields/{creativeFieldId}/creativeFieldValues/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::CreativeFieldValue::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::CreativeFieldValue
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['creativeFieldId'] = creative_field_id unless creative_field_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Inserts a new creative field value.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] creative_field_id
|
|
# Creative field ID for this creative field value.
|
|
# @param [Google::Apis::DfareportingV2_8::CreativeFieldValue] creative_field_value_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::CreativeFieldValue] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::CreativeFieldValue]
|
|
#
|
|
# @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 insert_creative_field_value(profile_id, creative_field_id, creative_field_value_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/creativeFields/{creativeFieldId}/creativeFieldValues', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::CreativeFieldValue::Representation
|
|
command.request_object = creative_field_value_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::CreativeFieldValue::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::CreativeFieldValue
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['creativeFieldId'] = creative_field_id unless creative_field_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of creative field values, possibly filtered. This method
|
|
# supports paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] creative_field_id
|
|
# Creative field ID for this creative field value.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only creative field values with these IDs.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [String] search_string
|
|
# Allows searching for creative field values by their values. Wildcards (e.g. *)
|
|
# are not allowed.
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::CreativeFieldValuesListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::CreativeFieldValuesListResponse]
|
|
#
|
|
# @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_creative_field_values(profile_id, creative_field_id, ids: nil, max_results: nil, page_token: nil, search_string: nil, sort_field: nil, sort_order: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/creativeFields/{creativeFieldId}/creativeFieldValues', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::CreativeFieldValuesListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::CreativeFieldValuesListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['creativeFieldId'] = creative_field_id unless creative_field_id.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['searchString'] = search_string unless search_string.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing creative field value. This method supports patch semantics.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] creative_field_id
|
|
# Creative field ID for this creative field value.
|
|
# @param [Fixnum] id
|
|
# Creative Field Value ID
|
|
# @param [Google::Apis::DfareportingV2_8::CreativeFieldValue] creative_field_value_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::CreativeFieldValue] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::CreativeFieldValue]
|
|
#
|
|
# @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_creative_field_value(profile_id, creative_field_id, id, creative_field_value_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'userprofiles/{profileId}/creativeFields/{creativeFieldId}/creativeFieldValues', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::CreativeFieldValue::Representation
|
|
command.request_object = creative_field_value_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::CreativeFieldValue::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::CreativeFieldValue
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['creativeFieldId'] = creative_field_id unless creative_field_id.nil?
|
|
command.query['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing creative field value.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] creative_field_id
|
|
# Creative field ID for this creative field value.
|
|
# @param [Google::Apis::DfareportingV2_8::CreativeFieldValue] creative_field_value_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::CreativeFieldValue] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::CreativeFieldValue]
|
|
#
|
|
# @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 update_creative_field_value(profile_id, creative_field_id, creative_field_value_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:put, 'userprofiles/{profileId}/creativeFields/{creativeFieldId}/creativeFieldValues', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::CreativeFieldValue::Representation
|
|
command.request_object = creative_field_value_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::CreativeFieldValue::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::CreativeFieldValue
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['creativeFieldId'] = creative_field_id unless creative_field_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Deletes an existing creative field.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Creative Field ID
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [NilClass] No result returned for this method
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [void]
|
|
#
|
|
# @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_creative_field(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:delete, 'userprofiles/{profileId}/creativeFields/{id}', options)
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one creative field by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Creative Field ID
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::CreativeField] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::CreativeField]
|
|
#
|
|
# @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_creative_field(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/creativeFields/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::CreativeField::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::CreativeField
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Inserts a new creative field.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::CreativeField] creative_field_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::CreativeField] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::CreativeField]
|
|
#
|
|
# @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 insert_creative_field(profile_id, creative_field_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/creativeFields', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::CreativeField::Representation
|
|
command.request_object = creative_field_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::CreativeField::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::CreativeField
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of creative fields, possibly filtered. This method supports
|
|
# paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Array<Fixnum>, Fixnum] advertiser_ids
|
|
# Select only creative fields that belong to these advertisers.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only creative fields with these IDs.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [String] search_string
|
|
# Allows searching for creative fields by name or ID. Wildcards (*) are allowed.
|
|
# For example, "creativefield*2015" will return creative fields with names like "
|
|
# creativefield June 2015", "creativefield April 2015", or simply "creativefield
|
|
# 2015". Most of the searches also add wild-cards implicitly at the start and
|
|
# the end of the search string. For example, a search string of "creativefield"
|
|
# will match creative fields with the name "my creativefield", "creativefield
|
|
# 2015", or simply "creativefield".
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::CreativeFieldsListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::CreativeFieldsListResponse]
|
|
#
|
|
# @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_creative_fields(profile_id, advertiser_ids: nil, ids: nil, max_results: nil, page_token: nil, search_string: nil, sort_field: nil, sort_order: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/creativeFields', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::CreativeFieldsListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::CreativeFieldsListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['advertiserIds'] = advertiser_ids unless advertiser_ids.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['searchString'] = search_string unless search_string.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing creative field. This method supports patch semantics.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Creative Field ID
|
|
# @param [Google::Apis::DfareportingV2_8::CreativeField] creative_field_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::CreativeField] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::CreativeField]
|
|
#
|
|
# @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_creative_field(profile_id, id, creative_field_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'userprofiles/{profileId}/creativeFields', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::CreativeField::Representation
|
|
command.request_object = creative_field_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::CreativeField::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::CreativeField
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing creative field.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::CreativeField] creative_field_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::CreativeField] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::CreativeField]
|
|
#
|
|
# @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 update_creative_field(profile_id, creative_field_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:put, 'userprofiles/{profileId}/creativeFields', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::CreativeField::Representation
|
|
command.request_object = creative_field_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::CreativeField::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::CreativeField
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one creative group by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Creative group ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::CreativeGroup] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::CreativeGroup]
|
|
#
|
|
# @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_creative_group(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/creativeGroups/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::CreativeGroup::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::CreativeGroup
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Inserts a new creative group.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::CreativeGroup] creative_group_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::CreativeGroup] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::CreativeGroup]
|
|
#
|
|
# @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 insert_creative_group(profile_id, creative_group_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/creativeGroups', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::CreativeGroup::Representation
|
|
command.request_object = creative_group_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::CreativeGroup::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::CreativeGroup
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of creative groups, possibly filtered. This method supports
|
|
# paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Array<Fixnum>, Fixnum] advertiser_ids
|
|
# Select only creative groups that belong to these advertisers.
|
|
# @param [Fixnum] group_number
|
|
# Select only creative groups that belong to this subgroup.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only creative groups with these IDs.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [String] search_string
|
|
# Allows searching for creative groups by name or ID. Wildcards (*) are allowed.
|
|
# For example, "creativegroup*2015" will return creative groups with names like "
|
|
# creativegroup June 2015", "creativegroup April 2015", or simply "creativegroup
|
|
# 2015". Most of the searches also add wild-cards implicitly at the start and
|
|
# the end of the search string. For example, a search string of "creativegroup"
|
|
# will match creative groups with the name "my creativegroup", "creativegroup
|
|
# 2015", or simply "creativegroup".
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::CreativeGroupsListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::CreativeGroupsListResponse]
|
|
#
|
|
# @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_creative_groups(profile_id, advertiser_ids: nil, group_number: nil, ids: nil, max_results: nil, page_token: nil, search_string: nil, sort_field: nil, sort_order: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/creativeGroups', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::CreativeGroupsListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::CreativeGroupsListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['advertiserIds'] = advertiser_ids unless advertiser_ids.nil?
|
|
command.query['groupNumber'] = group_number unless group_number.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['searchString'] = search_string unless search_string.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing creative group. This method supports patch semantics.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Creative group ID.
|
|
# @param [Google::Apis::DfareportingV2_8::CreativeGroup] creative_group_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::CreativeGroup] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::CreativeGroup]
|
|
#
|
|
# @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_creative_group(profile_id, id, creative_group_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'userprofiles/{profileId}/creativeGroups', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::CreativeGroup::Representation
|
|
command.request_object = creative_group_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::CreativeGroup::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::CreativeGroup
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing creative group.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::CreativeGroup] creative_group_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::CreativeGroup] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::CreativeGroup]
|
|
#
|
|
# @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 update_creative_group(profile_id, creative_group_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:put, 'userprofiles/{profileId}/creativeGroups', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::CreativeGroup::Representation
|
|
command.request_object = creative_group_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::CreativeGroup::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::CreativeGroup
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one creative by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Creative ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Creative] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::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_creative(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/creatives/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Creative::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Creative
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Inserts a new creative.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Creative] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::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 insert_creative(profile_id, creative_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/creatives', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::Creative::Representation
|
|
command.request_object = creative_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Creative::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Creative
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of creatives, possibly filtered. This method supports paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Boolean] active
|
|
# Select only active creatives. Leave blank to select active and inactive
|
|
# creatives.
|
|
# @param [Fixnum] advertiser_id
|
|
# Select only creatives with this advertiser ID.
|
|
# @param [Boolean] archived
|
|
# Select only archived creatives. Leave blank to select archived and unarchived
|
|
# creatives.
|
|
# @param [Fixnum] campaign_id
|
|
# Select only creatives with this campaign ID.
|
|
# @param [Array<Fixnum>, Fixnum] companion_creative_ids
|
|
# Select only in-stream video creatives with these companion IDs.
|
|
# @param [Array<Fixnum>, Fixnum] creative_field_ids
|
|
# Select only creatives with these creative field IDs.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only creatives with these IDs.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [Array<Fixnum>, Fixnum] rendering_ids
|
|
# Select only creatives with these rendering IDs.
|
|
# @param [String] search_string
|
|
# Allows searching for objects by name or ID. Wildcards (*) are allowed. For
|
|
# example, "creative*2015" will return objects with names like "creative June
|
|
# 2015", "creative April 2015", or simply "creative 2015". Most of the searches
|
|
# also add wildcards implicitly at the start and the end of the search string.
|
|
# For example, a search string of "creative" will match objects with name "my
|
|
# creative", "creative 2015", or simply "creative".
|
|
# @param [Array<Fixnum>, Fixnum] size_ids
|
|
# Select only creatives with these size IDs.
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @param [Fixnum] studio_creative_id
|
|
# Select only creatives corresponding to this Studio creative ID.
|
|
# @param [Array<String>, String] types
|
|
# Select only creatives with these creative types.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::CreativesListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::CreativesListResponse]
|
|
#
|
|
# @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_creatives(profile_id, active: nil, advertiser_id: nil, archived: nil, campaign_id: nil, companion_creative_ids: nil, creative_field_ids: nil, ids: nil, max_results: nil, page_token: nil, rendering_ids: nil, search_string: nil, size_ids: nil, sort_field: nil, sort_order: nil, studio_creative_id: nil, types: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/creatives', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::CreativesListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::CreativesListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['active'] = active unless active.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['archived'] = archived unless archived.nil?
|
|
command.query['campaignId'] = campaign_id unless campaign_id.nil?
|
|
command.query['companionCreativeIds'] = companion_creative_ids unless companion_creative_ids.nil?
|
|
command.query['creativeFieldIds'] = creative_field_ids unless creative_field_ids.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['renderingIds'] = rendering_ids unless rendering_ids.nil?
|
|
command.query['searchString'] = search_string unless search_string.nil?
|
|
command.query['sizeIds'] = size_ids unless size_ids.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['studioCreativeId'] = studio_creative_id unless studio_creative_id.nil?
|
|
command.query['types'] = types unless types.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing creative. This method supports patch semantics.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Creative ID.
|
|
# @param [Google::Apis::DfareportingV2_8::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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Creative] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::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_creative(profile_id, id, creative_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'userprofiles/{profileId}/creatives', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::Creative::Representation
|
|
command.request_object = creative_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Creative::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Creative
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing creative.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Creative] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::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 update_creative(profile_id, creative_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:put, 'userprofiles/{profileId}/creatives', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::Creative::Representation
|
|
command.request_object = creative_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Creative::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Creative
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves list of report dimension values for a list of filters.
|
|
# @param [Fixnum] profile_id
|
|
# The DFA user profile ID.
|
|
# @param [Google::Apis::DfareportingV2_8::DimensionValueRequest] dimension_value_request_object
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] page_token
|
|
# The value of the nextToken from the previous result page.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::DimensionValueList] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::DimensionValueList]
|
|
#
|
|
# @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 query_dimension_value(profile_id, dimension_value_request_object = nil, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/dimensionvalues/query', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::DimensionValueRequest::Representation
|
|
command.request_object = dimension_value_request_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::DimensionValueList::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::DimensionValueList
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['maxResults'] = max_results unless max_results.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?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one directory site contact by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Directory site contact ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::DirectorySiteContact] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::DirectorySiteContact]
|
|
#
|
|
# @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_directory_site_contact(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/directorySiteContacts/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::DirectorySiteContact::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::DirectorySiteContact
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of directory site contacts, possibly filtered. This method
|
|
# supports paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Array<Fixnum>, Fixnum] directory_site_ids
|
|
# Select only directory site contacts with these directory site IDs. This is a
|
|
# required field.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only directory site contacts with these IDs.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [String] search_string
|
|
# Allows searching for objects by name, ID or email. Wildcards (*) are allowed.
|
|
# For example, "directory site contact*2015" will return objects with names like
|
|
# "directory site contact June 2015", "directory site contact April 2015", or
|
|
# simply "directory site contact 2015". Most of the searches also add wildcards
|
|
# implicitly at the start and the end of the search string. For example, a
|
|
# search string of "directory site contact" will match objects with name "my
|
|
# directory site contact", "directory site contact 2015", or simply "directory
|
|
# site contact".
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::DirectorySiteContactsListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::DirectorySiteContactsListResponse]
|
|
#
|
|
# @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_directory_site_contacts(profile_id, directory_site_ids: nil, ids: nil, max_results: nil, page_token: nil, search_string: nil, sort_field: nil, sort_order: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/directorySiteContacts', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::DirectorySiteContactsListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::DirectorySiteContactsListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['directorySiteIds'] = directory_site_ids unless directory_site_ids.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['searchString'] = search_string unless search_string.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one directory site by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Directory site ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::DirectorySite] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::DirectorySite]
|
|
#
|
|
# @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_directory_site(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/directorySites/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::DirectorySite::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::DirectorySite
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Inserts a new directory site.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::DirectorySite] directory_site_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::DirectorySite] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::DirectorySite]
|
|
#
|
|
# @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 insert_directory_site(profile_id, directory_site_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/directorySites', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::DirectorySite::Representation
|
|
command.request_object = directory_site_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::DirectorySite::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::DirectorySite
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of directory sites, possibly filtered. This method supports
|
|
# paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Boolean] accepts_in_stream_video_placements
|
|
# This search filter is no longer supported and will have no effect on the
|
|
# results returned.
|
|
# @param [Boolean] accepts_interstitial_placements
|
|
# This search filter is no longer supported and will have no effect on the
|
|
# results returned.
|
|
# @param [Boolean] accepts_publisher_paid_placements
|
|
# Select only directory sites that accept publisher paid placements. This field
|
|
# can be left blank.
|
|
# @param [Boolean] active
|
|
# Select only active directory sites. Leave blank to retrieve both active and
|
|
# inactive directory sites.
|
|
# @param [Fixnum] country_id
|
|
# Select only directory sites with this country ID.
|
|
# @param [String] dfp_network_code
|
|
# Select only directory sites with this DFP network code.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only directory sites with these IDs.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [Fixnum] parent_id
|
|
# Select only directory sites with this parent ID.
|
|
# @param [String] search_string
|
|
# Allows searching for objects by name, ID or URL. Wildcards (*) are allowed.
|
|
# For example, "directory site*2015" will return objects with names like "
|
|
# directory site June 2015", "directory site April 2015", or simply "directory
|
|
# site 2015". Most of the searches also add wildcards implicitly at the start
|
|
# and the end of the search string. For example, a search string of "directory
|
|
# site" will match objects with name "my directory site", "directory site 2015"
|
|
# or simply, "directory site".
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::DirectorySitesListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::DirectorySitesListResponse]
|
|
#
|
|
# @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_directory_sites(profile_id, accepts_in_stream_video_placements: nil, accepts_interstitial_placements: nil, accepts_publisher_paid_placements: nil, active: nil, country_id: nil, dfp_network_code: nil, ids: nil, max_results: nil, page_token: nil, parent_id: nil, search_string: nil, sort_field: nil, sort_order: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/directorySites', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::DirectorySitesListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::DirectorySitesListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['acceptsInStreamVideoPlacements'] = accepts_in_stream_video_placements unless accepts_in_stream_video_placements.nil?
|
|
command.query['acceptsInterstitialPlacements'] = accepts_interstitial_placements unless accepts_interstitial_placements.nil?
|
|
command.query['acceptsPublisherPaidPlacements'] = accepts_publisher_paid_placements unless accepts_publisher_paid_placements.nil?
|
|
command.query['active'] = active unless active.nil?
|
|
command.query['countryId'] = country_id unless country_id.nil?
|
|
command.query['dfpNetworkCode'] = dfp_network_code unless dfp_network_code.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['parentId'] = parent_id unless parent_id.nil?
|
|
command.query['searchString'] = search_string unless search_string.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Deletes an existing dynamic targeting key.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] object_id_
|
|
# ID of the object of this dynamic targeting key. This is a required field.
|
|
# @param [String] name
|
|
# Name of this dynamic targeting key. This is a required field. Must be less
|
|
# than 256 characters long and cannot contain commas. All characters are
|
|
# converted to lowercase.
|
|
# @param [String] object_type
|
|
# Type of the object of this dynamic targeting key. This is a required field.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [NilClass] No result returned for this method
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [void]
|
|
#
|
|
# @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_dynamic_targeting_key(profile_id, object_id_, name, object_type, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:delete, 'userprofiles/{profileId}/dynamicTargetingKeys/{objectId}', options)
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['objectId'] = object_id_ unless object_id_.nil?
|
|
command.query['name'] = name unless name.nil?
|
|
command.query['objectType'] = object_type unless object_type.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Inserts a new dynamic targeting key. Keys must be created at the advertiser
|
|
# level before being assigned to the advertiser's ads, creatives, or placements.
|
|
# There is a maximum of 1000 keys per advertiser, out of which a maximum of 20
|
|
# keys can be assigned per ad, creative, or placement.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::DynamicTargetingKey] dynamic_targeting_key_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::DynamicTargetingKey] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::DynamicTargetingKey]
|
|
#
|
|
# @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 insert_dynamic_targeting_key(profile_id, dynamic_targeting_key_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/dynamicTargetingKeys', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::DynamicTargetingKey::Representation
|
|
command.request_object = dynamic_targeting_key_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::DynamicTargetingKey::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::DynamicTargetingKey
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of dynamic targeting keys.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] advertiser_id
|
|
# Select only dynamic targeting keys whose object has this advertiser ID.
|
|
# @param [Array<String>, String] names
|
|
# Select only dynamic targeting keys exactly matching these names.
|
|
# @param [Fixnum] object_id_
|
|
# Select only dynamic targeting keys with this object ID.
|
|
# @param [String] object_type
|
|
# Select only dynamic targeting keys with this object type.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::DynamicTargetingKeysListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::DynamicTargetingKeysListResponse]
|
|
#
|
|
# @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_dynamic_targeting_keys(profile_id, advertiser_id: nil, names: nil, object_id_: nil, object_type: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/dynamicTargetingKeys', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::DynamicTargetingKeysListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::DynamicTargetingKeysListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['names'] = names unless names.nil?
|
|
command.query['objectId'] = object_id_ unless object_id_.nil?
|
|
command.query['objectType'] = object_type unless object_type.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Deletes an existing event tag.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Event tag ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [NilClass] No result returned for this method
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [void]
|
|
#
|
|
# @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_event_tag(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:delete, 'userprofiles/{profileId}/eventTags/{id}', options)
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one event tag by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Event tag ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::EventTag] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::EventTag]
|
|
#
|
|
# @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_event_tag(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/eventTags/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::EventTag::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::EventTag
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Inserts a new event tag.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::EventTag] event_tag_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::EventTag] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::EventTag]
|
|
#
|
|
# @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 insert_event_tag(profile_id, event_tag_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/eventTags', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::EventTag::Representation
|
|
command.request_object = event_tag_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::EventTag::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::EventTag
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of event tags, possibly filtered.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] ad_id
|
|
# Select only event tags that belong to this ad.
|
|
# @param [Fixnum] advertiser_id
|
|
# Select only event tags that belong to this advertiser.
|
|
# @param [Fixnum] campaign_id
|
|
# Select only event tags that belong to this campaign.
|
|
# @param [Boolean] definitions_only
|
|
# Examine only the specified campaign or advertiser's event tags for matching
|
|
# selector criteria. When set to false, the parent advertiser and parent
|
|
# campaign of the specified ad or campaign is examined as well. In addition,
|
|
# when set to false, the status field is examined as well, along with the
|
|
# enabledByDefault field. This parameter can not be set to true when adId is
|
|
# specified as ads do not define their own even tags.
|
|
# @param [Boolean] enabled
|
|
# Select only enabled event tags. What is considered enabled or disabled depends
|
|
# on the definitionsOnly parameter. When definitionsOnly is set to true, only
|
|
# the specified advertiser or campaign's event tags' enabledByDefault field is
|
|
# examined. When definitionsOnly is set to false, the specified ad or specified
|
|
# campaign's parent advertiser's or parent campaign's event tags'
|
|
# enabledByDefault and status fields are examined as well.
|
|
# @param [Array<String>, String] event_tag_types
|
|
# Select only event tags with the specified event tag types. Event tag types can
|
|
# be used to specify whether to use a third-party pixel, a third-party
|
|
# JavaScript URL, or a third-party click-through URL for either impression or
|
|
# click tracking.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only event tags with these IDs.
|
|
# @param [String] search_string
|
|
# Allows searching for objects by name or ID. Wildcards (*) are allowed. For
|
|
# example, "eventtag*2015" will return objects with names like "eventtag June
|
|
# 2015", "eventtag April 2015", or simply "eventtag 2015". Most of the searches
|
|
# also add wildcards implicitly at the start and the end of the search string.
|
|
# For example, a search string of "eventtag" will match objects with name "my
|
|
# eventtag", "eventtag 2015", or simply "eventtag".
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::EventTagsListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::EventTagsListResponse]
|
|
#
|
|
# @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_event_tags(profile_id, ad_id: nil, advertiser_id: nil, campaign_id: nil, definitions_only: nil, enabled: nil, event_tag_types: nil, ids: nil, search_string: nil, sort_field: nil, sort_order: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/eventTags', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::EventTagsListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::EventTagsListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['adId'] = ad_id unless ad_id.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['campaignId'] = campaign_id unless campaign_id.nil?
|
|
command.query['definitionsOnly'] = definitions_only unless definitions_only.nil?
|
|
command.query['enabled'] = enabled unless enabled.nil?
|
|
command.query['eventTagTypes'] = event_tag_types unless event_tag_types.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['searchString'] = search_string unless search_string.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing event tag. This method supports patch semantics.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Event tag ID.
|
|
# @param [Google::Apis::DfareportingV2_8::EventTag] event_tag_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::EventTag] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::EventTag]
|
|
#
|
|
# @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_event_tag(profile_id, id, event_tag_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'userprofiles/{profileId}/eventTags', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::EventTag::Representation
|
|
command.request_object = event_tag_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::EventTag::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::EventTag
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing event tag.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::EventTag] event_tag_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::EventTag] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::EventTag]
|
|
#
|
|
# @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 update_event_tag(profile_id, event_tag_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:put, 'userprofiles/{profileId}/eventTags', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::EventTag::Representation
|
|
command.request_object = event_tag_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::EventTag::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::EventTag
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a report file by its report ID and file ID. This method supports
|
|
# media download.
|
|
# @param [Fixnum] report_id
|
|
# The ID of the report.
|
|
# @param [Fixnum] file_id
|
|
# The ID of the report file.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @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::DfareportingV2_8::File] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::File]
|
|
#
|
|
# @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_file(report_id, file_id, fields: nil, quota_user: nil, user_ip: nil, download_dest: nil, options: nil, &block)
|
|
if download_dest.nil?
|
|
command = make_simple_command(:get, 'reports/{reportId}/files/{fileId}', options)
|
|
else
|
|
command = make_download_command(:get, 'reports/{reportId}/files/{fileId}', options)
|
|
command.download_dest = download_dest
|
|
end
|
|
command.response_representation = Google::Apis::DfareportingV2_8::File::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::File
|
|
command.params['reportId'] = report_id unless report_id.nil?
|
|
command.params['fileId'] = file_id unless file_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists files for a user profile.
|
|
# @param [Fixnum] profile_id
|
|
# The DFA profile ID.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] page_token
|
|
# The value of the nextToken from the previous result page.
|
|
# @param [String] scope
|
|
# The scope that defines which results are returned.
|
|
# @param [String] sort_field
|
|
# The field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::FileList] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::FileList]
|
|
#
|
|
# @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_files(profile_id, max_results: nil, page_token: nil, scope: nil, sort_field: nil, sort_order: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/files', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::FileList::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::FileList
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['scope'] = scope unless scope.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Deletes an existing floodlight activity.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Floodlight activity ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [NilClass] No result returned for this method
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [void]
|
|
#
|
|
# @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_floodlight_activity(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:delete, 'userprofiles/{profileId}/floodlightActivities/{id}', options)
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Generates a tag for a floodlight activity.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] floodlight_activity_id
|
|
# Floodlight activity ID for which we want to generate a tag.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::FloodlightActivitiesGenerateTagResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::FloodlightActivitiesGenerateTagResponse]
|
|
#
|
|
# @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 generatetag_floodlight_activity(profile_id, floodlight_activity_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/floodlightActivities/generatetag', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::FloodlightActivitiesGenerateTagResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::FloodlightActivitiesGenerateTagResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['floodlightActivityId'] = floodlight_activity_id unless floodlight_activity_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one floodlight activity by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Floodlight activity ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::FloodlightActivity] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::FloodlightActivity]
|
|
#
|
|
# @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_activity(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/floodlightActivities/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::FloodlightActivity::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::FloodlightActivity
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Inserts a new floodlight activity.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::FloodlightActivity] floodlight_activity_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::FloodlightActivity] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::FloodlightActivity]
|
|
#
|
|
# @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 insert_floodlight_activity(profile_id, floodlight_activity_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/floodlightActivities', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::FloodlightActivity::Representation
|
|
command.request_object = floodlight_activity_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::FloodlightActivity::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::FloodlightActivity
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of floodlight activities, possibly filtered. This method
|
|
# supports paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] advertiser_id
|
|
# Select only floodlight activities for the specified advertiser ID. Must
|
|
# specify either ids, advertiserId, or floodlightConfigurationId for a non-empty
|
|
# result.
|
|
# @param [Array<Fixnum>, Fixnum] floodlight_activity_group_ids
|
|
# Select only floodlight activities with the specified floodlight activity group
|
|
# IDs.
|
|
# @param [String] floodlight_activity_group_name
|
|
# Select only floodlight activities with the specified floodlight activity group
|
|
# name.
|
|
# @param [String] floodlight_activity_group_tag_string
|
|
# Select only floodlight activities with the specified floodlight activity group
|
|
# tag string.
|
|
# @param [String] floodlight_activity_group_type
|
|
# Select only floodlight activities with the specified floodlight activity group
|
|
# type.
|
|
# @param [Fixnum] floodlight_configuration_id
|
|
# Select only floodlight activities for the specified floodlight configuration
|
|
# ID. Must specify either ids, advertiserId, or floodlightConfigurationId for a
|
|
# non-empty result.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only floodlight activities with the specified IDs. Must specify either
|
|
# ids, advertiserId, or floodlightConfigurationId for a non-empty result.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [String] search_string
|
|
# Allows searching for objects by name or ID. Wildcards (*) are allowed. For
|
|
# example, "floodlightactivity*2015" will return objects with names like "
|
|
# floodlightactivity June 2015", "floodlightactivity April 2015", or simply "
|
|
# floodlightactivity 2015". Most of the searches also add wildcards implicitly
|
|
# at the start and the end of the search string. For example, a search string of
|
|
# "floodlightactivity" will match objects with name "my floodlightactivity
|
|
# activity", "floodlightactivity 2015", or simply "floodlightactivity".
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @param [String] tag_string
|
|
# Select only floodlight activities with the specified tag string.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::FloodlightActivitiesListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::FloodlightActivitiesListResponse]
|
|
#
|
|
# @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_floodlight_activities(profile_id, advertiser_id: nil, floodlight_activity_group_ids: nil, floodlight_activity_group_name: nil, floodlight_activity_group_tag_string: nil, floodlight_activity_group_type: nil, floodlight_configuration_id: nil, ids: nil, max_results: nil, page_token: nil, search_string: nil, sort_field: nil, sort_order: nil, tag_string: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/floodlightActivities', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::FloodlightActivitiesListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::FloodlightActivitiesListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['floodlightActivityGroupIds'] = floodlight_activity_group_ids unless floodlight_activity_group_ids.nil?
|
|
command.query['floodlightActivityGroupName'] = floodlight_activity_group_name unless floodlight_activity_group_name.nil?
|
|
command.query['floodlightActivityGroupTagString'] = floodlight_activity_group_tag_string unless floodlight_activity_group_tag_string.nil?
|
|
command.query['floodlightActivityGroupType'] = floodlight_activity_group_type unless floodlight_activity_group_type.nil?
|
|
command.query['floodlightConfigurationId'] = floodlight_configuration_id unless floodlight_configuration_id.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['searchString'] = search_string unless search_string.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['tagString'] = tag_string unless tag_string.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing floodlight activity. This method supports patch semantics.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Floodlight activity ID.
|
|
# @param [Google::Apis::DfareportingV2_8::FloodlightActivity] floodlight_activity_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::FloodlightActivity] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::FloodlightActivity]
|
|
#
|
|
# @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_activity(profile_id, id, floodlight_activity_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'userprofiles/{profileId}/floodlightActivities', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::FloodlightActivity::Representation
|
|
command.request_object = floodlight_activity_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::FloodlightActivity::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::FloodlightActivity
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing floodlight activity.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::FloodlightActivity] floodlight_activity_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::FloodlightActivity] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::FloodlightActivity]
|
|
#
|
|
# @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 update_floodlight_activity(profile_id, floodlight_activity_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:put, 'userprofiles/{profileId}/floodlightActivities', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::FloodlightActivity::Representation
|
|
command.request_object = floodlight_activity_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::FloodlightActivity::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::FloodlightActivity
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one floodlight activity group by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Floodlight activity Group ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::FloodlightActivityGroup] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::FloodlightActivityGroup]
|
|
#
|
|
# @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_activity_group(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/floodlightActivityGroups/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::FloodlightActivityGroup::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::FloodlightActivityGroup
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Inserts a new floodlight activity group.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::FloodlightActivityGroup] floodlight_activity_group_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::FloodlightActivityGroup] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::FloodlightActivityGroup]
|
|
#
|
|
# @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 insert_floodlight_activity_group(profile_id, floodlight_activity_group_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/floodlightActivityGroups', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::FloodlightActivityGroup::Representation
|
|
command.request_object = floodlight_activity_group_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::FloodlightActivityGroup::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::FloodlightActivityGroup
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of floodlight activity groups, possibly filtered. This method
|
|
# supports paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] advertiser_id
|
|
# Select only floodlight activity groups with the specified advertiser ID. Must
|
|
# specify either advertiserId or floodlightConfigurationId for a non-empty
|
|
# result.
|
|
# @param [Fixnum] floodlight_configuration_id
|
|
# Select only floodlight activity groups with the specified floodlight
|
|
# configuration ID. Must specify either advertiserId, or
|
|
# floodlightConfigurationId for a non-empty result.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only floodlight activity groups with the specified IDs. Must specify
|
|
# either advertiserId or floodlightConfigurationId for a non-empty result.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [String] search_string
|
|
# Allows searching for objects by name or ID. Wildcards (*) are allowed. For
|
|
# example, "floodlightactivitygroup*2015" will return objects with names like "
|
|
# floodlightactivitygroup June 2015", "floodlightactivitygroup April 2015", or
|
|
# simply "floodlightactivitygroup 2015". Most of the searches also add wildcards
|
|
# implicitly at the start and the end of the search string. For example, a
|
|
# search string of "floodlightactivitygroup" will match objects with name "my
|
|
# floodlightactivitygroup activity", "floodlightactivitygroup 2015", or simply "
|
|
# floodlightactivitygroup".
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @param [String] type
|
|
# Select only floodlight activity groups with the specified floodlight activity
|
|
# group type.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::FloodlightActivityGroupsListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::FloodlightActivityGroupsListResponse]
|
|
#
|
|
# @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_floodlight_activity_groups(profile_id, advertiser_id: nil, floodlight_configuration_id: nil, ids: nil, max_results: nil, page_token: nil, search_string: nil, sort_field: nil, sort_order: nil, type: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/floodlightActivityGroups', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::FloodlightActivityGroupsListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::FloodlightActivityGroupsListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['floodlightConfigurationId'] = floodlight_configuration_id unless floodlight_configuration_id.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['searchString'] = search_string unless search_string.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['type'] = type unless type.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing floodlight activity group. This method supports patch
|
|
# semantics.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Floodlight activity Group ID.
|
|
# @param [Google::Apis::DfareportingV2_8::FloodlightActivityGroup] floodlight_activity_group_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::FloodlightActivityGroup] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::FloodlightActivityGroup]
|
|
#
|
|
# @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_activity_group(profile_id, id, floodlight_activity_group_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'userprofiles/{profileId}/floodlightActivityGroups', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::FloodlightActivityGroup::Representation
|
|
command.request_object = floodlight_activity_group_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::FloodlightActivityGroup::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::FloodlightActivityGroup
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing floodlight activity group.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::FloodlightActivityGroup] floodlight_activity_group_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::FloodlightActivityGroup] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::FloodlightActivityGroup]
|
|
#
|
|
# @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 update_floodlight_activity_group(profile_id, floodlight_activity_group_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:put, 'userprofiles/{profileId}/floodlightActivityGroups', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::FloodlightActivityGroup::Representation
|
|
command.request_object = floodlight_activity_group_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::FloodlightActivityGroup::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::FloodlightActivityGroup
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one floodlight configuration by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Floodlight configuration ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::FloodlightConfiguration] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::FloodlightConfiguration]
|
|
#
|
|
# @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_configuration(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/floodlightConfigurations/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::FloodlightConfiguration::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::FloodlightConfiguration
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of floodlight configurations, possibly filtered.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Set of IDs of floodlight configurations to retrieve. Required field; otherwise
|
|
# an empty list 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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::FloodlightConfigurationsListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::FloodlightConfigurationsListResponse]
|
|
#
|
|
# @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_floodlight_configurations(profile_id, ids: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/floodlightConfigurations', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::FloodlightConfigurationsListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::FloodlightConfigurationsListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing floodlight configuration. This method supports patch
|
|
# semantics.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Floodlight configuration ID.
|
|
# @param [Google::Apis::DfareportingV2_8::FloodlightConfiguration] floodlight_configuration_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::FloodlightConfiguration] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::FloodlightConfiguration]
|
|
#
|
|
# @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_configuration(profile_id, id, floodlight_configuration_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'userprofiles/{profileId}/floodlightConfigurations', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::FloodlightConfiguration::Representation
|
|
command.request_object = floodlight_configuration_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::FloodlightConfiguration::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::FloodlightConfiguration
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing floodlight configuration.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::FloodlightConfiguration] floodlight_configuration_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::FloodlightConfiguration] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::FloodlightConfiguration]
|
|
#
|
|
# @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 update_floodlight_configuration(profile_id, floodlight_configuration_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:put, 'userprofiles/{profileId}/floodlightConfigurations', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::FloodlightConfiguration::Representation
|
|
command.request_object = floodlight_configuration_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::FloodlightConfiguration::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::FloodlightConfiguration
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one inventory item by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] project_id
|
|
# Project ID for order documents.
|
|
# @param [Fixnum] id
|
|
# Inventory item ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::InventoryItem] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::InventoryItem]
|
|
#
|
|
# @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_item(profile_id, project_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/projects/{projectId}/inventoryItems/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::InventoryItem::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::InventoryItem
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['projectId'] = project_id unless project_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of inventory items, possibly filtered. This method supports
|
|
# paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] project_id
|
|
# Project ID for order documents.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only inventory items with these IDs.
|
|
# @param [Boolean] in_plan
|
|
# Select only inventory items that are in plan.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [Array<Fixnum>, Fixnum] order_id
|
|
# Select only inventory items that belong to specified orders.
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [Array<Fixnum>, Fixnum] site_id
|
|
# Select only inventory items that are associated with these sites.
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @param [String] type
|
|
# Select only inventory items with this type.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::InventoryItemsListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::InventoryItemsListResponse]
|
|
#
|
|
# @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_items(profile_id, project_id, ids: nil, in_plan: nil, max_results: nil, order_id: nil, page_token: nil, site_id: nil, sort_field: nil, sort_order: nil, type: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/projects/{projectId}/inventoryItems', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::InventoryItemsListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::InventoryItemsListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['projectId'] = project_id unless project_id.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['inPlan'] = in_plan unless in_plan.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['orderId'] = order_id unless order_id.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['siteId'] = site_id unless site_id.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['type'] = type unless type.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Deletes an existing campaign landing page.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] campaign_id
|
|
# Landing page campaign ID.
|
|
# @param [Fixnum] id
|
|
# Landing page ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [NilClass] No result returned for this method
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [void]
|
|
#
|
|
# @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_landing_page(profile_id, campaign_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:delete, 'userprofiles/{profileId}/campaigns/{campaignId}/landingPages/{id}', options)
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['campaignId'] = campaign_id unless campaign_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one campaign landing page by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] campaign_id
|
|
# Landing page campaign ID.
|
|
# @param [Fixnum] id
|
|
# Landing page ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::LandingPage] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::LandingPage]
|
|
#
|
|
# @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_landing_page(profile_id, campaign_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/campaigns/{campaignId}/landingPages/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::LandingPage::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::LandingPage
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['campaignId'] = campaign_id unless campaign_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Inserts a new landing page for the specified campaign.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] campaign_id
|
|
# Landing page campaign ID.
|
|
# @param [Google::Apis::DfareportingV2_8::LandingPage] landing_page_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::LandingPage] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::LandingPage]
|
|
#
|
|
# @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 insert_landing_page(profile_id, campaign_id, landing_page_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/campaigns/{campaignId}/landingPages', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::LandingPage::Representation
|
|
command.request_object = landing_page_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::LandingPage::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::LandingPage
|
|
command.params['profileId'] = profile_id unless profile_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?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves the list of landing pages for the specified campaign.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] campaign_id
|
|
# Landing page campaign ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::LandingPagesListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::LandingPagesListResponse]
|
|
#
|
|
# @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_landing_pages(profile_id, campaign_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/campaigns/{campaignId}/landingPages', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::LandingPagesListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::LandingPagesListResponse
|
|
command.params['profileId'] = profile_id unless profile_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?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing campaign landing page. This method supports patch
|
|
# semantics.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] campaign_id
|
|
# Landing page campaign ID.
|
|
# @param [Fixnum] id
|
|
# Landing page ID.
|
|
# @param [Google::Apis::DfareportingV2_8::LandingPage] landing_page_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::LandingPage] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::LandingPage]
|
|
#
|
|
# @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_landing_page(profile_id, campaign_id, id, landing_page_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'userprofiles/{profileId}/campaigns/{campaignId}/landingPages', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::LandingPage::Representation
|
|
command.request_object = landing_page_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::LandingPage::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::LandingPage
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['campaignId'] = campaign_id unless campaign_id.nil?
|
|
command.query['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing campaign landing page.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] campaign_id
|
|
# Landing page campaign ID.
|
|
# @param [Google::Apis::DfareportingV2_8::LandingPage] landing_page_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::LandingPage] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::LandingPage]
|
|
#
|
|
# @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 update_landing_page(profile_id, campaign_id, landing_page_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:put, 'userprofiles/{profileId}/campaigns/{campaignId}/landingPages', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::LandingPage::Representation
|
|
command.request_object = landing_page_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::LandingPage::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::LandingPage
|
|
command.params['profileId'] = profile_id unless profile_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?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of languages.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::LanguagesListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::LanguagesListResponse]
|
|
#
|
|
# @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_languages(profile_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/languages', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::LanguagesListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::LanguagesListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of metros.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::MetrosListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::MetrosListResponse]
|
|
#
|
|
# @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_metros(profile_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/metros', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::MetrosListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::MetrosListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one mobile carrier by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Mobile carrier ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::MobileCarrier] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::MobileCarrier]
|
|
#
|
|
# @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_mobile_carrier(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/mobileCarriers/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::MobileCarrier::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::MobileCarrier
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of mobile carriers.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::MobileCarriersListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::MobileCarriersListResponse]
|
|
#
|
|
# @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_mobile_carriers(profile_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/mobileCarriers', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::MobileCarriersListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::MobileCarriersListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one operating system version by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Operating system version ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::OperatingSystemVersion] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::OperatingSystemVersion]
|
|
#
|
|
# @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_operating_system_version(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/operatingSystemVersions/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::OperatingSystemVersion::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::OperatingSystemVersion
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of operating system versions.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::OperatingSystemVersionsListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::OperatingSystemVersionsListResponse]
|
|
#
|
|
# @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_operating_system_versions(profile_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/operatingSystemVersions', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::OperatingSystemVersionsListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::OperatingSystemVersionsListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one operating system by DART ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] dart_id
|
|
# Operating system DART ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::OperatingSystem] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::OperatingSystem]
|
|
#
|
|
# @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_operating_system(profile_id, dart_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/operatingSystems/{dartId}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::OperatingSystem::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::OperatingSystem
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['dartId'] = dart_id unless dart_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of operating systems.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::OperatingSystemsListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::OperatingSystemsListResponse]
|
|
#
|
|
# @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_operating_systems(profile_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/operatingSystems', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::OperatingSystemsListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::OperatingSystemsListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one order document by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] project_id
|
|
# Project ID for order documents.
|
|
# @param [Fixnum] id
|
|
# Order document ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::OrderDocument] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::OrderDocument]
|
|
#
|
|
# @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_order_document(profile_id, project_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/projects/{projectId}/orderDocuments/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::OrderDocument::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::OrderDocument
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['projectId'] = project_id unless project_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of order documents, possibly filtered. This method supports
|
|
# paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] project_id
|
|
# Project ID for order documents.
|
|
# @param [Boolean] approved
|
|
# Select only order documents that have been approved by at least one user.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only order documents with these IDs.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [Array<Fixnum>, Fixnum] order_id
|
|
# Select only order documents for specified orders.
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [String] search_string
|
|
# Allows searching for order documents by name or ID. Wildcards (*) are allowed.
|
|
# For example, "orderdocument*2015" will return order documents with names like "
|
|
# orderdocument June 2015", "orderdocument April 2015", or simply "orderdocument
|
|
# 2015". Most of the searches also add wildcards implicitly at the start and the
|
|
# end of the search string. For example, a search string of "orderdocument" will
|
|
# match order documents with name "my orderdocument", "orderdocument 2015", or
|
|
# simply "orderdocument".
|
|
# @param [Array<Fixnum>, Fixnum] site_id
|
|
# Select only order documents that are associated with these sites.
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::OrderDocumentsListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::OrderDocumentsListResponse]
|
|
#
|
|
# @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_order_documents(profile_id, project_id, approved: nil, ids: nil, max_results: nil, order_id: nil, page_token: nil, search_string: nil, site_id: nil, sort_field: nil, sort_order: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/projects/{projectId}/orderDocuments', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::OrderDocumentsListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::OrderDocumentsListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['projectId'] = project_id unless project_id.nil?
|
|
command.query['approved'] = approved unless approved.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['orderId'] = order_id unless order_id.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['searchString'] = search_string unless search_string.nil?
|
|
command.query['siteId'] = site_id unless site_id.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one order by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] project_id
|
|
# Project ID for orders.
|
|
# @param [Fixnum] id
|
|
# Order ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Order] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::Order]
|
|
#
|
|
# @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_order(profile_id, project_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/projects/{projectId}/orders/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Order::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Order
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['projectId'] = project_id unless project_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of orders, possibly filtered. This method supports paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] project_id
|
|
# Project ID for orders.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only orders with these IDs.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [String] search_string
|
|
# Allows searching for orders by name or ID. Wildcards (*) are allowed. For
|
|
# example, "order*2015" will return orders with names like "order June 2015", "
|
|
# order April 2015", or simply "order 2015". Most of the searches also add
|
|
# wildcards implicitly at the start and the end of the search string. For
|
|
# example, a search string of "order" will match orders with name "my order", "
|
|
# order 2015", or simply "order".
|
|
# @param [Array<Fixnum>, Fixnum] site_id
|
|
# Select only orders that are associated with these site IDs.
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::OrdersListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::OrdersListResponse]
|
|
#
|
|
# @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_orders(profile_id, project_id, ids: nil, max_results: nil, page_token: nil, search_string: nil, site_id: nil, sort_field: nil, sort_order: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/projects/{projectId}/orders', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::OrdersListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::OrdersListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['projectId'] = project_id unless project_id.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['searchString'] = search_string unless search_string.nil?
|
|
command.query['siteId'] = site_id unless site_id.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one placement group by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Placement group ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::PlacementGroup] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::PlacementGroup]
|
|
#
|
|
# @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_placement_group(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/placementGroups/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::PlacementGroup::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::PlacementGroup
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Inserts a new placement group.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::PlacementGroup] placement_group_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::PlacementGroup] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::PlacementGroup]
|
|
#
|
|
# @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 insert_placement_group(profile_id, placement_group_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/placementGroups', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::PlacementGroup::Representation
|
|
command.request_object = placement_group_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::PlacementGroup::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::PlacementGroup
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of placement groups, possibly filtered. This method supports
|
|
# paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Array<Fixnum>, Fixnum] advertiser_ids
|
|
# Select only placement groups that belong to these advertisers.
|
|
# @param [Boolean] archived
|
|
# Select only archived placements. Don't set this field to select both archived
|
|
# and non-archived placements.
|
|
# @param [Array<Fixnum>, Fixnum] campaign_ids
|
|
# Select only placement groups that belong to these campaigns.
|
|
# @param [Array<Fixnum>, Fixnum] content_category_ids
|
|
# Select only placement groups that are associated with these content categories.
|
|
# @param [Array<Fixnum>, Fixnum] directory_site_ids
|
|
# Select only placement groups that are associated with these directory sites.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only placement groups with these IDs.
|
|
# @param [String] max_end_date
|
|
# Select only placements or placement groups whose end date is on or before the
|
|
# specified maxEndDate. The date should be formatted as "yyyy-MM-dd".
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] max_start_date
|
|
# Select only placements or placement groups whose start date is on or before
|
|
# the specified maxStartDate. The date should be formatted as "yyyy-MM-dd".
|
|
# @param [String] min_end_date
|
|
# Select only placements or placement groups whose end date is on or after the
|
|
# specified minEndDate. The date should be formatted as "yyyy-MM-dd".
|
|
# @param [String] min_start_date
|
|
# Select only placements or placement groups whose start date is on or after the
|
|
# specified minStartDate. The date should be formatted as "yyyy-MM-dd".
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [String] placement_group_type
|
|
# Select only placement groups belonging with this group type. A package is a
|
|
# simple group of placements that acts as a single pricing point for a group of
|
|
# tags. A roadblock is a group of placements that not only acts as a single
|
|
# pricing point but also assumes that all the tags in it will be served at the
|
|
# same time. A roadblock requires one of its assigned placements to be marked as
|
|
# primary for reporting.
|
|
# @param [Array<Fixnum>, Fixnum] placement_strategy_ids
|
|
# Select only placement groups that are associated with these placement
|
|
# strategies.
|
|
# @param [Array<String>, String] pricing_types
|
|
# Select only placement groups with these pricing types.
|
|
# @param [String] search_string
|
|
# Allows searching for placement groups by name or ID. Wildcards (*) are allowed.
|
|
# For example, "placement*2015" will return placement groups with names like "
|
|
# placement group June 2015", "placement group May 2015", or simply "placements
|
|
# 2015". Most of the searches also add wildcards implicitly at the start and the
|
|
# end of the search string. For example, a search string of "placementgroup"
|
|
# will match placement groups with name "my placementgroup", "placementgroup
|
|
# 2015", or simply "placementgroup".
|
|
# @param [Array<Fixnum>, Fixnum] site_ids
|
|
# Select only placement groups that are associated with these sites.
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::PlacementGroupsListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::PlacementGroupsListResponse]
|
|
#
|
|
# @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_placement_groups(profile_id, advertiser_ids: nil, archived: nil, campaign_ids: nil, content_category_ids: nil, directory_site_ids: nil, ids: nil, max_end_date: nil, max_results: nil, max_start_date: nil, min_end_date: nil, min_start_date: nil, page_token: nil, placement_group_type: nil, placement_strategy_ids: nil, pricing_types: nil, search_string: nil, site_ids: nil, sort_field: nil, sort_order: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/placementGroups', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::PlacementGroupsListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::PlacementGroupsListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['advertiserIds'] = advertiser_ids unless advertiser_ids.nil?
|
|
command.query['archived'] = archived unless archived.nil?
|
|
command.query['campaignIds'] = campaign_ids unless campaign_ids.nil?
|
|
command.query['contentCategoryIds'] = content_category_ids unless content_category_ids.nil?
|
|
command.query['directorySiteIds'] = directory_site_ids unless directory_site_ids.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['maxEndDate'] = max_end_date unless max_end_date.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['maxStartDate'] = max_start_date unless max_start_date.nil?
|
|
command.query['minEndDate'] = min_end_date unless min_end_date.nil?
|
|
command.query['minStartDate'] = min_start_date unless min_start_date.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['placementGroupType'] = placement_group_type unless placement_group_type.nil?
|
|
command.query['placementStrategyIds'] = placement_strategy_ids unless placement_strategy_ids.nil?
|
|
command.query['pricingTypes'] = pricing_types unless pricing_types.nil?
|
|
command.query['searchString'] = search_string unless search_string.nil?
|
|
command.query['siteIds'] = site_ids unless site_ids.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing placement group. This method supports patch semantics.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Placement group ID.
|
|
# @param [Google::Apis::DfareportingV2_8::PlacementGroup] placement_group_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::PlacementGroup] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::PlacementGroup]
|
|
#
|
|
# @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_placement_group(profile_id, id, placement_group_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'userprofiles/{profileId}/placementGroups', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::PlacementGroup::Representation
|
|
command.request_object = placement_group_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::PlacementGroup::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::PlacementGroup
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing placement group.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::PlacementGroup] placement_group_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::PlacementGroup] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::PlacementGroup]
|
|
#
|
|
# @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 update_placement_group(profile_id, placement_group_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:put, 'userprofiles/{profileId}/placementGroups', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::PlacementGroup::Representation
|
|
command.request_object = placement_group_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::PlacementGroup::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::PlacementGroup
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Deletes an existing placement strategy.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Placement strategy ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [NilClass] No result returned for this method
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [void]
|
|
#
|
|
# @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_placement_strategy(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:delete, 'userprofiles/{profileId}/placementStrategies/{id}', options)
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one placement strategy by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Placement strategy ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::PlacementStrategy] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::PlacementStrategy]
|
|
#
|
|
# @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_placement_strategy(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/placementStrategies/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::PlacementStrategy::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::PlacementStrategy
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Inserts a new placement strategy.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::PlacementStrategy] placement_strategy_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::PlacementStrategy] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::PlacementStrategy]
|
|
#
|
|
# @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 insert_placement_strategy(profile_id, placement_strategy_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/placementStrategies', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::PlacementStrategy::Representation
|
|
command.request_object = placement_strategy_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::PlacementStrategy::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::PlacementStrategy
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of placement strategies, possibly filtered. This method
|
|
# supports paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only placement strategies with these IDs.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [String] search_string
|
|
# Allows searching for objects by name or ID. Wildcards (*) are allowed. For
|
|
# example, "placementstrategy*2015" will return objects with names like "
|
|
# placementstrategy June 2015", "placementstrategy April 2015", or simply "
|
|
# placementstrategy 2015". Most of the searches also add wildcards implicitly at
|
|
# the start and the end of the search string. For example, a search string of "
|
|
# placementstrategy" will match objects with name "my placementstrategy", "
|
|
# placementstrategy 2015", or simply "placementstrategy".
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::PlacementStrategiesListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::PlacementStrategiesListResponse]
|
|
#
|
|
# @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_placement_strategies(profile_id, ids: nil, max_results: nil, page_token: nil, search_string: nil, sort_field: nil, sort_order: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/placementStrategies', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::PlacementStrategiesListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::PlacementStrategiesListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['searchString'] = search_string unless search_string.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing placement strategy. This method supports patch semantics.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Placement strategy ID.
|
|
# @param [Google::Apis::DfareportingV2_8::PlacementStrategy] placement_strategy_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::PlacementStrategy] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::PlacementStrategy]
|
|
#
|
|
# @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_placement_strategy(profile_id, id, placement_strategy_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'userprofiles/{profileId}/placementStrategies', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::PlacementStrategy::Representation
|
|
command.request_object = placement_strategy_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::PlacementStrategy::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::PlacementStrategy
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing placement strategy.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::PlacementStrategy] placement_strategy_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::PlacementStrategy] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::PlacementStrategy]
|
|
#
|
|
# @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 update_placement_strategy(profile_id, placement_strategy_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:put, 'userprofiles/{profileId}/placementStrategies', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::PlacementStrategy::Representation
|
|
command.request_object = placement_strategy_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::PlacementStrategy::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::PlacementStrategy
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Generates tags for a placement.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] campaign_id
|
|
# Generate placements belonging to this campaign. This is a required field.
|
|
# @param [Array<Fixnum>, Fixnum] placement_ids
|
|
# Generate tags for these placements.
|
|
# @param [Array<String>, String] tag_formats
|
|
# Tag formats to generate for these placements.
|
|
# Note: PLACEMENT_TAG_STANDARD can only be generated for 1x1 placements.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::PlacementsGenerateTagsResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::PlacementsGenerateTagsResponse]
|
|
#
|
|
# @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 generatetags_placement(profile_id, campaign_id: nil, placement_ids: nil, tag_formats: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/placements/generatetags', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::PlacementsGenerateTagsResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::PlacementsGenerateTagsResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['campaignId'] = campaign_id unless campaign_id.nil?
|
|
command.query['placementIds'] = placement_ids unless placement_ids.nil?
|
|
command.query['tagFormats'] = tag_formats unless tag_formats.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one placement by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Placement ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Placement] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::Placement]
|
|
#
|
|
# @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_placement(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/placements/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Placement::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Placement
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Inserts a new placement.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::Placement] placement_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Placement] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::Placement]
|
|
#
|
|
# @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 insert_placement(profile_id, placement_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/placements', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::Placement::Representation
|
|
command.request_object = placement_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Placement::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Placement
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of placements, possibly filtered. This method supports paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Array<Fixnum>, Fixnum] advertiser_ids
|
|
# Select only placements that belong to these advertisers.
|
|
# @param [Boolean] archived
|
|
# Select only archived placements. Don't set this field to select both archived
|
|
# and non-archived placements.
|
|
# @param [Array<Fixnum>, Fixnum] campaign_ids
|
|
# Select only placements that belong to these campaigns.
|
|
# @param [Array<String>, String] compatibilities
|
|
# Select only placements that are associated with these compatibilities. DISPLAY
|
|
# and DISPLAY_INTERSTITIAL refer to rendering either on desktop or on mobile
|
|
# devices for regular or interstitial ads respectively. APP and APP_INTERSTITIAL
|
|
# are for rendering in mobile apps. IN_STREAM_VIDEO refers to rendering in in-
|
|
# stream video ads developed with the VAST standard.
|
|
# @param [Array<Fixnum>, Fixnum] content_category_ids
|
|
# Select only placements that are associated with these content categories.
|
|
# @param [Array<Fixnum>, Fixnum] directory_site_ids
|
|
# Select only placements that are associated with these directory sites.
|
|
# @param [Array<Fixnum>, Fixnum] group_ids
|
|
# Select only placements that belong to these placement groups.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only placements with these IDs.
|
|
# @param [String] max_end_date
|
|
# Select only placements or placement groups whose end date is on or before the
|
|
# specified maxEndDate. The date should be formatted as "yyyy-MM-dd".
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] max_start_date
|
|
# Select only placements or placement groups whose start date is on or before
|
|
# the specified maxStartDate. The date should be formatted as "yyyy-MM-dd".
|
|
# @param [String] min_end_date
|
|
# Select only placements or placement groups whose end date is on or after the
|
|
# specified minEndDate. The date should be formatted as "yyyy-MM-dd".
|
|
# @param [String] min_start_date
|
|
# Select only placements or placement groups whose start date is on or after the
|
|
# specified minStartDate. The date should be formatted as "yyyy-MM-dd".
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [String] payment_source
|
|
# Select only placements with this payment source.
|
|
# @param [Array<Fixnum>, Fixnum] placement_strategy_ids
|
|
# Select only placements that are associated with these placement strategies.
|
|
# @param [Array<String>, String] pricing_types
|
|
# Select only placements with these pricing types.
|
|
# @param [String] search_string
|
|
# Allows searching for placements by name or ID. Wildcards (*) are allowed. For
|
|
# example, "placement*2015" will return placements with names like "placement
|
|
# June 2015", "placement May 2015", or simply "placements 2015". Most of the
|
|
# searches also add wildcards implicitly at the start and the end of the search
|
|
# string. For example, a search string of "placement" will match placements with
|
|
# name "my placement", "placement 2015", or simply "placement".
|
|
# @param [Array<Fixnum>, Fixnum] site_ids
|
|
# Select only placements that are associated with these sites.
|
|
# @param [Array<Fixnum>, Fixnum] size_ids
|
|
# Select only placements that are associated with these sizes.
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::PlacementsListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::PlacementsListResponse]
|
|
#
|
|
# @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_placements(profile_id, advertiser_ids: nil, archived: nil, campaign_ids: nil, compatibilities: nil, content_category_ids: nil, directory_site_ids: nil, group_ids: nil, ids: nil, max_end_date: nil, max_results: nil, max_start_date: nil, min_end_date: nil, min_start_date: nil, page_token: nil, payment_source: nil, placement_strategy_ids: nil, pricing_types: nil, search_string: nil, site_ids: nil, size_ids: nil, sort_field: nil, sort_order: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/placements', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::PlacementsListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::PlacementsListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['advertiserIds'] = advertiser_ids unless advertiser_ids.nil?
|
|
command.query['archived'] = archived unless archived.nil?
|
|
command.query['campaignIds'] = campaign_ids unless campaign_ids.nil?
|
|
command.query['compatibilities'] = compatibilities unless compatibilities.nil?
|
|
command.query['contentCategoryIds'] = content_category_ids unless content_category_ids.nil?
|
|
command.query['directorySiteIds'] = directory_site_ids unless directory_site_ids.nil?
|
|
command.query['groupIds'] = group_ids unless group_ids.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['maxEndDate'] = max_end_date unless max_end_date.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['maxStartDate'] = max_start_date unless max_start_date.nil?
|
|
command.query['minEndDate'] = min_end_date unless min_end_date.nil?
|
|
command.query['minStartDate'] = min_start_date unless min_start_date.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['paymentSource'] = payment_source unless payment_source.nil?
|
|
command.query['placementStrategyIds'] = placement_strategy_ids unless placement_strategy_ids.nil?
|
|
command.query['pricingTypes'] = pricing_types unless pricing_types.nil?
|
|
command.query['searchString'] = search_string unless search_string.nil?
|
|
command.query['siteIds'] = site_ids unless site_ids.nil?
|
|
command.query['sizeIds'] = size_ids unless size_ids.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing placement. This method supports patch semantics.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Placement ID.
|
|
# @param [Google::Apis::DfareportingV2_8::Placement] placement_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Placement] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::Placement]
|
|
#
|
|
# @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_placement(profile_id, id, placement_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'userprofiles/{profileId}/placements', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::Placement::Representation
|
|
command.request_object = placement_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Placement::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Placement
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing placement.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::Placement] placement_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Placement] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::Placement]
|
|
#
|
|
# @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 update_placement(profile_id, placement_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:put, 'userprofiles/{profileId}/placements', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::Placement::Representation
|
|
command.request_object = placement_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Placement::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Placement
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one platform type by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Platform type ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::PlatformType] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::PlatformType]
|
|
#
|
|
# @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_platform_type(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/platformTypes/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::PlatformType::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::PlatformType
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of platform types.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::PlatformTypesListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::PlatformTypesListResponse]
|
|
#
|
|
# @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_platform_types(profile_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/platformTypes', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::PlatformTypesListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::PlatformTypesListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one postal code by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [String] code
|
|
# Postal code ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::PostalCode] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::PostalCode]
|
|
#
|
|
# @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_postal_code(profile_id, code, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/postalCodes/{code}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::PostalCode::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::PostalCode
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['code'] = code unless code.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of postal codes.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::PostalCodesListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::PostalCodesListResponse]
|
|
#
|
|
# @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_postal_codes(profile_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/postalCodes', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::PostalCodesListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::PostalCodesListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one project by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Project ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Project] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::Project]
|
|
#
|
|
# @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_project(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/projects/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Project::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Project
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of projects, possibly filtered. This method supports paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Array<Fixnum>, Fixnum] advertiser_ids
|
|
# Select only projects with these advertiser IDs.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only projects with these IDs.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [String] search_string
|
|
# Allows searching for projects by name or ID. Wildcards (*) are allowed. For
|
|
# example, "project*2015" will return projects with names like "project June
|
|
# 2015", "project April 2015", or simply "project 2015". Most of the searches
|
|
# also add wildcards implicitly at the start and the end of the search string.
|
|
# For example, a search string of "project" will match projects with name "my
|
|
# project", "project 2015", or simply "project".
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::ProjectsListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::ProjectsListResponse]
|
|
#
|
|
# @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_projects(profile_id, advertiser_ids: nil, ids: nil, max_results: nil, page_token: nil, search_string: nil, sort_field: nil, sort_order: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/projects', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::ProjectsListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::ProjectsListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['advertiserIds'] = advertiser_ids unless advertiser_ids.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['searchString'] = search_string unless search_string.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of regions.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::RegionsListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::RegionsListResponse]
|
|
#
|
|
# @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_regions(profile_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/regions', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::RegionsListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::RegionsListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one remarketing list share by remarketing list ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] remarketing_list_id
|
|
# Remarketing list ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::RemarketingListShare] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::RemarketingListShare]
|
|
#
|
|
# @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_remarketing_list_share(profile_id, remarketing_list_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/remarketingListShares/{remarketingListId}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::RemarketingListShare::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::RemarketingListShare
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['remarketingListId'] = remarketing_list_id unless remarketing_list_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing remarketing list share. This method supports patch
|
|
# semantics.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] remarketing_list_id
|
|
# Remarketing list ID.
|
|
# @param [Google::Apis::DfareportingV2_8::RemarketingListShare] remarketing_list_share_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::RemarketingListShare] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::RemarketingListShare]
|
|
#
|
|
# @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_remarketing_list_share(profile_id, remarketing_list_id, remarketing_list_share_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'userprofiles/{profileId}/remarketingListShares', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::RemarketingListShare::Representation
|
|
command.request_object = remarketing_list_share_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::RemarketingListShare::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::RemarketingListShare
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['remarketingListId'] = remarketing_list_id unless remarketing_list_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing remarketing list share.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::RemarketingListShare] remarketing_list_share_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::RemarketingListShare] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::RemarketingListShare]
|
|
#
|
|
# @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 update_remarketing_list_share(profile_id, remarketing_list_share_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:put, 'userprofiles/{profileId}/remarketingListShares', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::RemarketingListShare::Representation
|
|
command.request_object = remarketing_list_share_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::RemarketingListShare::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::RemarketingListShare
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one remarketing list by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Remarketing list ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::RemarketingList] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::RemarketingList]
|
|
#
|
|
# @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_remarketing_list(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/remarketingLists/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::RemarketingList::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::RemarketingList
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Inserts a new remarketing list.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::RemarketingList] remarketing_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::RemarketingList] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::RemarketingList]
|
|
#
|
|
# @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 insert_remarketing_list(profile_id, remarketing_list_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/remarketingLists', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::RemarketingList::Representation
|
|
command.request_object = remarketing_list_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::RemarketingList::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::RemarketingList
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of remarketing lists, possibly filtered. This method supports
|
|
# paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] advertiser_id
|
|
# Select only remarketing lists owned by this advertiser.
|
|
# @param [Boolean] active
|
|
# Select only active or only inactive remarketing lists.
|
|
# @param [Fixnum] floodlight_activity_id
|
|
# Select only remarketing lists that have this floodlight activity ID.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] name
|
|
# Allows searching for objects by name or ID. Wildcards (*) are allowed. For
|
|
# example, "remarketing list*2015" will return objects with names like "
|
|
# remarketing list June 2015", "remarketing list April 2015", or simply "
|
|
# remarketing list 2015". Most of the searches also add wildcards implicitly at
|
|
# the start and the end of the search string. For example, a search string of "
|
|
# remarketing list" will match objects with name "my remarketing list", "
|
|
# remarketing list 2015", or simply "remarketing list".
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::RemarketingListsListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::RemarketingListsListResponse]
|
|
#
|
|
# @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_remarketing_lists(profile_id, advertiser_id, active: nil, floodlight_activity_id: nil, max_results: nil, name: nil, page_token: nil, sort_field: nil, sort_order: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/remarketingLists', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::RemarketingListsListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::RemarketingListsListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['active'] = active unless active.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['floodlightActivityId'] = floodlight_activity_id unless floodlight_activity_id.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['name'] = name unless name.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing remarketing list. This method supports patch semantics.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Remarketing list ID.
|
|
# @param [Google::Apis::DfareportingV2_8::RemarketingList] remarketing_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::RemarketingList] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::RemarketingList]
|
|
#
|
|
# @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_remarketing_list(profile_id, id, remarketing_list_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'userprofiles/{profileId}/remarketingLists', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::RemarketingList::Representation
|
|
command.request_object = remarketing_list_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::RemarketingList::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::RemarketingList
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing remarketing list.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::RemarketingList] remarketing_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::RemarketingList] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::RemarketingList]
|
|
#
|
|
# @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 update_remarketing_list(profile_id, remarketing_list_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:put, 'userprofiles/{profileId}/remarketingLists', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::RemarketingList::Representation
|
|
command.request_object = remarketing_list_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::RemarketingList::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::RemarketingList
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Deletes a report by its ID.
|
|
# @param [Fixnum] profile_id
|
|
# The DFA user profile ID.
|
|
# @param [Fixnum] report_id
|
|
# The ID of the report.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [NilClass] No result returned for this method
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [void]
|
|
#
|
|
# @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_report(profile_id, report_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:delete, 'userprofiles/{profileId}/reports/{reportId}', options)
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['reportId'] = report_id unless report_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a report by its ID.
|
|
# @param [Fixnum] profile_id
|
|
# The DFA user profile ID.
|
|
# @param [Fixnum] report_id
|
|
# The ID of the report.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Report] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::Report]
|
|
#
|
|
# @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_report(profile_id, report_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/reports/{reportId}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Report::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Report
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['reportId'] = report_id unless report_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Creates a report.
|
|
# @param [Fixnum] profile_id
|
|
# The DFA user profile ID.
|
|
# @param [Google::Apis::DfareportingV2_8::Report] report_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Report] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::Report]
|
|
#
|
|
# @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 insert_report(profile_id, report_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/reports', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::Report::Representation
|
|
command.request_object = report_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Report::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Report
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves list of reports.
|
|
# @param [Fixnum] profile_id
|
|
# The DFA user profile ID.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] page_token
|
|
# The value of the nextToken from the previous result page.
|
|
# @param [String] scope
|
|
# The scope that defines which results are returned.
|
|
# @param [String] sort_field
|
|
# The field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::ReportList] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::ReportList]
|
|
#
|
|
# @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_reports(profile_id, max_results: nil, page_token: nil, scope: nil, sort_field: nil, sort_order: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/reports', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::ReportList::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::ReportList
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['scope'] = scope unless scope.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates a report. This method supports patch semantics.
|
|
# @param [Fixnum] profile_id
|
|
# The DFA user profile ID.
|
|
# @param [Fixnum] report_id
|
|
# The ID of the report.
|
|
# @param [Google::Apis::DfareportingV2_8::Report] report_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Report] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::Report]
|
|
#
|
|
# @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_report(profile_id, report_id, report_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'userprofiles/{profileId}/reports/{reportId}', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::Report::Representation
|
|
command.request_object = report_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Report::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Report
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['reportId'] = report_id unless report_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Runs a report.
|
|
# @param [Fixnum] profile_id
|
|
# The DFA profile ID.
|
|
# @param [Fixnum] report_id
|
|
# The ID of the report.
|
|
# @param [Boolean] synchronous
|
|
# If set and true, tries to run the report synchronously.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::File] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::File]
|
|
#
|
|
# @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 run_report(profile_id, report_id, synchronous: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/reports/{reportId}/run', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::File::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::File
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['reportId'] = report_id unless report_id.nil?
|
|
command.query['synchronous'] = synchronous unless synchronous.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates a report.
|
|
# @param [Fixnum] profile_id
|
|
# The DFA user profile ID.
|
|
# @param [Fixnum] report_id
|
|
# The ID of the report.
|
|
# @param [Google::Apis::DfareportingV2_8::Report] report_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Report] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::Report]
|
|
#
|
|
# @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 update_report(profile_id, report_id, report_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:put, 'userprofiles/{profileId}/reports/{reportId}', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::Report::Representation
|
|
command.request_object = report_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Report::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Report
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['reportId'] = report_id unless report_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Returns the fields that are compatible to be selected in the respective
|
|
# sections of a report criteria, given the fields already selected in the input
|
|
# report and user permissions.
|
|
# @param [Fixnum] profile_id
|
|
# The DFA user profile ID.
|
|
# @param [Google::Apis::DfareportingV2_8::Report] report_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::CompatibleFields] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::CompatibleFields]
|
|
#
|
|
# @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 query_report_compatible_field(profile_id, report_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/reports/compatiblefields/query', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::Report::Representation
|
|
command.request_object = report_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::CompatibleFields::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::CompatibleFields
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a report file. This method supports media download.
|
|
# @param [Fixnum] profile_id
|
|
# The DFA profile ID.
|
|
# @param [Fixnum] report_id
|
|
# The ID of the report.
|
|
# @param [Fixnum] file_id
|
|
# The ID of the report file.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @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::DfareportingV2_8::File] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::File]
|
|
#
|
|
# @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_report_file(profile_id, report_id, file_id, fields: nil, quota_user: nil, user_ip: nil, download_dest: nil, options: nil, &block)
|
|
if download_dest.nil?
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/reports/{reportId}/files/{fileId}', options)
|
|
else
|
|
command = make_download_command(:get, 'userprofiles/{profileId}/reports/{reportId}/files/{fileId}', options)
|
|
command.download_dest = download_dest
|
|
end
|
|
command.response_representation = Google::Apis::DfareportingV2_8::File::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::File
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['reportId'] = report_id unless report_id.nil?
|
|
command.params['fileId'] = file_id unless file_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists files for a report.
|
|
# @param [Fixnum] profile_id
|
|
# The DFA profile ID.
|
|
# @param [Fixnum] report_id
|
|
# The ID of the parent report.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] page_token
|
|
# The value of the nextToken from the previous result page.
|
|
# @param [String] sort_field
|
|
# The field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::FileList] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::FileList]
|
|
#
|
|
# @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_report_files(profile_id, report_id, max_results: nil, page_token: nil, sort_field: nil, sort_order: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/reports/{reportId}/files', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::FileList::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::FileList
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['reportId'] = report_id unless report_id.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one site by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Site ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Site] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::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 get_site(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/sites/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Site::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Site
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Inserts a new site.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::Site] site_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Site] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::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 insert_site(profile_id, site_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/sites', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::Site::Representation
|
|
command.request_object = site_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Site::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Site
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of sites, possibly filtered. This method supports paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Boolean] accepts_in_stream_video_placements
|
|
# This search filter is no longer supported and will have no effect on the
|
|
# results returned.
|
|
# @param [Boolean] accepts_interstitial_placements
|
|
# This search filter is no longer supported and will have no effect on the
|
|
# results returned.
|
|
# @param [Boolean] accepts_publisher_paid_placements
|
|
# Select only sites that accept publisher paid placements.
|
|
# @param [Boolean] ad_words_site
|
|
# Select only AdWords sites.
|
|
# @param [Boolean] approved
|
|
# Select only approved sites.
|
|
# @param [Array<Fixnum>, Fixnum] campaign_ids
|
|
# Select only sites with these campaign IDs.
|
|
# @param [Array<Fixnum>, Fixnum] directory_site_ids
|
|
# Select only sites with these directory site IDs.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only sites with these IDs.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [String] search_string
|
|
# Allows searching for objects by name, ID or keyName. Wildcards (*) are allowed.
|
|
# For example, "site*2015" will return objects with names like "site June 2015",
|
|
# "site April 2015", or simply "site 2015". Most of the searches also add
|
|
# wildcards implicitly at the start and the end of the search string. For
|
|
# example, a search string of "site" will match objects with name "my site", "
|
|
# site 2015", or simply "site".
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @param [Fixnum] subaccount_id
|
|
# Select only sites with this subaccount ID.
|
|
# @param [Boolean] unmapped_site
|
|
# Select only sites that have not been mapped to a directory site.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::SitesListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::SitesListResponse]
|
|
#
|
|
# @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_sites(profile_id, accepts_in_stream_video_placements: nil, accepts_interstitial_placements: nil, accepts_publisher_paid_placements: nil, ad_words_site: nil, approved: nil, campaign_ids: nil, directory_site_ids: nil, ids: nil, max_results: nil, page_token: nil, search_string: nil, sort_field: nil, sort_order: nil, subaccount_id: nil, unmapped_site: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/sites', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::SitesListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::SitesListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['acceptsInStreamVideoPlacements'] = accepts_in_stream_video_placements unless accepts_in_stream_video_placements.nil?
|
|
command.query['acceptsInterstitialPlacements'] = accepts_interstitial_placements unless accepts_interstitial_placements.nil?
|
|
command.query['acceptsPublisherPaidPlacements'] = accepts_publisher_paid_placements unless accepts_publisher_paid_placements.nil?
|
|
command.query['adWordsSite'] = ad_words_site unless ad_words_site.nil?
|
|
command.query['approved'] = approved unless approved.nil?
|
|
command.query['campaignIds'] = campaign_ids unless campaign_ids.nil?
|
|
command.query['directorySiteIds'] = directory_site_ids unless directory_site_ids.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['searchString'] = search_string unless search_string.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['subaccountId'] = subaccount_id unless subaccount_id.nil?
|
|
command.query['unmappedSite'] = unmapped_site unless unmapped_site.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing site. This method supports patch semantics.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Site ID.
|
|
# @param [Google::Apis::DfareportingV2_8::Site] site_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Site] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::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 patch_site(profile_id, id, site_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'userprofiles/{profileId}/sites', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::Site::Representation
|
|
command.request_object = site_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Site::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Site
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing site.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::Site] site_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Site] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::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 update_site(profile_id, site_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:put, 'userprofiles/{profileId}/sites', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::Site::Representation
|
|
command.request_object = site_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Site::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Site
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one size by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Size ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Size] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::Size]
|
|
#
|
|
# @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_size(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/sizes/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Size::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Size
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Inserts a new size.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::Size] size_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Size] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::Size]
|
|
#
|
|
# @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 insert_size(profile_id, size_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/sizes', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::Size::Representation
|
|
command.request_object = size_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Size::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Size
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of sizes, possibly filtered.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] height
|
|
# Select only sizes with this height.
|
|
# @param [Boolean] iab_standard
|
|
# Select only IAB standard sizes.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only sizes with these IDs.
|
|
# @param [Fixnum] width
|
|
# Select only sizes with this width.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::SizesListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::SizesListResponse]
|
|
#
|
|
# @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_sizes(profile_id, height: nil, iab_standard: nil, ids: nil, width: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/sizes', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::SizesListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::SizesListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['height'] = height unless height.nil?
|
|
command.query['iabStandard'] = iab_standard unless iab_standard.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['width'] = width unless width.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one subaccount by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Subaccount ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Subaccount] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::Subaccount]
|
|
#
|
|
# @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_subaccount(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/subaccounts/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Subaccount::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Subaccount
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Inserts a new subaccount.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::Subaccount] subaccount_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Subaccount] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::Subaccount]
|
|
#
|
|
# @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 insert_subaccount(profile_id, subaccount_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/subaccounts', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::Subaccount::Representation
|
|
command.request_object = subaccount_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Subaccount::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Subaccount
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets a list of subaccounts, possibly filtered. This method supports paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only subaccounts with these IDs.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [String] search_string
|
|
# Allows searching for objects by name or ID. Wildcards (*) are allowed. For
|
|
# example, "subaccount*2015" will return objects with names like "subaccount
|
|
# June 2015", "subaccount April 2015", or simply "subaccount 2015". Most of the
|
|
# searches also add wildcards implicitly at the start and the end of the search
|
|
# string. For example, a search string of "subaccount" will match objects with
|
|
# name "my subaccount", "subaccount 2015", or simply "subaccount".
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::SubaccountsListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::SubaccountsListResponse]
|
|
#
|
|
# @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_subaccounts(profile_id, ids: nil, max_results: nil, page_token: nil, search_string: nil, sort_field: nil, sort_order: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/subaccounts', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::SubaccountsListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::SubaccountsListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['searchString'] = search_string unless search_string.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing subaccount. This method supports patch semantics.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Subaccount ID.
|
|
# @param [Google::Apis::DfareportingV2_8::Subaccount] subaccount_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Subaccount] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::Subaccount]
|
|
#
|
|
# @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_subaccount(profile_id, id, subaccount_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'userprofiles/{profileId}/subaccounts', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::Subaccount::Representation
|
|
command.request_object = subaccount_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Subaccount::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Subaccount
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing subaccount.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::Subaccount] subaccount_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::Subaccount] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::Subaccount]
|
|
#
|
|
# @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 update_subaccount(profile_id, subaccount_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:put, 'userprofiles/{profileId}/subaccounts', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::Subaccount::Representation
|
|
command.request_object = subaccount_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::Subaccount::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::Subaccount
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one remarketing list by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Remarketing list ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::TargetableRemarketingList] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::TargetableRemarketingList]
|
|
#
|
|
# @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_targetable_remarketing_list(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/targetableRemarketingLists/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::TargetableRemarketingList::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::TargetableRemarketingList
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of targetable remarketing lists, possibly filtered. This
|
|
# method supports paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] advertiser_id
|
|
# Select only targetable remarketing lists targetable by these advertisers.
|
|
# @param [Boolean] active
|
|
# Select only active or only inactive targetable remarketing lists.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] name
|
|
# Allows searching for objects by name or ID. Wildcards (*) are allowed. For
|
|
# example, "remarketing list*2015" will return objects with names like "
|
|
# remarketing list June 2015", "remarketing list April 2015", or simply "
|
|
# remarketing list 2015". Most of the searches also add wildcards implicitly at
|
|
# the start and the end of the search string. For example, a search string of "
|
|
# remarketing list" will match objects with name "my remarketing list", "
|
|
# remarketing list 2015", or simply "remarketing list".
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::TargetableRemarketingListsListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::TargetableRemarketingListsListResponse]
|
|
#
|
|
# @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_targetable_remarketing_lists(profile_id, advertiser_id, active: nil, max_results: nil, name: nil, page_token: nil, sort_field: nil, sort_order: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/targetableRemarketingLists', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::TargetableRemarketingListsListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::TargetableRemarketingListsListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['active'] = active unless active.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['name'] = name unless name.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one targeting template by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Targeting template ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::TargetingTemplate] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::TargetingTemplate]
|
|
#
|
|
# @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_template(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/targetingTemplates/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::TargetingTemplate::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::TargetingTemplate
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Inserts a new targeting template.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::TargetingTemplate] targeting_template_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::TargetingTemplate] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::TargetingTemplate]
|
|
#
|
|
# @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 insert_targeting_template(profile_id, targeting_template_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/targetingTemplates', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::TargetingTemplate::Representation
|
|
command.request_object = targeting_template_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::TargetingTemplate::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::TargetingTemplate
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of targeting templates, optionally filtered. This method
|
|
# supports paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] advertiser_id
|
|
# Select only targeting templates with this advertiser ID.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only targeting templates with these IDs.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [String] search_string
|
|
# Allows searching for objects by name or ID. Wildcards (*) are allowed. For
|
|
# example, "template*2015" will return objects with names like "template June
|
|
# 2015", "template April 2015", or simply "template 2015". Most of the searches
|
|
# also add wildcards implicitly at the start and the end of the search string.
|
|
# For example, a search string of "template" will match objects with name "my
|
|
# template", "template 2015", or simply "template".
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::TargetingTemplatesListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::TargetingTemplatesListResponse]
|
|
#
|
|
# @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_templates(profile_id, advertiser_id: nil, ids: nil, max_results: nil, page_token: nil, search_string: nil, sort_field: nil, sort_order: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/targetingTemplates', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::TargetingTemplatesListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::TargetingTemplatesListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['advertiserId'] = advertiser_id unless advertiser_id.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['searchString'] = search_string unless search_string.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing targeting template. This method supports patch semantics.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Targeting template ID.
|
|
# @param [Google::Apis::DfareportingV2_8::TargetingTemplate] targeting_template_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::TargetingTemplate] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::TargetingTemplate]
|
|
#
|
|
# @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_targeting_template(profile_id, id, targeting_template_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'userprofiles/{profileId}/targetingTemplates', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::TargetingTemplate::Representation
|
|
command.request_object = targeting_template_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::TargetingTemplate::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::TargetingTemplate
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing targeting template.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::TargetingTemplate] targeting_template_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::TargetingTemplate] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::TargetingTemplate]
|
|
#
|
|
# @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 update_targeting_template(profile_id, targeting_template_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:put, 'userprofiles/{profileId}/targetingTemplates', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::TargetingTemplate::Representation
|
|
command.request_object = targeting_template_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::TargetingTemplate::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::TargetingTemplate
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one user profile by ID.
|
|
# @param [Fixnum] profile_id
|
|
# The user profile ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::UserProfile] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::UserProfile]
|
|
#
|
|
# @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_profile(profile_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::UserProfile::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::UserProfile
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves list of user profiles for a user.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::UserProfileList] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::UserProfileList]
|
|
#
|
|
# @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_user_profiles(fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::UserProfileList::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::UserProfileList
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one user role permission group by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# User role permission group ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::UserRolePermissionGroup] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::UserRolePermissionGroup]
|
|
#
|
|
# @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_role_permission_group(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/userRolePermissionGroups/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::UserRolePermissionGroup::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::UserRolePermissionGroup
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets a list of all supported user role permission groups.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::UserRolePermissionGroupsListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::UserRolePermissionGroupsListResponse]
|
|
#
|
|
# @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_user_role_permission_groups(profile_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/userRolePermissionGroups', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::UserRolePermissionGroupsListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::UserRolePermissionGroupsListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one user role permission by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# User role permission ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::UserRolePermission] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::UserRolePermission]
|
|
#
|
|
# @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_role_permission(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/userRolePermissions/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::UserRolePermission::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::UserRolePermission
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets a list of user role permissions, possibly filtered.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only user role permissions with these IDs.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::UserRolePermissionsListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::UserRolePermissionsListResponse]
|
|
#
|
|
# @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_user_role_permissions(profile_id, ids: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/userRolePermissions', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::UserRolePermissionsListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::UserRolePermissionsListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Deletes an existing user role.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# User role ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [NilClass] No result returned for this method
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [void]
|
|
#
|
|
# @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_role(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:delete, 'userprofiles/{profileId}/userRoles/{id}', options)
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one user role by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# User role ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::UserRole] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::UserRole]
|
|
#
|
|
# @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_role(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/userRoles/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::UserRole::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::UserRole
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Inserts a new user role.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::UserRole] user_role_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::UserRole] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::UserRole]
|
|
#
|
|
# @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 insert_user_role(profile_id, user_role_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:post, 'userprofiles/{profileId}/userRoles', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::UserRole::Representation
|
|
command.request_object = user_role_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::UserRole::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::UserRole
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Retrieves a list of user roles, possibly filtered. This method supports paging.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Boolean] account_user_role_only
|
|
# Select only account level user roles not associated with any specific
|
|
# subaccount.
|
|
# @param [Array<Fixnum>, Fixnum] ids
|
|
# Select only user roles with the specified IDs.
|
|
# @param [Fixnum] max_results
|
|
# Maximum number of results to return.
|
|
# @param [String] page_token
|
|
# Value of the nextPageToken from the previous result page.
|
|
# @param [String] search_string
|
|
# Allows searching for objects by name or ID. Wildcards (*) are allowed. For
|
|
# example, "userrole*2015" will return objects with names like "userrole June
|
|
# 2015", "userrole April 2015", or simply "userrole 2015". Most of the searches
|
|
# also add wildcards implicitly at the start and the end of the search string.
|
|
# For example, a search string of "userrole" will match objects with name "my
|
|
# userrole", "userrole 2015", or simply "userrole".
|
|
# @param [String] sort_field
|
|
# Field by which to sort the list.
|
|
# @param [String] sort_order
|
|
# Order of sorted results.
|
|
# @param [Fixnum] subaccount_id
|
|
# Select only user roles that belong to this subaccount.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::UserRolesListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::UserRolesListResponse]
|
|
#
|
|
# @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_user_roles(profile_id, account_user_role_only: nil, ids: nil, max_results: nil, page_token: nil, search_string: nil, sort_field: nil, sort_order: nil, subaccount_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/userRoles', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::UserRolesListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::UserRolesListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['accountUserRoleOnly'] = account_user_role_only unless account_user_role_only.nil?
|
|
command.query['ids'] = ids unless ids.nil?
|
|
command.query['maxResults'] = max_results unless max_results.nil?
|
|
command.query['pageToken'] = page_token unless page_token.nil?
|
|
command.query['searchString'] = search_string unless search_string.nil?
|
|
command.query['sortField'] = sort_field unless sort_field.nil?
|
|
command.query['sortOrder'] = sort_order unless sort_order.nil?
|
|
command.query['subaccountId'] = subaccount_id unless subaccount_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing user role. This method supports patch semantics.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# User role ID.
|
|
# @param [Google::Apis::DfareportingV2_8::UserRole] user_role_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::UserRole] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::UserRole]
|
|
#
|
|
# @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_role(profile_id, id, user_role_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:patch, 'userprofiles/{profileId}/userRoles', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::UserRole::Representation
|
|
command.request_object = user_role_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::UserRole::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::UserRole
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Updates an existing user role.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Google::Apis::DfareportingV2_8::UserRole] user_role_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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::UserRole] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::UserRole]
|
|
#
|
|
# @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 update_user_role(profile_id, user_role_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:put, 'userprofiles/{profileId}/userRoles', options)
|
|
command.request_representation = Google::Apis::DfareportingV2_8::UserRole::Representation
|
|
command.request_object = user_role_object
|
|
command.response_representation = Google::Apis::DfareportingV2_8::UserRole::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::UserRole
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Gets one video format by ID.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @param [Fixnum] id
|
|
# Video format ID.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::VideoFormat] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::VideoFormat]
|
|
#
|
|
# @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_video_format(profile_id, id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/videoFormats/{id}', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::VideoFormat::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::VideoFormat
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.params['id'] = id unless id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
execute_or_queue_command(command, &block)
|
|
end
|
|
|
|
# Lists available video formats.
|
|
# @param [Fixnum] profile_id
|
|
# User profile ID associated with this request.
|
|
# @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.
|
|
# Overrides userIp if both are provided.
|
|
# @param [String] user_ip
|
|
# IP address of the site where the request originates. Use this if you want to
|
|
# enforce per-user limits.
|
|
# @param [Google::Apis::RequestOptions] options
|
|
# Request-specific options
|
|
#
|
|
# @yield [result, err] Result & error if block supplied
|
|
# @yieldparam result [Google::Apis::DfareportingV2_8::VideoFormatsListResponse] parsed result object
|
|
# @yieldparam err [StandardError] error object if request failed
|
|
#
|
|
# @return [Google::Apis::DfareportingV2_8::VideoFormatsListResponse]
|
|
#
|
|
# @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_video_formats(profile_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
|
|
command = make_simple_command(:get, 'userprofiles/{profileId}/videoFormats', options)
|
|
command.response_representation = Google::Apis::DfareportingV2_8::VideoFormatsListResponse::Representation
|
|
command.response_class = Google::Apis::DfareportingV2_8::VideoFormatsListResponse
|
|
command.params['profileId'] = profile_id unless profile_id.nil?
|
|
command.query['fields'] = fields unless fields.nil?
|
|
command.query['quotaUser'] = quota_user unless quota_user.nil?
|
|
command.query['userIp'] = user_ip unless user_ip.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?
|
|
command.query['userIp'] = user_ip unless user_ip.nil?
|
|
end
|
|
end
|
|
end
|
|
end
|
|
end
|