توجه: رابط برنامهنویسی کاربردی داده یوتیوب (YouTube Data API) برای استفاده شرکای محتوای یوتیوب در نظر گرفته شده است و برای همه توسعهدهندگان یا همه کاربران یوتیوب قابل دسترسی نیست. دسترسی به آن نیاز به یک حساب مدیریت محتوای یوتیوب (YouTube Content Manager) دارد. اگر حساب مدیریت محتوای یوتیوب دارید اما رابط برنامهنویسی کاربردی داده یوتیوب را به عنوان یکی از سرویسهای فهرست شده در کنسول گوگل کلود (Google Cloud Console) نمیبینید، با مدیر شریک یا پشتیبانی شریک تعیینشده خود تماس بگیرید.
این نمونه کد نحوه آپلود یک ویدیوی یوتیوب و اعمال سیاست کسب درآمد بر روی آن را نشان میدهد. برای کسب درآمد از یک ویدیو، باید ویدیو را با یک asset در سیستم مدیریت حقوق یوتیوب ادعا کنید . این نمونه ویدیو را آپلود میکند، یک دارایی جدید ایجاد میکند، ویدیو را با استفاده از دارایی ادعا میکند و یک سیاست کسب درآمد بر روی ویدیو اعمال میکند.
این مثال به صورت مجموعهای از مراحل به همراه بخشهای مربوطه در کد ارائه شده است. میتوانید کل اسکریپت را در انتهای این صفحه پیدا کنید. کد به زبان پایتون نوشته شده است. کتابخانههای کلاینت برای سایر زبانهای برنامهنویسی محبوب نیز موجود است.
الزامات
مرحله ۱: وظایف رایج خانهداری
بخشهای اول نمونه کد، توابع اساسی و رایج در بسیاری از اسکریپتها را انجام میدهند: تجزیه خط فرمان، احراز هویت کاربر و دریافت سرویسهای API لازم.
تجزیه خط فرمان
متد parse_options از OptionParser از کتابخانه کلاینت پایتون برای ایجاد یک شیء options استفاده میکند که شامل هر آرگومان خط فرمان به عنوان یک ویژگی است. متدهای بعدی در صورت لزوم مقادیر را از شیء options بازیابی میکنند.
آرگومانهای خط فرمان اسکریپت نمونه در زیر فهرست شدهاند. دو مورد اول ( file و channelId ) الزامی هستند؛ بقیه اختیاری هستند.
file: نام و محل فایل ویدیویی که قرار است آپلود شود.Example: --file="/home/path/to/file.mov"
channelId: کانال یوتیوبی که میخواهید ویدیو را در آن آپلود کنید. این کانال باید توسط حساب کاربری YouTube Content Manager کاربر احراز هویت شده مدیریت شود. میتوانید شناسه کانال را در تنظیمات حساب کاربری یوتیوب برای کاربر احراز هویت شده یا با استفاده از متد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: شناسه دسته برای دسته ویدیوی یوتیوب مرتبط با ویدیو. مقدار پیشفرض22است که به دستهPeople & Blogsاشاره دارد.Example: --category=22
keywords: فهرستی از کلمات کلیدی مرتبط با ویدیو که با کاما از هم جدا شدهاند. مقدار پیشفرض یک رشته خالی است.Example: --keywords="surfing, beach volleyball"
privacyStatus: وضعیت حریم خصوصی ویدیو. رفتار پیشفرض این است که ویدیوی آپلود شده به صورت عمومی قابل مشاهده باشد (public). هنگام آپلود ویدیوهای آزمایشی، میتوانید مقدار آرگومان--privacyStatusرا مشخص کنید تا مطمئن شوید که آن ویدیوها خصوصی هستند یا فهرست نشدهاند. مقادیر معتبرpublic،privateوunlistedهستند.Example: --privacyStatus="private"
policyId: سیاست کسب درآمد برای ویدیوی آپلود شده. این سیاست باید با حساب مدیریت محتوای یوتیوب کاربر احراز هویت شده مرتبط باشد. پیشفرض، سیاست استاندارد «کسب درآمد» یوتیوب است.Example: --policyId="S309961703555739"
def parse_options(): parser = argparse.ArgumentParser( description="Uploads and claims a video on YouTube.") parser.add_argument("--file", required=True, help="Video file to upload") parser.add_argument("--title", default="Test Title", help="Video title") parser.add_argument("--description", default="Test Description", help="Video description") parser.add_argument("--category", default="22", help="Numeric video category. See https://developers.google.com/youtube/v3/docs/videoCategories/list") parser.add_argument("--keywords", default="", help="Video keywords, comma separated") parser.add_argument("--privacyStatus", default="public", choices=["public", "private", "unlisted"], help="Video privacy status: public, private or unlisted") parser.add_argument("--policyId", help="Optional id of a saved claim policy") parser.add_argument("--channelId", required=True, help="Id of the channel to upload to. Must be managed by your CMS account") return parser.parse_args()
درخواست را تأیید کنید
در این مرحله، ما مجوز OAuth 2.0 را در اسکریپت قرار میدهیم. این کار به کاربری که اسکریپت را اجرا میکند، اجازه میدهد تا اسکریپت را برای انجام درخواستهای API منتسب به حساب کاربری خود مجاز کند.
یک فایل client_secrets.json ایجاد کنید
نوع مجوز نشان داده شده در نمونه، برای انجام مجوزدهی به یک فایل client_secrets.json نیاز دارد که حاوی اطلاعاتی از کنسول Google Cloud است. همچنین باید برنامه خود را ثبت کنید . برای توضیح کاملتر در مورد نحوه عملکرد مجوزدهی، به راهنمای مجوزدهی مراجعه کنید. توجه داشته باشید که این نمونه نیاز به پیکربندی سرویس YouTube Data API V3 و سرویس YouTube Content ID API در کنسول Cloud برای پروژه شما دارد.
{ "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)
مرحله ۲: شناسایی صاحب محتوا
برای ایجاد داراییها و طرح ادعاها، کاربر احراز هویت شده باید یک حساب مدیریت محتوای یوتیوب داشته باشد. حساب مدیریت محتوا، اشیاء مدیریت حقوق را برای یک یا چند مالک محتوا در اختیار دارد. مالک محتوا، دارنده حق چاپ است که حق تصمیمگیری در مورد کسب درآمد، ردیابی یا مسدود کردن یک ویدیو را دارد.
متد get_content_owner شناسه مالک محتوا را در حساب مدیریت محتوای کاربر احراز هویت شده بازیابی میکند. اکثر حسابها دارای یک مالک محتوا (کاربر احراز هویت شده) هستند، اما اگر حساب دارای چندین مالک محتوا باشد، این متد اولین مالک را برمیگرداند.
def get_content_owner_id(youtube_partner): try: content_owners_list_response = youtube_partner.contentOwners().list( fetchMine=True ).execute() except HttpError as 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( onBehalfOfContentOwner=content_owner_id, onBehalfOfContentOwnerChannel=options.channelId, 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.) 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 as 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 as 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)
مرحله ۴: ایجاد یک دارایی
برای کسب درآمد از یک ویدیوی یوتیوب، ابتدا باید آن را به یک دارایی (assets) مرتبط کنید. متد 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( onBehalfOfContentOwner=content_owner_id, body=body ).execute() return assets_insert_response["id"]
مرحله ۵: بهروزرسانی مالکیت
قبل از اینکه بتوانید از یک ویدیو کسب درآمد کنید، یوتیوب باید بداند چه کسی مالک دارایی مرتبط است. بنابراین، با ایجاد دارایی، اکنون 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( onBehalfOfContentOwner=content_owner_id, assetId=asset_id, body=body ).execute()
مرحله ۶: ویدیو را درخواست کنید
مرحله بعدی، مرتبط کردن ویدیوی آپلود شده با دارایی مربوطه با ادعای مالکیت ویدیو است. این ادعا، ارتباط بین ویدیو و سیستم مدیریت حقوق یوتیوب را فراهم میکند که مالکیت ویدیو را تثبیت کرده و به مالک امکان میدهد سیاست کسب درآمد را تنظیم کند.
متد claim_video حقوق صوتی و تصویری را مطالبه میکند. اگر پارامتر policyId را در خط فرمان وارد کنید، متد سیاست مشخص شده را برای ویدیو اعمال میکند؛ اگر پارامتر را وارد نکنید، متد سیاست استاندارد "monetize" را اعمال میکند.
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( onBehalfOfContentOwner=content_owner_id, body=body ).execute()
مرحله ۷: گزینههای تبلیغات را تنظیم کنید
ما ویدیو را تصاحب کردهایم و یک سیاست کسب درآمد برای آن اعمال کردهایم. مرحله آخر مشخص کردن نوع تبلیغاتی است که قرار است در ویدیو نمایش داده شود. هر زمان که سیاست «کسب درآمد» اعمال شود، یوتیوب گزینههای تبلیغات را بررسی میکند و پردرآمدترین نوع تبلیغات موجود را نشان میدهد.
این نمونه به یوتیوب میگوید که تبلیغات 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, onBehalfOfContentOwner=content_owner_id, body=body ).execute()
نمونه کد کامل
نمونهی کامل و در حال کار upload_monetize_video_example.py در زیر فهرست شده است:
#!/usr/bin/env python3 # -*- coding: utf-8 -*- # # Copyright 2014 Google Inc. All Rights Reserved. # # 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: $ python3 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: $ python3 upload_monetize_video_example.py --help """ __author__ = 'jeffy+pub@google.com (Jeffrey Posnick)' import argparse import http.client as 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.client import flow_from_clientsecrets from oauth2client.file import Storage from oauth2client.tools import run # 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 Cloud 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 Cloud 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( onBehalfOfContentOwner=content_owner_id, onBehalfOfContentOwnerChannel=options.channelId, 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( onBehalfOfContentOwner=content_owner_id, 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( onBehalfOfContentOwner=content_owner_id, 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( onBehalfOfContentOwner=content_owner_id, 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, onBehalfOfContentOwner=content_owner_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, # onBehalfOfContentOwner=*CONTENT_OWNER_ID*) # 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!")