Configure a YouTube Content Connector

After you configure and enable a YouTube content connector, you can connect to YouTube and pull required content from it into Oracle Content Management.

To configure a YouTube content connector:

  1. Get the Oracle Content Management host name and authorization URL details.
    1. Sign in to Oracle Content Management as an Administrator or Developer.
    2. Click Integrations in the Administration area of the navigation menu on the left.
    3. In the Integrations menu, choose Content Connectors.
    4. Click the check box next to the Youtube content connector.
    5. Click Create.
    6. You can override the default content connector settings, as described in Enable a Content Connector.
  2. Enter any name and give the Connector Service URL.
  3. Click Verify Settings.

    This lists the custom fields of the YouTube content connector.

    In the Connector Tags field, you can assign tags for assets that the content connector pulls into Oracle Content Management.

  4. Sign in to https://console.developers.google.com/ and create a new project.

    Give your project a name, and click CREATE.

  5. Go to the project and the Library page from the left corner icon in the navigation menu, and click ENABLE APIS AND SERVICES.
  6. Search for the Youtube Data API v3 library, select it, and enable it.
  7. Click Create Credentials and then API key in the drop-down menu. Note the value of API Key. This is the Developer Key you'll enter in Oracle Content Management when you configure the YouTube connector.
  8. Specify a value for Application Name, which can be anything.
  9. Click Save.
  10. Make sure Enabled for end users is selected.

    You can review the Terms of use and Privacy Policy below the Enable for end users button.

  11. Map source metadata to content types for the connector.

    When you configure a content connector, you can do field mapping from source metadata to content type fields. A repository administrator or system administrator can allow creation of content types for a connector. You can create content types on the Mappings tab of the Connector Settings page. To map source metadata to a content type:

    1. Sign in to Oracle Content Management as a system administrator and click Integrations under Administration in the left navigation menu.
    2. On the Assets page, click Create.
    3. On the Create Repository page, define your repository.
      1. Specify the connector name, publishing channels, languages, and other options.
      2. Under the Connectors option, select Youtube from the drop-down menu to associate the YouTube content connector with the repository. On the Create/Edit Repository page, if you add the connector 'Youtube', the content type 'YoutubeVideos' will automatically be assigned.

        If the YouTube connector has content types associated with it, the types appear under the Content Types option. If you want the content connector to have additional fields, you can add them on the Mappings tab of the Connector Settings page.

        If the Allow Content Type Creation check box on the General tab is selected, the mapping of source metadata to Oracle Content Management content types will be automatically populated. You can change the automatic mapping on the Connector Settings page.

    4. If the Allow Content Type Creation check box on the General tab is not selected, you need to map the source metadata to Oracle Content Management content types on the Connector Settings page:
      1. On the Mappings tab, choose a source type from the Source Content Type drop-down menu and an Oracle Content Management type from the OCE Content Type drop-down menu, such as YoutubeVideos, to map the Source Data Field to the Target Data Field.
      2. Repeat for each source content type.
      3. Click Save.
      4. Enable a Content Connector.

        This type mapping must be done for all source types before the content connector is enabled. If you want to change the mapping, you need to disable the connector, make your changes, and then enable the connector again. Whenever an administrator saves the connector after modifying a content type, the connector framework will attempt to seed the content type again. If you remove any associated content type that is required for the selected connector, the save will fail.

  12. Associate the connector with one or more asset repositories.
    1. Click Assets in the Administration area of the navigation menu on the left.
    2. Open an existing repository, or click Create to create a new one.
    3. If you're creating a new repository, specify the repository name, publishing channels, languages, and other options. You need to configure the languages that are expected from the connector. For example, some of the languages that YouTube supports are en, en-CB, and en-AU. If these are not configured, content item creation may fail.
    4. Under Connectors, select Youtube to associate the YouTube content connector with the repository.

      This menu lists all the content connectors that have been configured and enabled in your Oracle Content Management instance.

      If any of the connectors you select have content types associated with them, the types appear under Content Types. On the Create/Edit Repository page, if you add the connector 'Youtube', the content type 'YoutubeVideos' will be automatically assigned.