google-api-ruby-client/generated/google/apis/youtube_partner_v1/service.rb

3166 lines
202 KiB
Ruby
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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 YoutubePartnerV1
# Youtube Content ID API
#
# API for YouTube partners. To use this API YouTube CMS account is required.
#
# @example
# require 'google/apis/youtube_partner_v1'
#
# YoutubePartner = Google::Apis::YoutubePartnerV1 # Alias the module
# service = YoutubePartner::YouTubePartnerService.new
#
# @see https://developers.google.com/youtube/partner/
class YouTubePartnerService < 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/', 'youtube/partner/v1/')
end
# Insert an asset label for an owner.
# @param [Google::Apis::YoutubePartnerV1::AssetLabel] asset_label_object
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::AssetLabel] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::AssetLabel]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_asset_label(asset_label_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:post, 'assetLabels', options)
command.request_representation = Google::Apis::YoutubePartnerV1::AssetLabel::Representation
command.request_object = asset_label_object
command.response_representation = Google::Apis::YoutubePartnerV1::AssetLabel::Representation
command.response_class = Google::Apis::YoutubePartnerV1::AssetLabel
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 all asset labels for an owner.
# @param [String] label_prefix
# The labelPrefix parameter identifies the prefix of asset labels to retrieve.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] q
# The q parameter specifies the query string to use to filter search results.
# YouTube searches for the query string in the labelName field of asset labels.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::AssetLabelListResponse] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::AssetLabelListResponse]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_asset_labels(label_prefix: nil, on_behalf_of_content_owner: nil, q: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'assetLabels', options)
command.response_representation = Google::Apis::YoutubePartnerV1::AssetLabelListResponse::Representation
command.response_class = Google::Apis::YoutubePartnerV1::AssetLabelListResponse
command.query['labelPrefix'] = label_prefix unless label_prefix.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.nil?
command.query['q'] = q unless q.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 match policy assigned to the specified asset by the content
# owner associated with the authenticated user. This information is only
# accessible to an owner of the asset.
# @param [String] asset_id
# The assetId parameter specifies the YouTube asset ID of the asset for which
# you are retrieving the match policy.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::AssetMatchPolicy] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::AssetMatchPolicy]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_asset_match_policy(asset_id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'assets/{assetId}/matchPolicy', options)
command.response_representation = Google::Apis::YoutubePartnerV1::AssetMatchPolicy::Representation
command.response_class = Google::Apis::YoutubePartnerV1::AssetMatchPolicy
command.params['assetId'] = asset_id unless asset_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 the asset's match policy. If an asset has multiple owners, each owner
# may set its own match policy for the asset. YouTube then computes the match
# policy that is actually applied for the asset based on the territories where
# each owner owns the asset. This method supports patch semantics.
# @param [String] asset_id
# The assetId parameter specifies the YouTube asset ID of the asset for which
# you are retrieving the match policy.
# @param [Google::Apis::YoutubePartnerV1::AssetMatchPolicy] asset_match_policy_object
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::AssetMatchPolicy] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::AssetMatchPolicy]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_asset_match_policy(asset_id, asset_match_policy_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:patch, 'assets/{assetId}/matchPolicy', options)
command.request_representation = Google::Apis::YoutubePartnerV1::AssetMatchPolicy::Representation
command.request_object = asset_match_policy_object
command.response_representation = Google::Apis::YoutubePartnerV1::AssetMatchPolicy::Representation
command.response_class = Google::Apis::YoutubePartnerV1::AssetMatchPolicy
command.params['assetId'] = asset_id unless asset_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 the asset's match policy. If an asset has multiple owners, each owner
# may set its own match policy for the asset. YouTube then computes the match
# policy that is actually applied for the asset based on the territories where
# each owner owns the asset.
# @param [String] asset_id
# The assetId parameter specifies the YouTube asset ID of the asset for which
# you are retrieving the match policy.
# @param [Google::Apis::YoutubePartnerV1::AssetMatchPolicy] asset_match_policy_object
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::AssetMatchPolicy] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::AssetMatchPolicy]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_asset_match_policy(asset_id, asset_match_policy_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:put, 'assets/{assetId}/matchPolicy', options)
command.request_representation = Google::Apis::YoutubePartnerV1::AssetMatchPolicy::Representation
command.request_object = asset_match_policy_object
command.response_representation = Google::Apis::YoutubePartnerV1::AssetMatchPolicy::Representation
command.response_class = Google::Apis::YoutubePartnerV1::AssetMatchPolicy
command.params['assetId'] = asset_id unless asset_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 relationship between two assets.
# @param [String] asset_relationship_id
# The assetRelationshipId parameter specifies a value that uniquely identifies
# the relationship you are deleting.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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_asset_relationship(asset_relationship_id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:delete, 'assetRelationships/{assetRelationshipId}', options)
command.params['assetRelationshipId'] = asset_relationship_id unless asset_relationship_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 relationship that links two assets.
# @param [Google::Apis::YoutubePartnerV1::AssetRelationship] asset_relationship_object
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::AssetRelationship] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::AssetRelationship]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_asset_relationship(asset_relationship_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:post, 'assetRelationships', options)
command.request_representation = Google::Apis::YoutubePartnerV1::AssetRelationship::Representation
command.request_object = asset_relationship_object
command.response_representation = Google::Apis::YoutubePartnerV1::AssetRelationship::Representation
command.response_class = Google::Apis::YoutubePartnerV1::AssetRelationship
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 relationships for a given asset. The list contains
# relationships where the specified asset is either the parent (embedding) or
# child (embedded) asset in the relationship.
# @param [String] asset_id
# The assetId parameter specifies the asset ID of the asset for which you are
# retrieving relationships.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] page_token
# The pageToken parameter specifies a token that identifies a particular page of
# results to return. Set this parameter to the value of the nextPageToken value
# from the previous API response to retrieve the next page of search 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::YoutubePartnerV1::AssetRelationshipListResponse] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::AssetRelationshipListResponse]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_asset_relationships(asset_id, on_behalf_of_content_owner: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'assetRelationships', options)
command.response_representation = Google::Apis::YoutubePartnerV1::AssetRelationshipListResponse::Representation
command.response_class = Google::Apis::YoutubePartnerV1::AssetRelationshipListResponse
command.query['assetId'] = asset_id unless asset_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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
# Searches for assets based on asset metadata. The method can retrieve all
# assets or only assets owned by the content owner. This method mimics the
# functionality of the advanced search feature on the Assets page in CMS.
# @param [DateTime] created_after
# The createdAfter parameter restricts the set of returned assets to ones
# originally created on or after the specified datetime. For example: 2015-01-
# 29T23:00:00Z
# @param [DateTime] created_before
# The createdBefore parameter restricts the set of returned assets to ones
# originally created on or before the specified datetime. For example: 2015-01-
# 29T23:00:00Z
# @param [Boolean] has_conflicts
# The hasConflicts parameter enables you to only retrieve assets that have
# ownership conflicts. The only valid value is true. Setting the parameter value
# to false does not affect the results.
# @param [Boolean] include_any_providedlabel
# If includeAnyProvidedlabel parameter is set to true, will search for assets
# that contain any of the provided labels; else will search for assets that
# contain all the provided labels.
# @param [String] isrcs
# A comma-separated list of up to 50 ISRCs. If you specify a value for this
# parameter, the API server ignores any values set for the following parameters:
# q, includeAnyProvidedLabel, hasConflicts, labels, metadataSearchFields, sort,
# and type.
# @param [String] labels
# The labels parameter specifies the assets with certain asset labels that you
# want to retrieve. The parameter value is a comma-separated list of asset
# labels.
# @param [String] metadata_search_fields
# The metadataSearchField parameter specifies which metadata fields to search by.
# It is a comma-separated list of metadata field and value pairs connected by
# colon(:). For example: customId:my_custom_id,artist:Dandexx
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] ownership_restriction
# The ownershipRestriction parameter specifies the ownership filtering option
# for the search. By default the search is performed in the assets owned by
# currently authenticated user only.
# @param [String] page_token
# The pageToken parameter specifies a token that identifies a particular page of
# results to return. Set this parameter to the value of the nextPageToken value
# from the previous API response to retrieve the next page of search results.
# @param [String] q
# YouTube searches within the id, type, and customId fields for all assets as
# well as in numerous other metadata fields such as actor, album, director,
# isrc, and tmsId that vary for different types of assets (movies, music
# videos, etc.).
# @param [String] sort
# The sort parameter specifies how the search results should be sorted. Note
# that results are always sorted in descending order.
# @param [String] type
# The type parameter specifies the types of assets that you want to retrieve.
# The parameter value is a comma-separated list of asset 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::YoutubePartnerV1::AssetSearchResponse] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::AssetSearchResponse]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_asset_searches(created_after: nil, created_before: nil, has_conflicts: nil, include_any_providedlabel: nil, isrcs: nil, labels: nil, metadata_search_fields: nil, on_behalf_of_content_owner: nil, ownership_restriction: nil, page_token: nil, q: nil, sort: nil, type: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'assetSearch', options)
command.response_representation = Google::Apis::YoutubePartnerV1::AssetSearchResponse::Representation
command.response_class = Google::Apis::YoutubePartnerV1::AssetSearchResponse
command.query['createdAfter'] = created_after unless created_after.nil?
command.query['createdBefore'] = created_before unless created_before.nil?
command.query['hasConflicts'] = has_conflicts unless has_conflicts.nil?
command.query['includeAnyProvidedlabel'] = include_any_providedlabel unless include_any_providedlabel.nil?
command.query['isrcs'] = isrcs unless isrcs.nil?
command.query['labels'] = labels unless labels.nil?
command.query['metadataSearchFields'] = metadata_search_fields unless metadata_search_fields.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.nil?
command.query['ownershipRestriction'] = ownership_restriction unless ownership_restriction.nil?
command.query['pageToken'] = page_token unless page_token.nil?
command.query['q'] = q unless q.nil?
command.query['sort'] = sort unless sort.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
# Retrieves the metadata for the specified asset. Note that if the request
# identifies an asset that has been merged with another asset, meaning that
# YouTube identified the requested asset as a duplicate, then the request
# retrieves the merged, or synthesized, asset.
# @param [String] asset_id
# The assetId parameter specifies the YouTube asset ID of the asset being
# retrieved.
# @param [String] fetch_match_policy
# The fetchMatchPolicy parameter specifies the version of the asset's match
# policy that should be returned in the API response.
# @param [String] fetch_metadata
# The fetchMetadata parameter specifies the version of the asset's metadata that
# should be returned in the API response. In some cases, YouTube receives
# metadata for an asset from multiple sources, such as when different partners
# own the asset in different territories.
# @param [String] fetch_ownership
# The fetchOwnership parameter specifies the version of the asset's ownership
# data that should be returned in the API response. As with asset metadata,
# YouTube can receive asset ownership data from multiple sources.
# @param [Boolean] fetch_ownership_conflicts
# The fetchOwnershipConflicts parameter allows you to retrieve information about
# ownership conflicts.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::Asset] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::Asset]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_asset(asset_id, fetch_match_policy: nil, fetch_metadata: nil, fetch_ownership: nil, fetch_ownership_conflicts: nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'assets/{assetId}', options)
command.response_representation = Google::Apis::YoutubePartnerV1::Asset::Representation
command.response_class = Google::Apis::YoutubePartnerV1::Asset
command.params['assetId'] = asset_id unless asset_id.nil?
command.query['fetchMatchPolicy'] = fetch_match_policy unless fetch_match_policy.nil?
command.query['fetchMetadata'] = fetch_metadata unless fetch_metadata.nil?
command.query['fetchOwnership'] = fetch_ownership unless fetch_ownership.nil?
command.query['fetchOwnershipConflicts'] = fetch_ownership_conflicts unless fetch_ownership_conflicts.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 an asset with the specified metadata. After inserting an asset, you
# can set its ownership data and match policy.
# @param [Google::Apis::YoutubePartnerV1::Asset] asset_object
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::Asset] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::Asset]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_asset(asset_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:post, 'assets', options)
command.request_representation = Google::Apis::YoutubePartnerV1::Asset::Representation
command.request_object = asset_object
command.response_representation = Google::Apis::YoutubePartnerV1::Asset::Representation
command.response_class = Google::Apis::YoutubePartnerV1::Asset
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 assets based on asset metadata. The method can retrieve
# all assets or only assets owned by the content owner.
# Note that in cases where duplicate assets have been merged, the API response
# only contains the synthesized asset. (It does not contain the constituent
# assets that were merged into the synthesized asset.)
# @param [String] id
# The id parameter specifies a comma-separated list of YouTube Asset IDs that
# identify the assets you want to retrieve. As noted in the method description,
# if you try to retrieve an asset that YouTube identified as a duplicate and
# merged with another asset, the API response only returns the synthesized asset.
# In that case, the aliasId property in the asset resource specifies a list of
# other asset IDs that can be used to identify that asset.
# Also note that the API response does not contain duplicates. As such, if your
# request identifies three asset IDs, and all of those have been merged into a
# single asset, then the API response identifies one matching asset.
# @param [String] fetch_match_policy
# The fetchMatchPolicy parameter specifies the version of the asset's match
# policy that should be returned in the API response.
# @param [String] fetch_metadata
# The fetchMetadata parameter specifies the version of the asset's metadata that
# should be returned in the API response. In some cases, YouTube receives
# metadata for an asset from multiple sources, such as when different partners
# own the asset in different territories.
# @param [String] fetch_ownership
# The fetchOwnership parameter specifies the version of the asset's ownership
# data that should be returned in the API response. As with asset metadata,
# YouTube can receive asset ownership data from multiple sources.
# @param [Boolean] fetch_ownership_conflicts
# The fetchOwnershipConflicts parameter allows you to retrieve information about
# ownership conflicts.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::AssetListResponse] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::AssetListResponse]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_assets(id, fetch_match_policy: nil, fetch_metadata: nil, fetch_ownership: nil, fetch_ownership_conflicts: nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'assets', options)
command.response_representation = Google::Apis::YoutubePartnerV1::AssetListResponse::Representation
command.response_class = Google::Apis::YoutubePartnerV1::AssetListResponse
command.query['fetchMatchPolicy'] = fetch_match_policy unless fetch_match_policy.nil?
command.query['fetchMetadata'] = fetch_metadata unless fetch_metadata.nil?
command.query['fetchOwnership'] = fetch_ownership unless fetch_ownership.nil?
command.query['fetchOwnershipConflicts'] = fetch_ownership_conflicts unless fetch_ownership_conflicts.nil?
command.query['id'] = id unless id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 the metadata for the specified asset. This method supports patch
# semantics.
# @param [String] asset_id
# The assetId parameter specifies the YouTube asset ID of the asset being
# updated.
# @param [Google::Apis::YoutubePartnerV1::Asset] asset_object
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::Asset] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::Asset]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_asset(asset_id, asset_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:patch, 'assets/{assetId}', options)
command.request_representation = Google::Apis::YoutubePartnerV1::Asset::Representation
command.request_object = asset_object
command.response_representation = Google::Apis::YoutubePartnerV1::Asset::Representation
command.response_class = Google::Apis::YoutubePartnerV1::Asset
command.params['assetId'] = asset_id unless asset_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 the metadata for the specified asset.
# @param [String] asset_id
# The assetId parameter specifies the YouTube asset ID of the asset being
# updated.
# @param [Google::Apis::YoutubePartnerV1::Asset] asset_object
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::Asset] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::Asset]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_asset(asset_id, asset_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:put, 'assets/{assetId}', options)
command.request_representation = Google::Apis::YoutubePartnerV1::Asset::Representation
command.request_object = asset_object
command.response_representation = Google::Apis::YoutubePartnerV1::Asset::Representation
command.response_class = Google::Apis::YoutubePartnerV1::Asset
command.params['assetId'] = asset_id unless asset_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 specified campaign for an owner.
# @param [String] campaign_id
# The campaignId parameter specifies the YouTube campaign ID of the campaign
# being deleted.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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_campaign(campaign_id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:delete, 'campaigns/{campaignId}', options)
command.params['campaignId'] = campaign_id unless campaign_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 particular campaign for an owner.
# @param [String] campaign_id
# The campaignId parameter specifies the YouTube campaign ID of the campaign
# being retrieved.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::Campaign] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::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(campaign_id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'campaigns/{campaignId}', options)
command.response_representation = Google::Apis::YoutubePartnerV1::Campaign::Representation
command.response_class = Google::Apis::YoutubePartnerV1::Campaign
command.params['campaignId'] = campaign_id unless campaign_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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
# Insert a new campaign for an owner using the specified campaign data.
# @param [Google::Apis::YoutubePartnerV1::Campaign] campaign_object
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::Campaign] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::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(campaign_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:post, 'campaigns', options)
command.request_representation = Google::Apis::YoutubePartnerV1::Campaign::Representation
command.request_object = campaign_object
command.response_representation = Google::Apis::YoutubePartnerV1::Campaign::Representation
command.response_class = Google::Apis::YoutubePartnerV1::Campaign
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 for an owner.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] page_token
# The pageToken parameter specifies a token that identifies a particular page of
# results to return. For example, set this parameter to the value of the
# nextPageToken value from the previous API response to retrieve the next page
# of search 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::YoutubePartnerV1::CampaignList] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::CampaignList]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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(on_behalf_of_content_owner: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'campaigns', options)
command.response_representation = Google::Apis::YoutubePartnerV1::CampaignList::Representation
command.response_class = Google::Apis::YoutubePartnerV1::CampaignList
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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
# Update the data for a specific campaign. This method supports patch semantics.
# @param [String] campaign_id
# The campaignId parameter specifies the YouTube campaign ID of the campaign
# being retrieved.
# @param [Google::Apis::YoutubePartnerV1::Campaign] campaign_object
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::Campaign] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::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(campaign_id, campaign_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:patch, 'campaigns/{campaignId}', options)
command.request_representation = Google::Apis::YoutubePartnerV1::Campaign::Representation
command.request_object = campaign_object
command.response_representation = Google::Apis::YoutubePartnerV1::Campaign::Representation
command.response_class = Google::Apis::YoutubePartnerV1::Campaign
command.params['campaignId'] = campaign_id unless campaign_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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
# Update the data for a specific campaign.
# @param [String] campaign_id
# The campaignId parameter specifies the YouTube campaign ID of the campaign
# being retrieved.
# @param [Google::Apis::YoutubePartnerV1::Campaign] campaign_object
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::Campaign] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::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(campaign_id, campaign_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:put, 'campaigns/{campaignId}', options)
command.request_representation = Google::Apis::YoutubePartnerV1::Campaign::Representation
command.request_object = campaign_object
command.response_representation = Google::Apis::YoutubePartnerV1::Campaign::Representation
command.response_class = Google::Apis::YoutubePartnerV1::Campaign
command.params['campaignId'] = campaign_id unless campaign_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 claim history for a specified claim.
# @param [String] claim_id
# The claimId parameter specifies the YouTube claim ID of the claim for which
# you are retrieving the claim history.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::ClaimHistory] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::ClaimHistory]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_claim_history(claim_id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'claimHistory/{claimId}', options)
command.response_representation = Google::Apis::YoutubePartnerV1::ClaimHistory::Representation
command.response_class = Google::Apis::YoutubePartnerV1::ClaimHistory
command.params['claimId'] = claim_id unless claim_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 claims that match the search criteria. You can search for
# claims that are associated with a specific asset or video or that match a
# specified query string.
# @param [String] asset_id
# The assetId parameter specifies the YouTube asset ID of the asset for which
# you are retrieving claims.
# @param [String] content_type
# The contentType parameter specifies the content type of claims that you want
# to retrieve.
# @param [DateTime] created_after
# The createdAfter parameter allows you to restrict the set of returned claims
# to ones originally created after the specified date.
# @param [DateTime] created_before
# The createdBefore parameter allows you to restrict the set of returned claims
# to ones originally created before the specified date.
# @param [String] inactive_reasons
# The inactiveReasons parameter allows you to specify what kind of inactive
# claims you want to find based on the reasons why the claims became inactive.
# @param [Boolean] include_third_party_claims
# Used along with the videoId parameter this parameter determines whether or not
# to include third party claims in the search results.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] origin
# The origin parameter specifies the origins you want to find claims for. It is
# a comma-separated list of origin values.
# @param [String] page_token
# The pageToken parameter specifies a token that identifies a particular page of
# results to return. For example, set this parameter to the value of the
# nextPageToken value from the previous API response to retrieve the next page
# of search results.
# @param [Boolean] partner_uploaded
# The partnerUploaded parameter specifies whether you want to filter your search
# results to only partner uploaded or non partner uploaded claims.
# @param [String] q
# The q parameter specifies the query string to use to filter search results.
# YouTube searches for the query string in the following claim fields:
# video_title, video_keywords, user_name, isrc, iswc, grid, custom_id, and in
# the content owner's email address.
# @param [String] reference_id
# The referenceId parameter specifies the YouTube reference ID of the reference
# for which you are retrieving claims.
# @param [String] sort
# The sort parameter specifies the method that will be used to order resources
# in the API response. The default value is date. However, if the status
# parameter value is either appealed, disputed, pending, potential, or
# routedForReview, then results will be sorted by the time that the claim review
# period expires.
# @param [String] status
# The status parameter restricts your results to only claims in the specified
# status.
# @param [String] video_id
# The videoId parameter specifies comma-separated list of YouTube video IDs for
# which you are retrieving claims.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::ClaimSearchResponse] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::ClaimSearchResponse]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_claim_searches(asset_id: nil, content_type: nil, created_after: nil, created_before: nil, inactive_reasons: nil, include_third_party_claims: nil, on_behalf_of_content_owner: nil, origin: nil, page_token: nil, partner_uploaded: nil, q: nil, reference_id: nil, sort: nil, status: nil, video_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'claimSearch', options)
command.response_representation = Google::Apis::YoutubePartnerV1::ClaimSearchResponse::Representation
command.response_class = Google::Apis::YoutubePartnerV1::ClaimSearchResponse
command.query['assetId'] = asset_id unless asset_id.nil?
command.query['contentType'] = content_type unless content_type.nil?
command.query['createdAfter'] = created_after unless created_after.nil?
command.query['createdBefore'] = created_before unless created_before.nil?
command.query['inactiveReasons'] = inactive_reasons unless inactive_reasons.nil?
command.query['includeThirdPartyClaims'] = include_third_party_claims unless include_third_party_claims.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.nil?
command.query['origin'] = origin unless origin.nil?
command.query['pageToken'] = page_token unless page_token.nil?
command.query['partnerUploaded'] = partner_uploaded unless partner_uploaded.nil?
command.query['q'] = q unless q.nil?
command.query['referenceId'] = reference_id unless reference_id.nil?
command.query['sort'] = sort unless sort.nil?
command.query['status'] = status unless status.nil?
command.query['videoId'] = video_id unless video_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 specific claim by ID.
# @param [String] claim_id
# The claimId parameter specifies the claim ID of the claim being retrieved.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::Claim] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::Claim]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_claim(claim_id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'claims/{claimId}', options)
command.response_representation = Google::Apis::YoutubePartnerV1::Claim::Representation
command.response_class = Google::Apis::YoutubePartnerV1::Claim
command.params['claimId'] = claim_id unless claim_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 claim. The video being claimed must have been uploaded to a channel
# associated with the same content owner as the API user sending the request.
# You can set the claim's policy in any of the following ways:
# - Use the claim resource's policy property to identify a saved policy by its
# unique ID.
# - Use the claim resource's policy property to specify a custom set of rules.
# @param [Google::Apis::YoutubePartnerV1::Claim] claim_object
# @param [Boolean] is_manual_claim
# restricted
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::Claim] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::Claim]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_claim(claim_object = nil, is_manual_claim: nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:post, 'claims', options)
command.request_representation = Google::Apis::YoutubePartnerV1::Claim::Representation
command.request_object = claim_object
command.response_representation = Google::Apis::YoutubePartnerV1::Claim::Representation
command.response_class = Google::Apis::YoutubePartnerV1::Claim
command.query['isManualClaim'] = is_manual_claim unless is_manual_claim.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 claims administered by the content owner associated with
# the currently authenticated user. Results are sorted in descending order of
# creation time.
# @param [String] asset_id
# Use the claimSearch.list method's assetId parameter to search for claim
# snippets by asset ID. You can then retrieve the claim resources for those
# claims by using this method's id parameter to specify a comma-separated list
# of claim IDs.
# @param [String] id
# The id parameter specifies a list of comma-separated YouTube claim IDs to
# retrieve.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] page_token
# The pageToken parameter specifies a token that identifies a particular page of
# results to return. For example, set this parameter to the value of the
# nextPageToken value from the previous API response to retrieve the next page
# of search results.
# @param [String] q
# Use the claimSearch.list method's q parameter to search for claim snippets
# that match a particular query string. You can then retrieve the claim
# resources for those claims by using this method's id parameter to specify a
# comma-separated list of claim IDs.
# @param [String] video_id
# Use the claimSearch.list method's videoId parameter to search for claim
# snippets by video ID. You can then retrieve the claim resources for those
# claims by using this method's id parameter to specify a comma-separated list
# of claim 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::YoutubePartnerV1::ClaimListResponse] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::ClaimListResponse]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_claims(asset_id: nil, id: nil, on_behalf_of_content_owner: nil, page_token: nil, q: nil, video_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'claims', options)
command.response_representation = Google::Apis::YoutubePartnerV1::ClaimListResponse::Representation
command.response_class = Google::Apis::YoutubePartnerV1::ClaimListResponse
command.query['assetId'] = asset_id unless asset_id.nil?
command.query['id'] = id unless id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.nil?
command.query['pageToken'] = page_token unless page_token.nil?
command.query['q'] = q unless q.nil?
command.query['videoId'] = video_id unless video_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 claim by either changing its policy or its status. You can
# update a claim's status from active to inactive to effectively release the
# claim. This method supports patch semantics.
# @param [String] claim_id
# The claimId parameter specifies the claim ID of the claim being updated.
# @param [Google::Apis::YoutubePartnerV1::Claim] claim_object
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::Claim] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::Claim]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_claim(claim_id, claim_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:patch, 'claims/{claimId}', options)
command.request_representation = Google::Apis::YoutubePartnerV1::Claim::Representation
command.request_object = claim_object
command.response_representation = Google::Apis::YoutubePartnerV1::Claim::Representation
command.response_class = Google::Apis::YoutubePartnerV1::Claim
command.params['claimId'] = claim_id unless claim_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 claim by either changing its policy or its status. You can
# update a claim's status from active to inactive to effectively release the
# claim.
# @param [String] claim_id
# The claimId parameter specifies the claim ID of the claim being updated.
# @param [Google::Apis::YoutubePartnerV1::Claim] claim_object
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::Claim] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::Claim]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_claim(claim_id, claim_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:put, 'claims/{claimId}', options)
command.request_representation = Google::Apis::YoutubePartnerV1::Claim::Representation
command.request_object = claim_object
command.response_representation = Google::Apis::YoutubePartnerV1::Claim::Representation
command.response_class = Google::Apis::YoutubePartnerV1::Claim
command.params['claimId'] = claim_id unless claim_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 advertising options for the content owner associated with the
# authenticated user.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::ContentOwnerAdvertisingOption] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::ContentOwnerAdvertisingOption]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_owner_advertising_option(on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'contentOwnerAdvertisingOptions', options)
command.response_representation = Google::Apis::YoutubePartnerV1::ContentOwnerAdvertisingOption::Representation
command.response_class = Google::Apis::YoutubePartnerV1::ContentOwnerAdvertisingOption
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 advertising options for the content owner associated with the
# authenticated API user. This method supports patch semantics.
# @param [Google::Apis::YoutubePartnerV1::ContentOwnerAdvertisingOption] content_owner_advertising_option_object
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::ContentOwnerAdvertisingOption] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::ContentOwnerAdvertisingOption]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_owner_advertising_option(content_owner_advertising_option_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:patch, 'contentOwnerAdvertisingOptions', options)
command.request_representation = Google::Apis::YoutubePartnerV1::ContentOwnerAdvertisingOption::Representation
command.request_object = content_owner_advertising_option_object
command.response_representation = Google::Apis::YoutubePartnerV1::ContentOwnerAdvertisingOption::Representation
command.response_class = Google::Apis::YoutubePartnerV1::ContentOwnerAdvertisingOption
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 advertising options for the content owner associated with the
# authenticated API user.
# @param [Google::Apis::YoutubePartnerV1::ContentOwnerAdvertisingOption] content_owner_advertising_option_object
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::ContentOwnerAdvertisingOption] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::ContentOwnerAdvertisingOption]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_owner_advertising_option(content_owner_advertising_option_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:put, 'contentOwnerAdvertisingOptions', options)
command.request_representation = Google::Apis::YoutubePartnerV1::ContentOwnerAdvertisingOption::Representation
command.request_object = content_owner_advertising_option_object
command.response_representation = Google::Apis::YoutubePartnerV1::ContentOwnerAdvertisingOption::Representation
command.response_class = Google::Apis::YoutubePartnerV1::ContentOwnerAdvertisingOption
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 information about the specified content owner.
# @param [String] content_owner_id
# The contentOwnerId parameter specifies a value that uniquely identifies the
# content owner.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::ContentOwner] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::ContentOwner]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_owner(content_owner_id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'contentOwners/{contentOwnerId}', options)
command.response_representation = Google::Apis::YoutubePartnerV1::ContentOwner::Representation
command.response_class = Google::Apis::YoutubePartnerV1::ContentOwner
command.params['contentOwnerId'] = content_owner_id unless content_owner_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 owners that match the request criteria.
# @param [Boolean] fetch_mine
# The fetchMine parameter restricts the result set to content owners associated
# with the currently authenticated API user.
# @param [String] id
# The id parameter specifies a comma-separated list of YouTube content owner IDs
# to retrieve.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::ContentOwnerListResponse] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::ContentOwnerListResponse]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_owners(fetch_mine: nil, id: nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'contentOwners', options)
command.response_representation = Google::Apis::YoutubePartnerV1::ContentOwnerListResponse::Representation
command.response_class = Google::Apis::YoutubePartnerV1::ContentOwnerListResponse
command.query['fetchMine'] = fetch_mine unless fetch_mine.nil?
command.query['id'] = id unless id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 cuepoint into a live broadcast.
# @param [String] channel_id
# The channelId parameter identifies the channel that owns the broadcast into
# which the cuepoint is being inserted.
# @param [Google::Apis::YoutubePartnerV1::LiveCuepoint] live_cuepoint_object
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners. You can obtain the content owner ID
# that will serve as the parameter value by calling the YouTube Content ID API's
# contentOwners.list method.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::LiveCuepoint] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::LiveCuepoint]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_live_cuepoint(channel_id, live_cuepoint_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:post, 'liveCuepoints', options)
command.request_representation = Google::Apis::YoutubePartnerV1::LiveCuepoint::Representation
command.request_object = live_cuepoint_object
command.response_representation = Google::Apis::YoutubePartnerV1::LiveCuepoint::Representation
command.response_class = Google::Apis::YoutubePartnerV1::LiveCuepoint
command.query['channelId'] = channel_id unless channel_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 all metadata provided for an asset, regardless of which
# content owner provided the data.
# @param [String] asset_id
# The assetId parameter specifies the YouTube asset ID of the asset for which
# you are retrieving a metadata history.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::MetadataHistoryListResponse] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::MetadataHistoryListResponse]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_metadata_histories(asset_id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'metadataHistory', options)
command.response_representation = Google::Apis::YoutubePartnerV1::MetadataHistoryListResponse::Representation
command.response_class = Google::Apis::YoutubePartnerV1::MetadataHistoryListResponse
command.query['assetId'] = asset_id unless asset_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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
# Delete an order, which moves orders to inactive state and removes any
# associated video.
# @param [String] order_id
# Id of the order to delete.
# @param [String] on_behalf_of_content_owner
# ContentOwnerId that super admin acts in behalf of.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available to use for quota purposes for server-side applications. Can be any
# arbitrary string assigned to a user, but should not exceed 40 characters.
# 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_order(order_id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:delete, 'orders/{orderId}', options)
command.params['orderId'] = order_id unless order_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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
# Retrieve the details of an existing order.
# @param [String] order_id
# The id of the order.
# @param [String] on_behalf_of_content_owner
# ContentOnwerId that super admin acts in behalf of.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available to use for quota purposes for server-side applications. Can be any
# arbitrary string assigned to a user, but should not exceed 40 characters.
# 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::YoutubePartnerV1::Order] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::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(order_id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'orders/{orderId}', options)
command.response_representation = Google::Apis::YoutubePartnerV1::Order::Representation
command.response_class = Google::Apis::YoutubePartnerV1::Order
command.params['orderId'] = order_id unless order_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 new basic order entry in the YouTube premium asset order management
# system. You must supply at least a country and channel in the new order.
# @param [Google::Apis::YoutubePartnerV1::Order] order_object
# @param [String] on_behalf_of_content_owner
# ContentOnwerId that super admin acts in behalf of.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available to use for quota purposes for server-side applications. Can be any
# arbitrary string assigned to a user, but should not exceed 40 characters.
# 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::YoutubePartnerV1::Order] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::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 insert_order(order_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:post, 'orders', options)
command.request_representation = Google::Apis::YoutubePartnerV1::Order::Representation
command.request_object = order_object
command.response_representation = Google::Apis::YoutubePartnerV1::Order::Representation
command.response_class = Google::Apis::YoutubePartnerV1::Order
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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
# Return a list of orders, filtered by the parameters below, may return more
# than a single page of results.
# @param [String] channel_id
# Filter results to only a specific channel ( use encrypted ID).
# @param [String] content_type
# Filter the results by type, possible values are SHOW or MOVIE.
# @param [String] country
# Filter results by country, two letter ISO country codes are used.
# @param [String] custom_id
# Filter result by orders that have this custom ID.
# @param [String] on_behalf_of_content_owner
# ContentOnwerId that super admin acts in behalf of.
# @param [String] page_token
# The continuation token is an optional value that is only used to page through
# large result sets.
# - To retrieve the next page of results for a request, set this parameter to
# the value of the nextPageToken value from the previous response.
# - To get the previous page of results, set this parameter to the value of the
# previousPageToken value from the previous response.
# @param [String] priority
# Filter results by priority. P0, P1, P2, P3 and P4 are the acceptable options.
# @param [String] production_house
# Filter results by a particular production house. Specified by the name of the
# production house.
# @param [String] q
# Filter results to only orders that contain this string in the title.
# @param [String] status
# Filter results to have this status, available options are STATUS_AVAILED,
# STATUS_ORDERED, STATUS_RECEIVED, STATUS_READY_FOR_QC, STATUS_MOC_FIX,
# STATUS_PARTNER_FIX, STATUS_YOUTUBE_FIX, STATUS_QC_APPROVED, STATUS_INACTIVE,
# STATUS_INGESTION_COMPLETE, STATUS_REORDERED
# @param [String] video_id
# Filter results to orders that are associated with this YouTube external video
# 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::YoutubePartnerV1::OrderListResponse] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::OrderListResponse]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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(channel_id: nil, content_type: nil, country: nil, custom_id: nil, on_behalf_of_content_owner: nil, page_token: nil, priority: nil, production_house: nil, q: nil, status: nil, video_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'orders', options)
command.response_representation = Google::Apis::YoutubePartnerV1::OrderListResponse::Representation
command.response_class = Google::Apis::YoutubePartnerV1::OrderListResponse
command.query['channelId'] = channel_id unless channel_id.nil?
command.query['contentType'] = content_type unless content_type.nil?
command.query['country'] = country unless country.nil?
command.query['customId'] = custom_id unless custom_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.nil?
command.query['pageToken'] = page_token unless page_token.nil?
command.query['priority'] = priority unless priority.nil?
command.query['productionHouse'] = production_house unless production_house.nil?
command.query['q'] = q unless q.nil?
command.query['status'] = status unless status.nil?
command.query['videoId'] = video_id unless video_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
# Update the values in an existing order. This method supports patch semantics.
# @param [String] order_id
# The id of the order.
# @param [Google::Apis::YoutubePartnerV1::Order] order_object
# @param [String] on_behalf_of_content_owner
# ContentOwnerId that super admin acts in behalf of.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available to use for quota purposes for server-side applications. Can be any
# arbitrary string assigned to a user, but should not exceed 40 characters.
# 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::YoutubePartnerV1::Order] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::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 patch_order(order_id, order_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:patch, 'orders/{orderId}', options)
command.request_representation = Google::Apis::YoutubePartnerV1::Order::Representation
command.request_object = order_object
command.response_representation = Google::Apis::YoutubePartnerV1::Order::Representation
command.response_class = Google::Apis::YoutubePartnerV1::Order
command.params['orderId'] = order_id unless order_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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
# Update the values in an existing order.
# @param [String] order_id
# The id of the order.
# @param [Google::Apis::YoutubePartnerV1::Order] order_object
# @param [String] on_behalf_of_content_owner
# ContentOwnerId that super admin acts in behalf of.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available to use for quota purposes for server-side applications. Can be any
# arbitrary string assigned to a user, but should not exceed 40 characters.
# 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::YoutubePartnerV1::Order] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::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 update_order(order_id, order_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:put, 'orders/{orderId}', options)
command.request_representation = Google::Apis::YoutubePartnerV1::Order::Representation
command.request_object = order_object
command.response_representation = Google::Apis::YoutubePartnerV1::Order::Representation
command.response_class = Google::Apis::YoutubePartnerV1::Order
command.params['orderId'] = order_id unless order_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 ownership data provided for the specified asset by the content
# owner associated with the authenticated user.
# @param [String] asset_id
# The assetId parameter specifies the YouTube asset ID for which you are
# retrieving ownership data.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::RightsOwnership] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::RightsOwnership]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_ownership(asset_id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'assets/{assetId}/ownership', options)
command.response_representation = Google::Apis::YoutubePartnerV1::RightsOwnership::Representation
command.response_class = Google::Apis::YoutubePartnerV1::RightsOwnership
command.params['assetId'] = asset_id unless asset_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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
# Provides new ownership information for the specified asset. Note that YouTube
# may receive ownership information from multiple sources. For example, if an
# asset has multiple owners, each owner might send ownership data for the asset.
# YouTube algorithmically combines the ownership data received from all of those
# sources to generate the asset's canonical ownership data, which should provide
# the most comprehensive and accurate representation of the asset's ownership.
# This method supports patch semantics.
# @param [String] asset_id
# The assetId parameter specifies the YouTube asset ID of the asset being
# updated.
# @param [Google::Apis::YoutubePartnerV1::RightsOwnership] rights_ownership_object
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::RightsOwnership] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::RightsOwnership]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_ownership(asset_id, rights_ownership_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:patch, 'assets/{assetId}/ownership', options)
command.request_representation = Google::Apis::YoutubePartnerV1::RightsOwnership::Representation
command.request_object = rights_ownership_object
command.response_representation = Google::Apis::YoutubePartnerV1::RightsOwnership::Representation
command.response_class = Google::Apis::YoutubePartnerV1::RightsOwnership
command.params['assetId'] = asset_id unless asset_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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
# Provides new ownership information for the specified asset. Note that YouTube
# may receive ownership information from multiple sources. For example, if an
# asset has multiple owners, each owner might send ownership data for the asset.
# YouTube algorithmically combines the ownership data received from all of those
# sources to generate the asset's canonical ownership data, which should provide
# the most comprehensive and accurate representation of the asset's ownership.
# @param [String] asset_id
# The assetId parameter specifies the YouTube asset ID of the asset being
# updated.
# @param [Google::Apis::YoutubePartnerV1::RightsOwnership] rights_ownership_object
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::RightsOwnership] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::RightsOwnership]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_ownership(asset_id, rights_ownership_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:put, 'assets/{assetId}/ownership', options)
command.request_representation = Google::Apis::YoutubePartnerV1::RightsOwnership::Representation
command.request_object = rights_ownership_object
command.response_representation = Google::Apis::YoutubePartnerV1::RightsOwnership::Representation
command.response_class = Google::Apis::YoutubePartnerV1::RightsOwnership
command.params['assetId'] = asset_id unless asset_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 the ownership data for an asset, regardless of which
# content owner provided the data. The list only includes the most recent
# ownership data for each content owner. However, if the content owner has
# submitted ownership data through multiple data sources (API, content feeds,
# etc.), the list will contain the most recent data for each content owner and
# data source.
# @param [String] asset_id
# The assetId parameter specifies the YouTube asset ID of the asset for which
# you are retrieving an ownership data history.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::OwnershipHistoryListResponse] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::OwnershipHistoryListResponse]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_ownership_histories(asset_id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'ownershipHistory', options)
command.response_representation = Google::Apis::YoutubePartnerV1::OwnershipHistoryListResponse::Representation
command.response_class = Google::Apis::YoutubePartnerV1::OwnershipHistoryListResponse
command.query['assetId'] = asset_id unless asset_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 specified saved policy.
# @param [String] policy_id
# The policyId parameter specifies a value that uniquely identifies the policy
# being retrieved.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::Policy] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::Policy]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_policy(policy_id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'policies/{policyId}', options)
command.response_representation = Google::Apis::YoutubePartnerV1::Policy::Representation
command.response_class = Google::Apis::YoutubePartnerV1::Policy
command.params['policyId'] = policy_id unless policy_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 saved policy.
# @param [Google::Apis::YoutubePartnerV1::Policy] policy_object
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::Policy] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::Policy]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_policy(policy_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:post, 'policies', options)
command.request_representation = Google::Apis::YoutubePartnerV1::Policy::Representation
command.request_object = policy_object
command.response_representation = Google::Apis::YoutubePartnerV1::Policy::Representation
command.response_class = Google::Apis::YoutubePartnerV1::Policy
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 the content owner's saved policies.
# @param [String] id
# The id parameter specifies a comma-separated list of saved policy IDs to
# retrieve. Only policies belonging to the currently authenticated content owner
# will be available.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] sort
# The sort parameter specifies how the search results should be sorted.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::PolicyList] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::PolicyList]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_policies(id: nil, on_behalf_of_content_owner: nil, sort: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'policies', options)
command.response_representation = Google::Apis::YoutubePartnerV1::PolicyList::Representation
command.response_class = Google::Apis::YoutubePartnerV1::PolicyList
command.query['id'] = id unless id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.nil?
command.query['sort'] = sort unless sort.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 the specified saved policy. This method supports patch semantics.
# @param [String] policy_id
# The policyId parameter specifies a value that uniquely identifies the policy
# being updated.
# @param [Google::Apis::YoutubePartnerV1::Policy] policy_object
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::Policy] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::Policy]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_policy(policy_id, policy_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:patch, 'policies/{policyId}', options)
command.request_representation = Google::Apis::YoutubePartnerV1::Policy::Representation
command.request_object = policy_object
command.response_representation = Google::Apis::YoutubePartnerV1::Policy::Representation
command.response_class = Google::Apis::YoutubePartnerV1::Policy
command.params['policyId'] = policy_id unless policy_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 the specified saved policy.
# @param [String] policy_id
# The policyId parameter specifies a value that uniquely identifies the policy
# being updated.
# @param [Google::Apis::YoutubePartnerV1::Policy] policy_object
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::Policy] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::Policy]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_policy(policy_id, policy_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:put, 'policies/{policyId}', options)
command.request_representation = Google::Apis::YoutubePartnerV1::Policy::Representation
command.request_object = policy_object
command.response_representation = Google::Apis::YoutubePartnerV1::Policy::Representation
command.response_class = Google::Apis::YoutubePartnerV1::Policy
command.params['policyId'] = policy_id unless policy_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 information about the specified publisher.
# @param [String] publisher_id
# The publisherId parameter specifies a publisher ID that uniquely identifies
# the publisher being retrieved.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::Publisher] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::Publisher]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_publisher(publisher_id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'publishers/{publisherId}', options)
command.response_representation = Google::Apis::YoutubePartnerV1::Publisher::Representation
command.response_class = Google::Apis::YoutubePartnerV1::Publisher
command.params['publisherId'] = publisher_id unless publisher_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 publishers that match the request criteria. This method is
# analogous to a publisher search function.
# @param [String] cae_number
# The caeNumber parameter specifies the CAE number of the publisher that you
# want to retrieve.
# @param [String] id
# The id parameter specifies a comma-separated list of YouTube publisher IDs to
# retrieve.
# @param [String] ipi_number
# The ipiNumber parameter specifies the IPI number of the publisher that you
# want to retrieve.
# @param [Fixnum] max_results
# The maxResults parameter specifies the maximum number of results to return per
# page.
# @param [String] name_prefix
# The namePrefix parameter indicates that the API should only return publishers
# whose name starts with this prefix.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] page_token
# The pageToken parameter specifies a token that identifies a particular page of
# results to return. Set this parameter to the value of the nextPageToken value
# from the previous API response to retrieve the next page of search 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::YoutubePartnerV1::PublisherList] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::PublisherList]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_publishers(cae_number: nil, id: nil, ipi_number: nil, max_results: nil, name_prefix: nil, on_behalf_of_content_owner: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'publishers', options)
command.response_representation = Google::Apis::YoutubePartnerV1::PublisherList::Representation
command.response_class = Google::Apis::YoutubePartnerV1::PublisherList
command.query['caeNumber'] = cae_number unless cae_number.nil?
command.query['id'] = id unless id.nil?
command.query['ipiNumber'] = ipi_number unless ipi_number.nil?
command.query['maxResults'] = max_results unless max_results.nil?
command.query['namePrefix'] = name_prefix unless name_prefix.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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
# Retrieves information about the specified reference conflict.
# @param [String] reference_conflict_id
# The referenceConflictId parameter specifies the YouTube reference conflict ID
# of the reference conflict being retrieved.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::ReferenceConflict] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::ReferenceConflict]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_reference_conflict(reference_conflict_id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'referenceConflicts/{referenceConflictId}', options)
command.response_representation = Google::Apis::YoutubePartnerV1::ReferenceConflict::Representation
command.response_class = Google::Apis::YoutubePartnerV1::ReferenceConflict
command.params['referenceConflictId'] = reference_conflict_id unless reference_conflict_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 unresolved reference conflicts.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] page_token
# The pageToken parameter specifies a token that identifies a particular page of
# results to return. Set this parameter to the value of the nextPageToken value
# from the previous API response to retrieve the next page of search 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::YoutubePartnerV1::ReferenceConflictListResponse] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::ReferenceConflictListResponse]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_reference_conflicts(on_behalf_of_content_owner: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'referenceConflicts', options)
command.response_representation = Google::Apis::YoutubePartnerV1::ReferenceConflictListResponse::Representation
command.response_class = Google::Apis::YoutubePartnerV1::ReferenceConflictListResponse
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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
# Retrieves information about the specified reference.
# @param [String] reference_id
# The referenceId parameter specifies the YouTube reference ID of the reference
# being retrieved.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::Reference] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::Reference]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_reference(reference_id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'references/{referenceId}', options)
command.response_representation = Google::Apis::YoutubePartnerV1::Reference::Representation
command.response_class = Google::Apis::YoutubePartnerV1::Reference
command.params['referenceId'] = reference_id unless reference_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 reference in one of the following ways:
# - If your request is uploading a reference file, YouTube creates the reference
# from the provided content. You can provide either a video/audio file or a pre-
# generated fingerprint. If you are providing a pre-generated fingerprint, set
# the reference resource's fpDirect property to true in the request body. In
# this flow, you can use either the multipart or resumable upload flows to
# provide the reference content.
# - If you want to create a reference using a claimed video as the reference
# content, use the claimId parameter to identify the claim.
# @param [Google::Apis::YoutubePartnerV1::Reference] reference_object
# @param [String] claim_id
# The claimId parameter specifies the YouTube claim ID of an existing claim from
# which a reference should be created. (The claimed video is used as the
# reference content.)
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::Reference] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::Reference]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_reference(reference_object = nil, claim_id: nil, on_behalf_of_content_owner: 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, 'references', options)
else
command = make_upload_command(:post, 'references', options)
command.upload_source = upload_source
command.upload_content_type = content_type
end
command.request_representation = Google::Apis::YoutubePartnerV1::Reference::Representation
command.request_object = reference_object
command.response_representation = Google::Apis::YoutubePartnerV1::Reference::Representation
command.response_class = Google::Apis::YoutubePartnerV1::Reference
command.query['claimId'] = claim_id unless claim_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 references by ID or the list of references for the
# specified asset.
# @param [String] asset_id
# The assetId parameter specifies the YouTube asset ID of the asset for which
# you are retrieving references.
# @param [String] id
# The id parameter specifies a comma-separated list of YouTube reference IDs to
# retrieve.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] page_token
# The pageToken parameter specifies a token that identifies a particular page of
# results to return. Set this parameter to the value of the nextPageToken value
# from the previous API response to retrieve the next page of search 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::YoutubePartnerV1::ReferenceListResponse] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::ReferenceListResponse]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_references(asset_id: nil, id: nil, on_behalf_of_content_owner: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'references', options)
command.response_representation = Google::Apis::YoutubePartnerV1::ReferenceListResponse::Representation
command.response_class = Google::Apis::YoutubePartnerV1::ReferenceListResponse
command.query['assetId'] = asset_id unless asset_id.nil?
command.query['id'] = id unless id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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
# Updates a reference. This method supports patch semantics.
# @param [String] reference_id
# The referenceId parameter specifies the YouTube reference ID of the reference
# being updated.
# @param [Google::Apis::YoutubePartnerV1::Reference] reference_object
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [Boolean] release_claims
# The releaseClaims parameter indicates that you want to release all match
# claims associated with this reference. This parameter only works when the
# claim's status is being updated to 'inactive' - you can then set the parameter'
# s value to true to release all match claims produced by this reference.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::Reference] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::Reference]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_reference(reference_id, reference_object = nil, on_behalf_of_content_owner: nil, release_claims: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:patch, 'references/{referenceId}', options)
command.request_representation = Google::Apis::YoutubePartnerV1::Reference::Representation
command.request_object = reference_object
command.response_representation = Google::Apis::YoutubePartnerV1::Reference::Representation
command.response_class = Google::Apis::YoutubePartnerV1::Reference
command.params['referenceId'] = reference_id unless reference_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.nil?
command.query['releaseClaims'] = release_claims unless release_claims.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 reference.
# @param [String] reference_id
# The referenceId parameter specifies the YouTube reference ID of the reference
# being updated.
# @param [Google::Apis::YoutubePartnerV1::Reference] reference_object
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [Boolean] release_claims
# The releaseClaims parameter indicates that you want to release all match
# claims associated with this reference. This parameter only works when the
# claim's status is being updated to 'inactive' - you can then set the parameter'
# s value to true to release all match claims produced by this reference.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::Reference] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::Reference]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_reference(reference_id, reference_object = nil, on_behalf_of_content_owner: nil, release_claims: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:put, 'references/{referenceId}', options)
command.request_representation = Google::Apis::YoutubePartnerV1::Reference::Representation
command.request_object = reference_object
command.response_representation = Google::Apis::YoutubePartnerV1::Reference::Representation
command.response_class = Google::Apis::YoutubePartnerV1::Reference
command.params['referenceId'] = reference_id unless reference_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.nil?
command.query['releaseClaims'] = release_claims unless release_claims.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 advertising settings for the specified video.
# @param [String] video_id
# The videoId parameter specifies the YouTube video ID of the video for which
# you are retrieving advertising settings.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::VideoAdvertisingOption] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::VideoAdvertisingOption]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_advertising_option(video_id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'videoAdvertisingOptions/{videoId}', options)
command.response_representation = Google::Apis::YoutubePartnerV1::VideoAdvertisingOption::Representation
command.response_class = Google::Apis::YoutubePartnerV1::VideoAdvertisingOption
command.params['videoId'] = video_id unless video_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 details about the types of allowed ads for a specified partner- or
# user-uploaded video.
# @param [String] video_id
# The videoId parameter specifies the YouTube video ID of the video for which
# you are retrieving advertising options.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::VideoAdvertisingOptionGetEnabledAdsResponse] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::VideoAdvertisingOptionGetEnabledAdsResponse]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_advertising_option_enabled_ads(video_id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'videoAdvertisingOptions/{videoId}/getEnabledAds', options)
command.response_representation = Google::Apis::YoutubePartnerV1::VideoAdvertisingOptionGetEnabledAdsResponse::Representation
command.response_class = Google::Apis::YoutubePartnerV1::VideoAdvertisingOptionGetEnabledAdsResponse
command.params['videoId'] = video_id unless video_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 the advertising settings for the specified video. This method supports
# patch semantics.
# @param [String] video_id
# The videoId parameter specifies the YouTube video ID of the video for which
# you are updating advertising settings.
# @param [Google::Apis::YoutubePartnerV1::VideoAdvertisingOption] video_advertising_option_object
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::VideoAdvertisingOption] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::VideoAdvertisingOption]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_video_advertising_option(video_id, video_advertising_option_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:patch, 'videoAdvertisingOptions/{videoId}', options)
command.request_representation = Google::Apis::YoutubePartnerV1::VideoAdvertisingOption::Representation
command.request_object = video_advertising_option_object
command.response_representation = Google::Apis::YoutubePartnerV1::VideoAdvertisingOption::Representation
command.response_class = Google::Apis::YoutubePartnerV1::VideoAdvertisingOption
command.params['videoId'] = video_id unless video_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 the advertising settings for the specified video.
# @param [String] video_id
# The videoId parameter specifies the YouTube video ID of the video for which
# you are updating advertising settings.
# @param [Google::Apis::YoutubePartnerV1::VideoAdvertisingOption] video_advertising_option_object
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::VideoAdvertisingOption] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::VideoAdvertisingOption]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_video_advertising_option(video_id, video_advertising_option_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:put, 'videoAdvertisingOptions/{videoId}', options)
command.request_representation = Google::Apis::YoutubePartnerV1::VideoAdvertisingOption::Representation
command.request_object = video_advertising_option_object
command.response_representation = Google::Apis::YoutubePartnerV1::VideoAdvertisingOption::Representation
command.response_class = Google::Apis::YoutubePartnerV1::VideoAdvertisingOption
command.params['videoId'] = video_id unless video_id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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
# Removes a whitelisted channel for a content owner.
# @param [String] id
# The id parameter specifies the YouTube channel ID of the channel being removed
# from whitelist.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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_whitelist(id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:delete, 'whitelists/{id}', options)
command.params['id'] = id unless id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 specific whitelisted channel by ID.
# @param [String] id
# The id parameter specifies the YouTube channel ID of the whitelisted channel
# being retrieved.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::Whitelist] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::Whitelist]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_whitelist(id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'whitelists/{id}', options)
command.response_representation = Google::Apis::YoutubePartnerV1::Whitelist::Representation
command.response_class = Google::Apis::YoutubePartnerV1::Whitelist
command.params['id'] = id unless id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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
# Whitelist a YouTube channel for your content owner. Whitelisted channels are
# channels that are not owned or managed by you, but you would like to whitelist
# so that no claims from your assets are placed on videos uploaded to these
# channels.
# @param [Google::Apis::YoutubePartnerV1::Whitelist] whitelist_object
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# Available 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::YoutubePartnerV1::Whitelist] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::Whitelist]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_whitelist(whitelist_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:post, 'whitelists', options)
command.request_representation = Google::Apis::YoutubePartnerV1::Whitelist::Representation
command.request_object = whitelist_object
command.response_representation = Google::Apis::YoutubePartnerV1::Whitelist::Representation
command.response_class = Google::Apis::YoutubePartnerV1::Whitelist
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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 whitelisted channels for a content owner.
# @param [String] id
# The id parameter specifies a comma-separated list of YouTube channel IDs that
# identify the whitelisted channels you want to retrieve.
# @param [String] on_behalf_of_content_owner
# The onBehalfOfContentOwner parameter identifies the content owner that the
# user is acting on behalf of. This parameter supports users whose accounts are
# associated with multiple content owners.
# @param [String] page_token
# The pageToken parameter specifies a token that identifies a particular page of
# results to return. Set this parameter to the value of the nextPageToken value
# from the previous API response to retrieve the next page of 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::YoutubePartnerV1::WhitelistListResponse] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::YoutubePartnerV1::WhitelistListResponse]
#
# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be 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_whitelists(id: nil, on_behalf_of_content_owner: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
command = make_simple_command(:get, 'whitelists', options)
command.response_representation = Google::Apis::YoutubePartnerV1::WhitelistListResponse::Representation
command.response_class = Google::Apis::YoutubePartnerV1::WhitelistListResponse
command.query['id'] = id unless id.nil?
command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.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
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