Upload content to your Aspera dropbox

The features described in this article are available only to partners who use YouTube's Content Manager to manage their copyrighted content.

After validating the metadata for an upload batch, you're ready to upload the files. You upload content by copying the necessary files into your dropbox, then letting us know that they are ready by creating a file named delivery.complete.

Which files you need to complete an upload depends on which asset type you’re uploading. Every upload job must include a metadata file in XML or CSV format and any new media files that the metadata file references by name.

We recommend uploading new assets one at a time, each with its own dropbox folder and metadata file. For example, if you’re uploading three episodes of a TV program, create three separate folders and three separate metadata files. This approach makes it easier to track the progress of the upload and limits the impact of any issues that occur, without any impact on the upload processing speed.

(Other recommended best practices)
The weekly maintenance window for Aspera dropboxes is Monday from 1am-5am Pacific time. If you upload content during that time, your Aspera client may be disconnected from the dropbox. If that happens, reconnect to the dropbox after five to ten minutes and redeliver the complete file.

To upload content to your Aspera dropbox:

  1. Open your Aspera client.

  2. Select the connection for your dropbox in the Connection box on the right, then click the Connect button.

    The Aspera client connects to your dropbox and displays the top-level folders.

    If you haven't set up a connection for your dropbox yet, see Connecting to your Aspera dropbox.

  3. Create a new folder for the new upload job.

    To create a folder, right-click on the parent folder and select New > Folder. To avoid possible conflicts, we recommend that you create a new directory each time you post content and that you include a timestamp or incremental ID in each directory's name.

  4. Copy all of the files for the upload package into the new folder.

    To copy files into a folder, make sure the intended folder is open on the right, highlight the files in the box on the left, and click the right-facing arrow.

  5. When all files are copied, upload the delivery.complete file to the same folder.

You must not add any new files to the directory or any of its subdirectories after posting the delivery.complete file. Depending on the size of the batch, it can take a few seconds or minutes before you notice the files being processed. Do not upload more than one delivery.complete file per batch.

After processing each upload batch, the upload engine posts a status report detailing the actions taken for each item in the batch. The report is named status-xml-filename, where xml-filename is the filename of your metadata file. The status report is placed in your dropbox in the same directory as the upload batch.

The time needed to process an upload batch and generate a status report varies depending on system load and the actions requested. For example, the system requires much less time to process updates to an asset's metadata than to process new reference files. The upload engine will also spend additional processing time on batches that generate failed actions, because the system retries certain failed actions to ensure that failures were not caused by transient conditions such as system downtime. In some cases, we may require more than one day to process an upload batch.

Was this helpful?
How can we improve it?
Clear search
Close search
Google apps
Main menu
Search Help Center