Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This page describes how to configure Integration Endpoint to upload video assets to Youtube.

Pre-requisites:

You need a developers account and a project (Check out this guide for more info: https://developers.google.com/youtube/v3/getting-started)

...

When you have enabled it, then you will be able to select it and see the following view:

Initialization & Configuration

Access your MM, and enter Settings.

...

The following steps will guide you to fill this form out correctly.

Title

Simply name your integration endpoint something descriptive.

Folder ID

In your DAM Center ("DC" henceforth), you must create a new folder.

...

Input the number into your integration form.

Google Information (Secret Client, User Id, Redirect Uri)

You need to fill in some additional google information which is important

  1. ClientSecretJsonString: 
    1. Can be found here (see section about obtaining youtube client secret below):
  2. Refresh Token: Please ignore this field
  3. UserId: The email of the account that should be used to upload. Usually a Gmail email.
  4. Redirect URI: The URL of your DC with the following appended "/api/v1/IntegrationEndpoint/google-integration-signin". Example: https://YOURDC/api/v1/IntegrationEndpoint/google-integration-signin (from the Digizuite API)


Obtaining your Youtube client secret

Access https://console.cloud.google.com/apis/api/youtube.googleapis.com/credentials and log in as your Google user.

...

The contents of the Json file is the secret. All of it must be copied into ClientSecretJsonString textfield.

Obtaining the Refresh Token and become Authenticated

The Integration Service now has an endpoint which will provide you with a login URL for google. It uses the definitions on the endpoint to create the google auth URL such as client id, redirect uri. A swagger screenshot can be sen here and it is important to authorize using a digizuite access key to be able to generate the result.

...

https://accounts.google.com/o/oauth2/v2/auth?access_type=offline&response_type=code&client_id={CLIENT_ID}&redirect_uri=https://YOURDAMIN/digizuitecore/api/v1/google-integration-signin&scope=https://www.googleapis.com/auth/youtube.upload&state=02015ede-eded-4844-a4f1-ca568cea7d9b

...

  1. Client ID
  2. Redirect URI (as described above - has to be the digizuite integration api)
  3. Uid of the integration endpoint to use
Copy and pasting the link into your browser will ensure that you are validated by google and give you this mesage:


Ensuring that the redirect URL corresponds to an authorized redirect URL (where you configure your secrets):

...

But at the same time ensure that the domain is authorized on your account:

Events Definition

For the type of events which export to Youtube will trigger on, please go to the page named "4.6 Integration Endpoint" to get a full overview.

In this context, it would most sense to subscribe to profile which handles video publishing (only to the channel that has been configured) + unpublish/publish as shown here:

Search name

In the Search name field input "exportSearch"

...

Please look at for more info if in doubt.

Export media format ID

Go to formats in the DC and get the format ID that corresponds to the published profiles you are "subscribing" to. (In the field "Subscribe to profiles")

...

In here you can see a list of export formats and the ID to the very left. (In this case 50038)

Test the Integration

You can easily test the integration by dragging in a video to the Youtube channel folder (and make sure that it actually uses the right profile on publishing).

...