Загрузка и заявка на видео

Примечание: API данных YouTube предназначен для использования партнерами YouTube по контенту и недоступен всем разработчикам или всем пользователям YouTube. Для доступа требуется учетная запись менеджера контента YouTube. Если у вас есть учетная запись менеджера контента YouTube, но вы не видите API данных YouTube в списке сервисов в консоли Google Cloud , обратитесь к своему назначенному менеджеру по работе с партнерами или в службу поддержки партнеров.

Этот пример кода демонстрирует, как загрузить видео на YouTube и применить к нему политику монетизации. Для монетизации видео необходимо заявить права на видео с помощью asset в системе управления правами YouTube. В примере видео загружается, создается новый ресурс, видео заявляется с помощью этого ресурса, и к видео применяется политика монетизации.

В этом примере представлена ​​последовательность действий вместе с соответствующими разделами кода. Полный скрипт вы найдете в конце этой страницы. Код написан на Python. Также доступны клиентские библиотеки для других популярных языков программирования.

Требования

Шаг 1: Выполнение основных бытовых функций

Первые разделы примера кода выполняют основные вспомогательные функции, общие для многих скриптов: анализ командной строки, аутентификация пользователя и получение необходимых API-сервисов.

Анализ командной строки

Метод parse_options использует OptionParser из клиентской библиотеки Python для создания объекта options , который содержит каждый аргумент командной строки в качестве свойства. Последующие методы извлекают значения из объекта options по мере необходимости.

Ниже перечислены аргументы командной строки для примера скрипта. Первые два ( file и channelId ) обязательны; остальные — необязательны.

  • file : Название и местоположение видеофайла для загрузки.

    Example: --file="/home/path/to/file.mov"
  • channelId : YouTube-канал, на который вы хотите загрузить видео. Канал должен управляться учетной записью YouTube Content Manager авторизованного пользователя. Вы можете получить идентификатор канала в настройках учетной записи 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 Content Manager авторизованного пользователя. По умолчанию используется стандартная политика монетизации 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 в скрипт. Это позволяет пользователю, запускающему скрипт, авторизовать его для выполнения API-запросов, относящихся к учетной записи этого пользователя.

Создайте файл client_secrets.json

Для авторизации, показанной в примере, требуется файл client_secrets.json , содержащий информацию из консоли Google Cloud . Также необходимо зарегистрировать ваше приложение . Более подробное объяснение принципа работы авторизации см. в руководстве по авторизации . Обратите внимание, что для этого примера необходимо настроить в консоли Cloud как YouTube Data API V3, так и службу YouTube Content ID 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 создает объект FLOW , используя данные из файла client_secrets.json , настроенного на предыдущем шаге. Если пользователь разрешает нашему приложению отправлять 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)

Получить услуги

После успешной авторизации мы получаем необходимые сервисы для выполнения желаемых операций. В примере используется API данных YouTube для загрузки видео и API идентификаторов контента YouTube для создания ресурса и подтверждения права собственности на видео. Мы создаём отдельные сервисы для предоставления авторизованного доступа к функциональности двух 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 извлекает идентификатор владельца контента в учетной записи Content Manager авторизованного пользователя. В большинстве учетных записей есть один владелец контента (авторизованный пользователь), но если в учетной записи несколько владельцев контента, метод возвращает первого.

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!")