تحميل فيديو والمطالبة به

ملاحظة: إنّ واجهة برمجة تطبيقات Content ID في YouTube مخصّصة للاستخدام من قِبل شركاء المحتوى في YouTube، ولا يمكن لبعض المطوّرين أو جميع مستخدمي YouTube الوصول إليها. إذا لم تظهر واجهة Content ID API في YouTube على أنّها إحدى الخدمات المدرَجة في وحدة التحكم في واجهة Google API، يمكنك مراجعة مركز مساعدة YouTube للاطّلاع على المزيد من المعلومات حول "برنامج شركاء YouTube".

يعرض نموذج الرمز هذا كيفية تحميل فيديو إلى YouTube وتطبيق سياسة تحقيق الربح عليه. لتحقيق الربح من فيديو، عليك المطالبة به باستخدام asset في نظام إدارة الحقوق على YouTube. في هذه العملية، يتم تحميل الفيديو وإنشاء مادة عرض جديدة والمطالبة بملكية الفيديو باستخدام مادة العرض وتطبيق سياسة تحقيق الربح على الفيديو.

يتم تقديم هذا المثال على أنه سلسلة من الخطوات المتضمنة مع الأقسام ذات الصلة من التعليمة البرمجية. يمكنك العثور على النصّ البرمجي بالكامل في نهاية هذه الصفحة. الرمز مكتوب بلغة بايثون. تتوفر أيضًا مكتبات برامج للغات البرمجة الشائعة الأخرى.

المتطلبات

الخطوة 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 = 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 في النص البرمجي. يتيح ذلك للمستخدم الذي يشغِّل النص البرمجي السماح للنص البرمجي بتنفيذ طلبات بيانات من واجهة برمجة التطبيقات المنسوبة إلى حساب المستخدم.

إنشاء ملف client_secrets.json

يتطلب نوع التفويض المعروض في النموذج ملف client_secrets.json، يحتوي على معلومات من وحدة التحكم في واجهة Google API، لإجراء التفويض. يجب أيضًا تسجيل طلبك. للحصول على شرح أكثر شمولاً حول آلية عمل التفويض، يمكنك الاطّلاع على دليل التفويض. تجدر الإشارة إلى أنّ هذا النموذج يتطلّب إعداد كل من YouTube Data API V3 وخدمة واجهة برمجة تطبيقات Content ID في YouTube في وحدة تحكّم واجهة برمجة التطبيقات الخاصة بمشروعك.

 {
  "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, 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.) 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)

الخطوة 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/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(
    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!")