ملاحظة: إنّ واجهة YouTube Data API مخصّصة لشركاء المحتوى في YouTube، ولا يمكن لجميع المطوّرين أو جميع مستخدمي YouTube الوصول إليها. يتطلّب الوصول إلى هذه الميزة حسابًا على "إدارة المحتوى" في YouTube. إذا كان لديك حساب على "إدارة المحتوى" في YouTube ولكنّك لا ترى YouTube Data API كإحدى الخدمات المُدرَجة في وحدة تحكّم Google Cloud، يُرجى التواصل مع مدير الشركاء أو فريق دعم الشركاء المخصّص لك.
يوضّح نموذج الرمز البرمجي هذا كيفية تحميل فيديو على YouTube وتطبيق سياسة تحقيق الربح عليه. لتحقيق الربح من فيديو، يجب المطالبة بملكيته باستخدام asset في نظام إدارة الحقوق في YouTube. يحمّل النموذج الفيديو، وينشئ مادة عرض جديدة، ويطالب بملكية الفيديو باستخدام مادة العرض، ويطبّق سياسة تحقيق الربح على الفيديو.
يتم تقديم هذا المثال كسلسلة من الخطوات المتّبعة مع الأقسام ذات الصلة من الرمز. يمكنك العثور على النص الكامل في نهاية هذه الصفحة. الرمز مكتوب بلغة Python. تتوفّر أيضًا مكتبات برامج للغات برمجة شائعة أخرى.
المتطلبات
- الإصدار 3.7 أو الإصدارات الأحدث من Python
- google-api-python-client
الخطوة 1: وظائف التنظيف الشائعة
تنفّذ الأقسام الأولى من عينة التعليمات البرمجية وظائف أساسية مشتركة بين العديد من النصوص البرمجية: تحليل سطر الأوامر، ومصادقة المستخدم، والحصول على خدمات واجهة برمجة التطبيقات اللازمة.
تحليل سطر الأوامر
تستخدِم الدالة parse_options الدالة OptionParser من مكتبة برامج Python للعميل لإنشاء عنصر 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 = 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 في النص البرمجي. يتيح ذلك للمستخدم الذي يشغّل البرنامج النصي تفويض البرنامج النصي بتنفيذ طلبات واجهة برمجة التطبيقات التي يتم إسنادها إلى حساب المستخدم.
إنشاء ملف client_secrets.json
يتطلّب نوع التفويض الموضّح في النموذج ملف client_secrets.json يحتوي على معلومات من وحدة تحكّم Google Cloud لإجراء التفويض. عليك أيضًا تسجيل تطبيقك. للحصول على شرح أكثر اكتمالاً حول طريقة عمل التفويض، يُرجى الاطّلاع على دليل التفويض. يُرجى العِلم أنّ هذا النموذج يتطلّب إعداد كلّ من YouTube Data API V3 وخدمة YouTube Content ID API في Cloud Console لمشروعك.
{ "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 عنصر FLOW باستخدام البيانات من ملف client_secrets.json الذي تم إعداده في الخطوة السابقة. إذا سمح المستخدم لتطبيقنا بإرسال طلبات إلى واجهة برمجة التطبيقات نيابةً عنه، يتم تخزين بيانات الاعتماد الناتجة في عنصر 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 لإنشاء مادة العرض والمطالبة بملكية الفيديو. ننشئ خدمات منفصلة لتوفير إذن الوصول إلى وظائف واجهتَي برمجة التطبيقات.
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)
الخطوة 2: تحديد مالك المحتوى
لإنشاء مواد عرض وتقديم مطالبات، يجب أن يكون لدى المستخدم الذي تمّت المصادقة عليه حساب على "إدارة المحتوى" في 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 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"]
الخطوة 3: تحميل الفيديو
لتحميل فيديو، ننشئ مصدر 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)
الخطوة 4: إنشاء مادة عرض
لتحقيق الربح من فيديو على 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( onBehalfOfContentOwner=content_owner_id, body=body ).execute() return assets_insert_response["id"]
الخطوة 5: تعديل الملكية
قبل أن تتمكّن من تحقيق الربح من فيديو، يجب أن يعرف 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( onBehalfOfContentOwner=content_owner_id, assetId=asset_id, body=body ).execute()
الخطوة 6: المطالبة بالفيديو
الخطوة التالية هي ربط الفيديو الذي تم تحميله بمادة العرض المقابلة من خلال المطالبة بملكية الفيديو. توفّر المطالبة الرابط بين الفيديو ونظام إدارة الحقوق في 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( onBehalfOfContentOwner=content_owner_id, body=body ).execute()
الخطوة 7: ضبط خيارات الإعلانات
لقد طالبنا بملكية الفيديو وطبّقنا عليه سياسة تحقيق الربح. تتمثّل الخطوة الأخيرة في تحديد نوع الإعلانات التي سيتم عرضها في الفيديو. عندما تنطبق سياسة "تحقيق الربح"، يتحقّق 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, 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!")