Videos hochladen und Anspruch darauf erheben

Hinweis:Die YouTube Data API ist für YouTube-Inhaltspartner vorgesehen und nicht für alle Entwickler oder YouTube-Nutzer verfügbar. Für den Zugriff ist ein YouTube Content-Manager-Konto erforderlich. Wenn Sie ein YouTube Content Manager-Konto haben, die YouTube Data API aber nicht als einer der Dienste in der Google Cloud Console aufgeführt ist, wenden Sie sich an Ihren zugewiesenen Partnermanager oder den Partnersupport.

Dieses Codebeispiel zeigt, wie Sie ein YouTube-Video hochladen und eine Monetarisierungsrichtlinie darauf anwenden. Wenn du mit einem Video Einnahmen erzielen möchtest, musst du im Rechteverwaltungssystem von YouTube mit einem asset Anspruch auf das Video erheben. Im Beispiel wird das Video hochgeladen, ein neues Asset erstellt, Anspruch auf das Video mit dem Asset erhoben und eine Monetarisierungsrichtlinie auf das Video angewendet.

Dieses Beispiel wird als Reihe von Schritten zusammen mit den relevanten Abschnitten des Codes dargestellt. Das vollständige Script finden Sie am Ende dieser Seite. Der Code ist in Python geschrieben. Clientbibliotheken für andere gängige Programmiersprachen sind ebenfalls verfügbar.

Voraussetzungen

Schritt 1: Allgemeine Aufräumfunktionen

In den ersten Abschnitten des Codebeispiels werden grundlegende Verwaltungsfunktionen ausgeführt, die in vielen Skripten üblich sind: Die Befehlszeile wird geparst, der Nutzer wird authentifiziert und die erforderlichen API-Dienste werden abgerufen.

Befehlszeile parsen

Die Methode parse_options verwendet OptionParser aus der Python-Clientbibliothek, um ein options-Objekt zu erstellen, das jedes Befehlszeilenargument als Attribut enthält. Mit nachfolgenden Methoden werden bei Bedarf Werte aus dem options-Objekt abgerufen.

Die Befehlszeilenargumente des Beispielskripts sind unten aufgeführt. Die ersten beiden (file und channelId) sind erforderlich, die restlichen sind optional.

  • file: Der Name und Speicherort der hochzuladenden Videodatei.

    Example: --file="/home/path/to/file.mov"
  • channelId: Der YouTube-Kanal, auf den Sie das Video hochladen möchten. Der Kanal muss über das YouTube Content-Manager-Konto des authentifizierten Nutzers verwaltet werden. Sie können die Kanal-ID in den YouTube-Kontoeinstellungen für den authentifizierten Nutzer oder mit der Methode channels.list abrufen.

    Example: --channelId="UC_x5XG1OV2P6uZZ5FSM9Ttw"
  • title: Ein Titel für das Video, das du hochlädst. Der Standardwert ist Test title.

    Example: --title="Summer vacation in California"
  • description: Eine Beschreibung des Videos, das du hochlädst. Der Standardwert ist Test description.

    Example: --description="Had a great time surfing in Santa Cruz"
  • category: Die Kategorie-ID für die YouTube-Videokategorie, die dem Video zugeordnet ist. Der Standardwert ist 22, was sich auf die Kategorie People & Blogs bezieht.

    Example: --category=22
  • keywords: Eine durch Kommas getrennte Liste von Keywords, die mit dem Video verknüpft sind. Der Standardwert ist ein leerer String.

    Example: --keywords="surfing, beach volleyball"
  • privacyStatus: Der Datenschutzstatus des Videos. Standardmäßig ist ein hochgeladenes Video öffentlich sichtbar (public). Wenn du Testvideos hochlädst, solltest du möglicherweise einen --privacyStatus-Argumentwert angeben, um sicherzustellen, dass diese Videos privat oder nicht gelistet sind. Gültige Werte sind public, private und unlisted.

    Example: --privacyStatus="private"
  • policyId: Die Monetarisierungsrichtlinie, die auf das hochgeladene Video angewendet werden soll. Die Richtlinie muss mit dem YouTube Content-Manager-Konto des authentifizierten Nutzers verknüpft sein. Die Standardeinstellung ist die Standard-YouTube-Richtlinie zur Monetarisierung.

    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()

Anfrage autorisieren

In diesem Schritt wird die OAuth 2.0-Autorisierung in das Script eingebunden. So kann der Nutzer, der das Skript ausführt, das Skript autorisieren, API-Anfragen auszuführen, die dem Konto des Nutzers zugeordnet sind.

Datei „client_secrets.json“ erstellen

Für die im Beispiel gezeigte Autorisierungsart ist eine client_secrets.json-Datei erforderlich, die Informationen aus der Google Cloud Console enthält. Außerdem müssen Sie Ihre Anwendung registrieren. Eine ausführlichere Erklärung zur Autorisierung finden Sie in der Autorisierungsanleitung. Für dieses Beispiel müssen sowohl die YouTube Data API V3 als auch der YouTube Content ID API-Dienst in der Cloud Console für Ihr Projekt konfiguriert sein.

 {
  "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"
  }
}

Autorisierungscode im Skript

Das Skript enthält die folgenden import-Anweisungen, um die Nutzerauthentifizierung und ‑autorisierung zu ermöglichen:

from oauth2client.file import Storage
from oauth2client.client import flow_from_clientsecrets
from oauth2client.tools import run

Als Nächstes wird mit der Methode get_authenticated_services ein FLOW-Objekt aus den Daten der im vorherigen Schritt konfigurierten Datei client_secrets.json erstellt. Wenn der Nutzer unsere Anwendung autorisiert, API-Anfragen in seinem Namen zu senden, werden die resultierenden Anmeldedaten zur späteren Verwendung in einem Storage-Objekt gespeichert. Der Nutzer muss unsere Anwendung neu autorisieren, wenn die Anmeldedaten ablaufen.

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)

Dienste abrufen

Nach erfolgreicher Autorisierung erhalten wir die erforderlichen Dienste für die Vorgänge, die wir ausführen möchten. In diesem Beispiel werden die YouTube Data API zum Hochladen des Videos und die YouTube Content ID API zum Erstellen des Assets und zum Erheben eines Anspruchs auf das Video verwendet. Wir erstellen separate Dienste, um autorisierten Zugriff auf die Funktionen der beiden APIs zu ermöglichen.

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)

Schritt 2: Inhaber der Inhalte ermitteln

Um Assets zu erstellen und Ansprüche zu erheben, muss der authentifizierte Nutzer ein YouTube Content-Manager-Konto haben. Das Content-Manager-Konto enthält die Objekte zur Rechteverwaltung für einen oder mehrere Rechteinhaber. Der Rechteinhaber ist der Inhaber des Urheberrechts, der das Recht hat, zu entscheiden, ob ein Video monetarisiert, beobachtet oder gesperrt werden soll.

Die Methode get_content_owner ruft die ID des Rechteinhabers im Content Manager-Konto des authentifizierten Nutzers ab. Die meisten Konten haben nur einen Rechteinhaber (den authentifizierten Nutzer). Wenn das Konto jedoch mehrere Rechteinhaber hat, wird der erste zurückgegeben.

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"]

Schritt 3: Video hochladen

Zum Hochladen eines Videos erstellen wir eine partielle JSON-Ressource, die das Video repräsentiert, und übergeben sie an die videos.insert-Methode. Wir legen die Videometadaten mit Werten aus dem options-Objekt fest, das beim Parsen der Befehlszeile erstellt wurde. Für die Mediendatei selbst verwenden wir MediaFileUpload, um fortsetzbare Uploads zu ermöglichen. Weitere Informationen finden Sie unter Video hochladen.

Die Methode upload gibt die Video-ID für das neue Video zurück. Das Skript muss diesen Wert in späteren Schritten an andere Methoden übergeben.

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)

Schritt 4: Asset erstellen

Wenn du mit einem YouTube-Video Einnahmen erzielen möchtest, musst du es zuerst einem Asset zuordnen. Mit der Methode create_asset wird ein neues Asset für das neu hochgeladene Video erstellt.

Genau wie beim Video erstellen wir eine partielle JSON-Ressource, die den Typ des zu erstellenden Assets (ein Webvideo) angibt und einen Titel und eine Beschreibung für das neue Asset enthält. Wir übergeben die JSON-Ressource an die Methode assets.insert, die das Asset erstellt und seine eindeutige ID zurückgibt. Auch hier muss das Skript diesen Wert in späteren Schritten an andere Methoden übergeben.

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"]

Schritt 5: Eigentümerschaft aktualisieren

Bevor du mit einem Video Einnahmen erzielen kannst, muss YouTube wissen, wem das zugehörige Asset gehört. Nachdem das Asset erstellt wurde, konfigurieren wir nun die ownership des Assets. Im Beispiel wird angegeben, dass der Rechteinhaber weltweit Eigentümer des Assets ist.

  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()

Schritt 6: Anspruch auf das Video erheben

Im nächsten Schritt musst du das hochgeladene Video mit dem entsprechenden Asset verknüpfen, indem du Anspruch auf das Video erhebst. Der Anspruch stellt die Verbindung zwischen dem Video und dem Rechteverwaltungssystem von YouTube her. Dadurch wird das Eigentum an dem Video festgelegt und der Rechteinhaber kann eine Monetarisierungsrichtlinie festlegen.

Mit der Methode claim_video werden audiovisuelle Rechte beansprucht. Wenn Sie den Parameter policyId in der Befehlszeile angeben, wendet die Methode die angegebene Richtlinie auf das Video an. Wenn Sie den Parameter nicht angeben, wendet die Methode die Standardrichtlinie „Monetarisieren“ an.

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()

Schritt 7: Werbeoptionen festlegen

Wir haben Anspruch auf das Video erhoben und eine Monetarisierungsrichtlinie darauf angewendet. Im letzten Schritt legen Sie fest, welche Arten von Anzeigen im Video präsentiert werden sollen. Wenn die Monetarisierungsrichtlinie gilt, prüft YouTube die Werbeoptionen und zeigt die Anzeigenart mit dem höchsten Umsatzpotenzial an.

Durch das Beispiel wird YouTube angewiesen, In-Stream-Anzeigen TrueView mit diesem Video auszuliefern.

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()

Vollständiges Codebeispiel

Das vollständige funktionierende Beispiel upload_monetize_video_example.py ist unten aufgeführt:

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