توجه: YouTube Content ID API برای استفاده شرکای محتوای YouTube در نظر گرفته شده است و برای همه توسعه دهندگان یا همه کاربران YouTube قابل دسترسی نیست. اگر API شناسه محتوای YouTube را بهعنوان یکی از سرویسهای فهرست شده در Google API Console نمیبینید، برای کسب اطلاعات بیشتر درباره YouTube Partner Program به مرکز راهنمایی YouTube مراجعه کنید.
این نمونه کد نحوه آپلود یک ویدیوی YouTube و اعمال سیاست کسب درآمد را برای آن نشان می دهد. برای کسب درآمد از یک ویدیو، باید ویدیو را با asset
در سیستم مدیریت حقوق YouTube ادعا کنید . نمونه ویدیو را آپلود میکند، دارایی جدیدی ایجاد میکند، ویدیو را با استفاده از دارایی ادعا میکند و یک خطمشی کسب درآمد را برای ویدیو اعمال میکند.
این مثال به صورت مجموعه ای از مراحل همراه با بخش های مربوطه کد ارائه شده است. شما می توانید کل اسکریپت را در انتهای این صفحه پیدا کنید. کد به زبان پایتون نوشته شده است. کتابخانه های سرویس گیرنده برای سایر زبان های برنامه نویسی محبوب نیز در دسترس هستند.
اولین بخشهای نمونه کد، عملکردهای اصلی خانهداری را انجام میدهند که در بسیاری از اسکریپتها مشترک است: تجزیه خط فرمان، احراز هویت کاربر، و دریافت خدمات API لازم.
متد parse_options
از OptionParser
از کتابخانه کلاینت پایتون برای ایجاد یک شی options
استفاده می کند که هر آرگومان خط فرمان را به عنوان یک ویژگی در خود دارد. متدهای بعدی در صورت لزوم مقادیر را از شی options
بازیابی می کنند.
آرگومان های خط فرمان نمونه اسکریپت در زیر فهرست شده است. دو مورد اول ( file
و channelId
) مورد نیاز است. بقیه اختیاری هستند
file
: نام و محل فایل ویدیویی برای آپلود.Example: --file="/home/path/to/file.mov"
channelId
: کانال YouTube که میخواهید ویدیو را در آن آپلود کنید. کانال باید توسط حساب مدیر محتوای YouTube کاربر احراز هویت شده مدیریت شود. میتوانید شناسه کانال را در تنظیمات حساب YouTube برای کاربر تأیید شده یا با استفاده از روشchannels.list
بازیابی کنید.Example: --channelId="UC_x5XG1OV2P6uZZ5FSM9Ttw"
title
: عنوانی برای ویدیویی که در حال آپلود آن هستید. مقدار پیش فرضTest title
است.Example: --title="Summer vacation in California"
description
: شرح ویدیویی که در حال آپلود آن هستید. مقدار پیش فرضTest description
است.Example: --description="Had a great time surfing in Santa Cruz"
category
: شناسه دسته برای دسته ویدیوی YouTube مرتبط با ویدیو. مقدار پیش فرض22
است که به دستهPeople & Blogs
اشاره دارد.Example: --category=22
keywords
: فهرستی از کلمات کلیدی مرتبط با ویدئو که با کاما جدا شده است. مقدار پیش فرض یک رشته خالی است.Example: --keywords="surfing, beach volleyball"
privacyStatus
: وضعیت حریم خصوصی ویدیو. رفتار پیشفرض این است که ویدیوی آپلود شده برای عموم قابل مشاهده باشد (public
). هنگام آپلود ویدیوهای آزمایشی، ممکن است بخواهید یک مقدار آرگومان--privacyStatus
مشخص کنید تا مطمئن شوید که آن ویدیوها خصوصی یا فهرست نشده هستند. مقادیر معتبرpublic
,private
وunlisted
هستند .Example: --privacyStatus="private"
policyId
: خط مشی کسب درآمد برای اعمال در ویدیوی آپلود شده. این خطمشی باید با حساب مدیر محتوای YouTube کاربر تأیید شده مرتبط باشد. پیشفرض، خطمشی استاندارد «کسب درآمد» YouTube است.Example: --policyId="S309961703555739"
def parse_options(): parser = OptionParser() parser.add_option("--file", dest="file", help="Video file to upload") parser.add_option("--title", dest="title", help="Video title", default="Test Title") parser.add_option("--description", dest="description", help="Video description", default="Test Description") parser.add_option("--category", dest="category", help="Numeric video category. " + "See https://developers.google.com/youtube/v3/docs/videoCategories/list", default="22") parser.add_option("--keywords", dest="keywords", help="Video keywords, comma separated", default="") parser.add_option("--privacyStatus", dest="privacyStatus", help="Video privacy status: public, private or unlisted", default="public") parser.add_option("--policyId", dest="policyId", help="Optional id of a saved claim policy") parser.add_option("--channelId", dest="channelId", help="Id of the channel to upload to. Must be managed by your CMS account") (options, args) = parser.parse_args() return options
در این مرحله، مجوز OAuth 2.0 را در اسکریپت قرار می دهیم. این به کاربر در حال اجرا اسکریپت را قادر میسازد تا به اسکریپت اجازه دهد تا درخواستهای API منتسب به حساب کاربر را انجام دهد.
نوع مجوز نشان داده شده در نمونه به یک فایل client_secrets.json
نیاز دارد که حاوی اطلاعاتی از Google API Console برای انجام مجوز است. همچنین باید درخواست خود را ثبت کنید . برای توضیح کامل تر در مورد نحوه عملکرد مجوز، به راهنمای مجوز مراجعه کنید. توجه داشته باشید که این نمونه نیاز دارد که هم YouTube Data API V3 و هم سرویس YouTube Content ID API در کنسول API برای پروژه شما پیکربندی شوند.
{ "web": { "client_id": "INSERT CLIENT ID HERE", "client_secret": "INSERT CLIENT SECRET HERE", "redirect_uris": [], "auth_uri": "https://accounts.google.com/o/oauth2/auth", "token_uri": "https://accounts.google.com/o/oauth2/token" } }
این اسکریپت شامل این عبارات import
برای فعال کردن احراز هویت و مجوز کاربر است:
from oauth2client.file import Storage from oauth2client.client import flow_from_clientsecrets from oauth2client.tools import run
در مرحله بعد، متد get_authenticated_services
با استفاده از داده های فایل client_secrets.json
که در مرحله قبل پیکربندی شده بود، یک شی FLOW
ایجاد می کند. اگر کاربر به برنامه ما اجازه دهد درخواستهای API را از طرف کاربر ارسال کند، اعتبارنامههای حاصل در یک شی Storage
برای استفاده بعدی ذخیره میشوند. اگر اعتبارنامه منقضی شود، کاربر باید مجدداً مجوز برنامه ما را صادر کند.
YOUTUBE_SCOPES = ( # An OAuth 2 access scope that allows for full read/write access. "https://www.googleapis.com/auth/youtube", # A scope that grants access to YouTube Partner API functionality. "https://www.googleapis.com/auth/youtubepartner") flow = flow_from_clientsecrets( CLIENT_SECRETS_FILE, scope=" ".join(YOUTUBE_SCOPES), message=MISSING_CLIENT_SECRETS_MESSAGE ) storage = Storage(CACHED_CREDENTIALS_FILE) credentials = storage.get() if credentials is None or credentials.invalid: credentials = run(flow, storage)
پس از مجوز موفقیت آمیز، خدمات لازم را برای عملیاتی که می خواهیم انجام دهیم، دریافت می کنیم. نمونه از YouTube Data API برای آپلود ویدیو و از YouTube Content ID API برای ایجاد دارایی و ادعای ویدیو استفاده میکند. ما خدمات جداگانه ای ایجاد می کنیم تا دسترسی مجاز به عملکرد دو API را فراهم کنیم.
from googleapiclient.discovery import build import httplib2 YOUTUBE_API_SERVICE_NAME = "youtube" YOUTUBE_API_VERSION = "v3" YOUTUBE_CONTENT_ID_API_SERVICE_NAME = "youtubePartner" YOUTUBE_CONTENT_ID_API_VERSION = "v1" youtube = build(YOUTUBE_API_SERVICE_NAME, YOUTUBE_API_VERSION, http=credentials.authorize(httplib2.Http())) youtube_partner = build(YOUTUBE_CONTENT_ID_API_SERVICE_NAME, YOUTUBE_CONTENT_ID_API_VERSION, http=credentials.authorize(httplib2.Http()), static_discovery=False) return (youtube, youtube_partner)
برای ایجاد دارایی و ادعا، کاربر تأیید شده باید یک حساب مدیر محتوای YouTube داشته باشد. حساب مدیر محتوا، اشیاء مدیریت حقوق را برای یک یا چند مالک محتوا نگهداری می کند. مالک محتوا، دارنده حق نسخهبرداری است که حق تصمیمگیری درباره کسب درآمد، ردیابی یا مسدود کردن یک ویدیو را دارد.
روش get_content_owner
شناسه مالک محتوا را در حساب مدیر محتوای کاربر تأیید شده بازیابی می کند. اکثر حسابها یک مالک محتوا دارند (کاربر تأیید شده)، اما اگر حساب دارای چندین مالک محتوا باشد، روش اولین مورد را برمیگرداند.
def get_content_owner_id(youtube_partner): try: content_owners_list_response = youtube_partner.contentOwners().list( fetchMine=True ).execute() except HttpError, e: if INVALID_CREDENTIALS in e.content: logging.error("The request is not authorized by a Google Account that " "is linked to a YouTube content owner. Please delete '%s' and " "re-authenticate with a YouTube content owner account." % CACHED_CREDENTIALS_FILE) exit(1) else: raise # This returns the CMS user id of the first entry returned # by youtubePartner.contentOwners.list() # See https://developers.google.com/youtube/partner/reference/rest/v1/contentOwners/list # Normally this is what you want, but if you authorize with a Google Account # that has access to multiple YouTube content owner accounts, you need to # iterate through the results. return content_owners_list_response["items"][0]["id"]
برای آپلود یک ویدیو، یک منبع JSON جزئی میسازیم که ویدیو را نشان میدهد و آن را به روش videos.insert
ارسال میکنیم. ما ابرداده های ویدئویی را با استفاده از مقادیری از شی options
ایجاد شده در هنگام تجزیه خط فرمان تنظیم می کنیم. برای خود فایل رسانه ای، از MediaFileUpload
استفاده می کنیم تا بتوانیم از آپلود مجدد استفاده کنیم. برای جزئیات بیشتر به آپلود ویدیو مراجعه کنید.
روش upload
شناسه ویدیو را برای ویدیوی جدید برمیگرداند و اسکریپت باید این مقدار را در مراحل بعدی به روشهای دیگر منتقل کند.
def upload(youtube, content_owner_id, options): if options.keywords: tags = options.keywords.split(",") else: tags = None insert_request = youtube.videos().insert( part="snippet,status", body=dict( snippet=dict( title=options.title, description=options.description, tags=tags, categoryId=options.category ), status=dict( privacyStatus=options.privacyStatus ) ), # chunksize=-1 means that the entire file will be uploaded in a single # HTTP request. (If the upload fails, it will still be retried where it # left off.) This is usually a best practice, but if you're using Python # older than 2.6 or if you're running on App Engine, you should set the # chunksize to something like 1024 * 1024 (1 megabyte). media_body=MediaFileUpload(options.file, chunksize=-1, resumable=True) ) response = None error = None retry = 0 duration_seconds=0 while response is None: try: logging.debug("Uploading file...") start_seconds = time.time() status, response = insert_request.next_chunk() delta_seconds = time.time() - start_seconds duration_seconds += delta_seconds if "id" in response: return (response["id"], duration_seconds) else: logging.error("The upload failed with an unexpected response: %s" % response) exit(1) except HttpError, e: if e.resp.status in RETRIABLE_STATUS_CODES: error = "A retriable HTTP error %d occurred:\n%s" % (e.resp.status, e.content) else: raise except RETRIABLE_EXCEPTIONS, e: error = "A retriable error occurred: %s" % e if error is not None: logging.error(error) retry += 1 if retry > MAX_RETRIES: logging.error("No longer attempting to retry.") exit(1) max_sleep = 2 ** retry sleep_seconds = random.random() * max_sleep logging.debug("Sleeping %f seconds and then retrying..." % sleep_seconds) time.sleep(sleep_seconds)
برای کسب درآمد از یک ویدیوی YouTube، ابتدا باید آن را با یک دارایی مرتبط کنید. روش create_asset
یک دارایی جدید برای ویدیوی تازه آپلود شده ایجاد می کند.
درست مانند آنچه برای ویدیو انجام دادیم، یک منبع JSON جزئی ایجاد میکنیم که نوع دارایی برای ایجاد (یک ویدیوی وب) را مشخص میکند و عنوان و توضیحاتی را برای دارایی جدید ارائه میکند. منبع JSON را به متد assets.insert
میدهیم که دارایی را ایجاد میکند و شناسه منحصربهفرد آن را برمیگرداند. باز هم، اسکریپت باید آن مقدار را در مراحل بعدی به روش های دیگر منتقل کند.
def create_asset(youtube_partner, content_owner_id, title, description): # This creates a new asset corresponding to a video on the web. # The asset is linked to the corresponding YouTube video via a # claim that will be created later. body = dict( type="web", metadata=dict( title=title, description=description ) ) assets_insert_response = youtube_partner.assets().insert( body=body ).execute() return assets_insert_response["id"]
قبل از اینکه بتوانید از یک ویدیو کسب درآمد کنید، YouTube باید بداند که مالک دارایی مرتبط چه کسی است. بنابراین، با ایجاد دارایی، اکنون ownership
دارایی را پیکربندی میکنیم. در نمونه، مشخص میکنیم که مالک محتوا مالکیت جهانی این دارایی را دارد.
def set_asset_ownership(youtube_partner, content_owner_id, asset_id): # This specifies that content_owner_id owns 100% of the asset worldwide. # Adjust as needed. body = dict( general=[dict( owner=content_owner_id, ratio=100, type="exclude", territories=[] )] ) youtube_partner.ownership().update( assetId=asset_id, body=body ).execute()
مرحله بعدی این است که ویدیوی آپلود شده را با دارایی مربوطه با ادعای ویدیو مرتبط کنید. این ادعا پیوند بین ویدیو و سیستم مدیریت حقوق YouTube را ارائه میکند که مالکیت ویدیو را ایجاد میکند و به مالک امکان میدهد خطمشی کسب درآمد را تنظیم کند.
روش claim_video
حقوق سمعی و بصری را ادعا می کند. اگر پارامتر policyId
را در خط فرمان قرار دهید، این روش خط مشی مشخص شده را در ویدیو اعمال می کند. اگر پارامتر را وارد نکنید، این روش خط مشی استاندارد "کسب درآمد" را اعمال می کند.
def claim_video(youtube_partner, content_owner_id, asset_id, video_id, policy_id): # policy_id can be set to the id of an existing policy, which can be obtained # via youtubePartner.policies.list() # See https://developers.google.com/youtube/partner/reference/rest/v1/policies/list # If you later update that existing policy, the claim will also be updated. if policy_id: policy = dict( id=policy_id ) # If policy_id is not provided, a new inline policy is created. else: policy = dict( rules=[dict( action="monetize" )] ) body = dict( assetId=asset_id, videoId=video_id, policy=policy, contentType="audiovisual" ) youtube_partner.claims().insert( body=body ).execute()
ما این ویدیو را ادعا کردهایم و یک خطمشی کسب درآمد برای آن اعمال کردهایم. مرحله آخر این است که مشخص کنید چه نوع تبلیغاتی در ویدیو نمایش داده شود. هر زمان که خطمشی «کسب درآمد» اعمال شود، YouTube گزینههای تبلیغاتی را بررسی میکند و پردرآمدترین نوع تبلیغات موجود را نشان میدهد.
نمونه به YouTube میگوید که تبلیغات TrueView در جریان را با این ویدیو نشان دهد.
def set_advertising_options(youtube_partner, content_owner_id, video_id): # This enables the TrueView ad format for the given video. # Adjust as needed. body = dict( adFormats=["trueview_instream"] ) youtube_partner.videoAdvertisingOptions().update( videoId=video_id, body=body ).execute()
نمونه کار کامل upload_monetize_video_example.py
در زیر فهرست شده است:
#!/usr/bin/python # -*- coding: utf-8 -*- # # Copyright (C) 2013 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. """Simple command-line sample for Youtube Partner API. Command-line application that creates an asset, uploads and claims a video for that asset. Usage: $ python upload_monetize_video_example.py --file=VIDEO_FILE --channelID=CHANNEL_ID \ [--title=VIDEO_TITLE] [--description=VIDEO_DESCRIPTION] [--category=CATEGORY_ID] \ [--keywords=KEYWORDS] [--privacyStatus=PRIVACY_STATUS] [--policyId=POLICY_ID] You can also get help on all the command-line flags the program understands by running: $ python upload_monetize_video_example.py --help """ __author__ = 'jeffy+pub@google.com (Jeffrey Posnick)' import httplib import httplib2 import logging import os import random import sys import time from apiclient.discovery import build from apiclient.errors import HttpError from apiclient.http import MediaFileUpload from oauth2client.file import Storage from oauth2client.client import flow_from_clientsecrets from oauth2client.tools import run from optparse import OptionParser # Explicitly tell the underlying HTTP transport library not to retry, since # we are handling retry logic ourselves. httplib2.RETRIES = 1 # Maximum number of times to retry before giving up. MAX_RETRIES = 10 # Always retry when these exceptions are raised. RETRIABLE_EXCEPTIONS = (httplib2.HttpLib2Error, IOError, httplib.NotConnected, httplib.IncompleteRead, httplib.ImproperConnectionState, httplib.CannotSendRequest, httplib.CannotSendHeader, httplib.ResponseNotReady, httplib.BadStatusLine,) # Always retry when an apiclient.errors.HttpError with one of these status # codes is raised. RETRIABLE_STATUS_CODES = (500, 502, 503, 504,) # The message associated with the HTTP 401 error that's returned when a request # is authorized by a user whose account is not associated with a YouTube # content owner. INVALID_CREDENTIALS = "Invalid Credentials" # The CLIENT_SECRETS_FILE variable specifies the name of a file that contains # the OAuth 2.0 information for this application, including its client_id and # client_secret. You can acquire an OAuth 2.0 client ID and client secret from # the Google API Console at # https://console.cloud.google.com/. # See the "Registering your application" instructions for an explanation # of how to find these values: # https://developers.google.com/youtube/partner/guides/registering_an_application # For more information about using OAuth2 to access Google APIs, please visit: # https://developers.google.com/accounts/docs/OAuth2 # For more information about the client_secrets.json file format, please visit: # https://developers.google.com/api-client-library/python/guide/aaa_client_secrets CLIENT_SECRETS_FILE = "client_secrets.json" # The local file used to store the cached OAuth 2 credentials after going # through a one-time browser-based login. CACHED_CREDENTIALS_FILE = "%s-oauth2.json" % sys.argv[0] YOUTUBE_SCOPES = ( # An OAuth 2 access scope that allows for full read/write access. "https://www.googleapis.com/auth/youtube", # A scope that grants access to YouTube Partner API functionality. "https://www.googleapis.com/auth/youtubepartner",) YOUTUBE_API_SERVICE_NAME = "youtube" YOUTUBE_API_VERSION = "v3" YOUTUBE_CONTENT_ID_API_SERVICE_NAME = "youtubePartner" YOUTUBE_CONTENT_ID_API_VERSION = "v1" # Helpful message to display if the CLIENT_SECRETS_FILE is missing. MISSING_CLIENT_SECRETS_MESSAGE = """ WARNING: Please configure OAuth 2.0 To make this sample run you need to populate the client_secrets.json file at: %s with information from the API Console https://console.cloud.google.com/ For more information about the client_secrets.json file format, please visit: https://developers.google.com/api-client-library/python/guide/aaa_client_secrets """ % os.path.abspath(os.path.join(os.path.dirname(__file__), CLIENT_SECRETS_FILE)) def parse_options(): parser = OptionParser() parser.add_option("--file", dest="file", help="Video file to upload") parser.add_option("--title", dest="title", help="Video title", default="Test Title") parser.add_option("--description", dest="description", help="Video description", default="Test Description") parser.add_option("--category", dest="category", help="Numeric video category. " + "See https://developers.google.com/youtube/v3/docs/videoCategories/list", default="22") parser.add_option("--keywords", dest="keywords", help="Video keywords, comma separated", default="") parser.add_option("--privacyStatus", dest="privacyStatus", help="Video privacy status: public, private or unlisted", default="public") parser.add_option("--policyId", dest="policyId", help="Optional id of a saved claim policy") parser.add_option("--channelId", dest="channelId", help="Id of the channel to upload to. Must be managed by your CMS account") (options, args) = parser.parse_args() return options def get_authenticated_services(): flow = flow_from_clientsecrets( CLIENT_SECRETS_FILE, scope=" ".join(YOUTUBE_SCOPES), message=MISSING_CLIENT_SECRETS_MESSAGE ) storage = Storage(CACHED_CREDENTIALS_FILE) credentials = storage.get() if credentials is None or credentials.invalid: credentials = run(flow, storage) youtube = build(YOUTUBE_API_SERVICE_NAME, YOUTUBE_API_VERSION, http=credentials.authorize(httplib2.Http())) youtube_partner = build(YOUTUBE_CONTENT_ID_API_SERVICE_NAME, YOUTUBE_CONTENT_ID_API_VERSION, http=credentials.authorize(httplib2.Http()), static_discovery=False) return (youtube, youtube_partner) def get_content_owner_id(youtube_partner): try: content_owners_list_response = youtube_partner.contentOwners().list( fetchMine=True ).execute() except HttpError, e: if INVALID_CREDENTIALS in e.content: logging.error("Your request is not authorized by a Google Account that " "is associated with a YouTube content owner. Please delete '%s' and " "re-authenticate with an account that is associated " "with a content owner." % CACHED_CREDENTIALS_FILE) exit(1) else: raise # This returns the CMS user id of the first entry returned # by youtubePartner.contentOwners.list() # See https://developers.google.com/youtube/partner/reference/rest/v1/contentOwners/list # Normally this is what you want, but if you authorize with a Google Account # that has access to multiple YouTube content owner accounts, you need to # iterate through the results. return content_owners_list_response["items"][0]["id"] def upload(youtube, content_owner_id, options): if options.keywords: tags = options.keywords.split(",") else: tags = None insert_request = youtube.videos().insert( part="snippet,status", body=dict( snippet=dict( title=options.title, description=options.description, tags=tags, categoryId=options.category ), status=dict( privacyStatus=options.privacyStatus ) ), # chunksize=-1 means that the entire file will be uploaded in a single # HTTP request. (If the upload fails, it will still be retried where it # left off.) This is usually a best practice, but if you're using Python # older than 2.6 or if you're running on App Engine, you should set the # chunksize to something like 1024 * 1024 (1 megabyte). media_body=MediaFileUpload(options.file, chunksize=-1, resumable=True) ) response = None error = None retry = 0 duration_seconds=0 while response is None: try: logging.debug("Uploading file...") start_seconds = time.time() status, response = insert_request.next_chunk() delta_seconds = time.time() - start_seconds duration_seconds += delta_seconds if "id" in response: return (response["id"], duration_seconds) else: logging.error("The upload failed with an unexpected response: %s" % response) exit(1) except HttpError, e: if e.resp.status in RETRIABLE_STATUS_CODES: error = "A retriable HTTP error %d occurred:\n%s" % (e.resp.status, e.content) else: raise except RETRIABLE_EXCEPTIONS, e: error = "A retriable error occurred: %s" % e if error is not None: logging.error(error) retry += 1 if retry > MAX_RETRIES: logging.error("No longer attempting to retry.") exit(1) max_sleep = 2 ** retry sleep_seconds = random.random() * max_sleep logging.debug("Sleeping %f seconds and then retrying..." % sleep_seconds) time.sleep(sleep_seconds) def create_asset(youtube_partner, content_owner_id, title, description): # This creates a new asset corresponding to a video on the web. # The asset is linked to the corresponding YouTube video via a # claim that will be created later. body = dict( type="web", metadata=dict( title=title, description=description ) ) assets_insert_response = youtube_partner.assets().insert( body=body ).execute() return assets_insert_response["id"] def set_asset_ownership(youtube_partner, content_owner_id, asset_id): # This specifies that content_owner_id owns 100% of the asset worldwide. # Adjust as needed. body = dict( general=[dict( owner=content_owner_id, ratio=100, type="exclude", territories=[] )] ) youtube_partner.ownership().update( assetId=asset_id, body=body ).execute() def claim_video(youtube_partner, content_owner_id, asset_id, video_id, policy_id): # policy_id can be set to the id of an existing policy, which can be obtained # via youtubePartner.policies.list() # See https://developers.google.com/youtube/partner/reference/rest/v1/policies/list # If you later update that existing policy, the claim will also be updated. if policy_id: policy = dict( id=policy_id ) # If policy_id is not provided, a new inline policy is created. else: policy = dict( rules=[dict( action="monetize" )] ) body = dict( assetId=asset_id, videoId=video_id, policy=policy, contentType="audiovisual" ) claims_insert_response = youtube_partner.claims().insert( body=body ).execute() return claims_insert_response["id"] def set_advertising_options(youtube_partner, content_owner_id, video_id): # This enables the true view ad format for the given video. # Adjust as needed. body = dict( adFormats=["trueview_instream"] ) youtube_partner.videoAdvertisingOptions().update( videoId=video_id, body=body ).execute() if __name__ == '__main__': logging.basicConfig( level=logging.DEBUG, format="%(asctime)s [%(name)s] %(levelname)s: %(message)s", datefmt="%Y-%m-%d %H:%M:%S" ) options = parse_options() if options.file is None or not os.path.exists(options.file): logging.error("Please specify a valid file using the --file= parameter.") exit(1) # The channel ID looks something like "UC..." and needs to correspond to a # channel managed by the YouTube content owner authorizing the request. # youtube.channels.list(part="snippet", managedByMe=true, # # can be used to retrieve a list of managed channels and their channel IDs. # See https://developers.google.com/youtube/v3/docs/channels/list if options.channelId is None: logging.error("Please specify a channel ID via the --channelId= parameter.") exit(1) (youtube, youtube_partner) = get_authenticated_services() content_owner_id = get_content_owner_id(youtube_partner) logging.info("Authorized by content owner ID '%s'." % content_owner_id) (video_id, duration_seconds) = upload(youtube, content_owner_id, options) logging.info("Successfully uploaded video ID '%s'." % video_id) file_size_bytes = os.path.getsize(options.file) logging.debug("Uploaded %d bytes in %0.2f seconds (%0.2f megabytes/second)." % (file_size_bytes, duration_seconds, (file_size_bytes / (1024 * 1024)) / duration_seconds)) asset_id = create_asset(youtube_partner, content_owner_id, options.title, options.description) logging.info("Created new asset ID '%s'." % asset_id) set_asset_ownership(youtube_partner, content_owner_id, asset_id) logging.info("Successfully set asset ownership.") claim_id = claim_video(youtube_partner, content_owner_id, asset_id, video_id, options.policyId) logging.info("Successfully claimed video.") set_advertising_options(youtube_partner, content_owner_id, video_id) logging.info("Successfully set advertising options.") logging.info("All done!")