You are here: Administrators Reference > Site Administration > Multimedia Services > Integrating YouTube and CommonSpot

Integrating YouTube and CommonSpot

This release supports automated integration of YouTube multimedia content in CommonSpot. Adding YouTube services to CommonSpot requires you to:

  1. Log in to the Google/YouTube API console with a dedicated gmail account.

    IMPORTANT NOTE: If you are logged in to any other gmail accounts or google services in this browser or other instances or other tabs in the same browser, log out of all those accounts while setting up this account.
  2. Register a new product.
  3. Create a new project associated with the YouTube service.
  4. Configure access in CommonSpot.

You can find good general instructions for registering a YouTube app under "Register your application with Google" on https://developers.google.com/youtube/2.0/developers_guide_protocol#Authentication. (Search for "YouTube authentication" if this page has moved.)

NOTE: These instructions use:

http://code.google.com/apis/youtube/dashboard/

as the starting point. Log in to this dashboard using your Google login credentials. Alternatively, start at the cloud console, and use these instructions as guidelines:

https://cloud.google.com/developers/

For the most up-to-date instructions see (or search for):

https://developers.google.com/youtube/getting_started

On the Google site:

  1. If this is your first time using the API console, review the Google recommendations for developer-specific accounts and create or use an account appropriate for permanent association with this application. Accept the Terms of Service and click the Register button.

    Mouseover to view larger

  2. The Register A New Product form displays. Name is required. Enter a name appropriate for identifying this channel in CommonSpot, an optional description, and the domain or IP address of the CommonSpot server through which YouTube content will be served. For testing, localhost:{your port} will work. Note: Your local ColdFusion instance name will not work.

    Mouseover to view larger

  3. Click the Save button. The dashboard confirms app creation and displays the Google-generated Developer key. Use this key when creating CommonSpot-managed YouTube channels. See Site Admin - Multimedia Services - External Services - Add Multimedia Channel.

    Mouseover to view larger

  4. Go to: https://code.google.com/apis/console. (Clicking the here link in the "You may request a client key ..." statement below the developer key takes you to this page in a new tab.) Note that you can optionally navigate to, or, if you have other projects, may automatically be redirected to the google cloud console. If this is your first time using the API console, accept the terms of service to continue.
  5. From the left-hand API Project dropdown select Create, enter a project name, and click Create Project.
  6. Scroll down the right hand panel to enable YouTube Analytics API and YouTube Data API v3 (click the OFF button to activate these APIs). After you accept the Terms of Service for the first API, the Services panel redisplays with the YouTube APIs set to ON.
  7. Click the API Access option in the left side panel.
  8. Click the Create an OAuth 2.0 client ID button and re-enter the product name from step 2 above, optionally including a branding image in response to the prompt, then click Next.
  9. In the Create Client ID dialog, choose Web application and re-enter your CommonSpot site URL from step 2 above.

    Mouseover to view larger

    Note that you must exclude the protocol prefix for this address and select the proper protocol in the left side dropdown, for example, http://. The Redirect URL field updates with your information. Then click Create client ID.

  10. The API Access page refreshes with the Google-generated IDs.

    Mouseover to view larger

    Click Edit Settings for this ID.

    In the Authorized Redirect URLs field, enter {www.yourwebsite.com}/commonspot/controls/object/multimedia/auth-callback.cfm.

    In the Authorized Javascript Origins field, enter {www.yourwebsite.com}, as shown below, and click Update.

  11. In a new tab, go to “https://www.youtube.com/account” and log in using the same credentials used for the gmail account created in step 1.
  12. Click the Advanced link next to Name in Account settings and note the YouTube User ID.

    If you do not have a channel already, create a YouTube channel by clicking the Create Channel link next to your YouTube name.

You can now create YouTube channels managed by CommonSpot.

In CommonSpot:

  1. Open Site Admin - Multimedia Services - External Services and select the YouTube service. Click the channel link and copy the following values generated by the Google registration process to the Add/Edit Multimedia Channel dialog:
  2. Save the CommonSpot channel dialog. To complete registration, click the registration flag for the channel in the Multimedia Channels dialog. The following message displays:

    Access Status:

    You need to log in to the YouTube user account associated with this channel for granting access to CommonSpot. If you do not have the YouTube user account credentials, please select Cancel to abort.

    If you continue and fail to log in to your YouTube account, this channel and the objects (multimedia files and playlists) associated with this channel will be unavailable to use through CommonSpot.

    Click OK.

  3. A new window with your Google accounts displays with a redirect to login if you are not already logged in. After login both your Gmail Account and the YouTube Account with the Channel Name display. Selecting the one with your channel name redirects to a page requesting permission to allow CommonSpot to Manage your YouTube account.

    {your product name} is requesting permission to:

    Manage your YouTube account

    Perform these operations when I'm not using the application

    Click Allow Access to update the channel you just created with the Google returned Auth Token and close this dialog.

  4. Refresh the Multimedia Channels dialog in CommonSpot.

    A green flag confirms successful registration with YouTube. If properly set up, the following message displays when you click this flag:

    Access Status:

    Commonspot has been granted API access to this YouTube account.

 

Related Links


You can download PDF versions of the Content Contributor's, Administrator's, and Elements Reference documents from the support section of paperthin.com (requires login).


For technical support:

http://www.paperthin.com/support/