YouTube Connection

Introduction

This document provides a step-by-step guide on connecting YouTube with Rivery. Through this integration, users can simplify data workflows, and consolidate data for analytical purposes.

Prerequisites

There are 2 authentication methods available:

1. OAuth.
2. Custom Application (Located within the Advanced Options).

Prior to proceeding, ensure that you meet the following prerequisites:

• For OAuth authentication, all you need is a Gmail account linked to your YouTube account.
• For Custom Application authentication, which entails a connection with a Google application, a paid subscription to Google Cloud Platform (GCP) is required. If you don't have one, sign up.
  Also, ensure the functionality of your Consent Screen Application. If not created, follow instructions for configuring OAuth consent screen and selecting scopes under Google Workspace.

Before creating a connection between YouTube and Rivery, it is essential to review and comply with YouTube's Terms of Service and Google's Privacy Policy. By proceeding with the integration, users acknowledge their understanding and acceptance of these terms.

YouTube Terms of Service

Please review YouTube's Terms of Service.

Google Privacy Policy

For information on how Google handles user data, refer to Google's Privacy Policy.

Please Note:
By continuing with the integration process, users are bound by the terms outlined in the provided links. It is recommended to thoroughly read and understand these documents to ensure compliance with the respective policies.

Setting up a Custom Application (Optional)

Users have the option to enhance flexibility by creating their own applications through Google APIs, enabling seamless integration with YouTube on Rivery.
This section outlines the steps involved in creating such an application and integrating it with Rivery.

Enable the API in Google Cloud Platform

1. Log in to your Google Cloud Platform account.

2. Go to "Enable APIs & Services" section.
   

3. Click on "Enabled APIs And Services" to access the list of APIs that are currently enabled.
   

4. In the search bar, enter the name of the Google API you want to enable.

5. Select the desired API from the search results.

6. Click on the "Enable" button to enable the API.

   

Create Credentials for Rivery Integration

1. In the "APIs & Services" section, go to "Credentials".
   

2. Click on the "Create Credentials" dropdown.

3. Select "OAuth Client ID" from the list.
   

4. Choose "Web Application" as the application type.
   

5. Provide a name for your credentials, such as "Rivery OAuth".

6. Configure Authorized JavaScript Origins:
   Under "Authorized JavaScript origins", add the following URIs:

https://console.rivery.io

https://eu-west-1.console.rivery.io

https://eu-central-1.console.rivery.io

7. Configure Authorized Redirect URIs:
   Under "Authorized redirect URIs", add the following URIs:

https://console.rivery.io/api/oauthcallback/google

https://eu-west-1.console.rivery.io/api/oauthcallback/google

https://eu-central-1.console.rivery.io/api/oauthcallback/google

8. Click on the "Create" button to create the OAuth client ID.

9. Copy Client ID and Client Secret:
   Once the OAuth client is created, copy the Client ID and Client Secret provided.
   Optionally, if you wish to retain these details, click on "Download JSON" to save the credentials in JSON format.

   

10. Add Required Scopes:
    Navigate to "APIs & Services" → "OAuth Consent Screen" and click on "Edit App".

    

11. Proceed to "Scopes" and click on "Add or Remove Scopes".
    

12. Add the following Scopes:

https://www.googleapis.com/auth/yt-analytics.readonly

https://www.googleapis.com/auth/yt-analytics-monetary.readonly,

https://www.googleapis.com/auth/youtube.readonly

13. Proceed with "Save and Continue," then select the Test Users you wish to connect with Rivery. If your application's user type is External and its status is set to Testing, only these designated users will be able to establish connections using this application.

14. Now, the only step remaining is to establish a connection in Rivery.

Establish a Connection

1. Assign a name to your connection.
2. Choose Authentication Type:

   • OAuth:
     a. Click on the "Connect with Youtube" button.
     Make sure your browser doesn't block pop-ups.
     b. A window will appear, requesting your authorization for Rivery to access your Google account. To proceed, click on "Allow".

   • Custom Application:
     a. Enter Client ID.
     b. Input Client Secret.
     c. Click on the "Connect with Youtube" button.
     Make sure your browser doesn't block pop-ups.
     d. A window will appear, requesting your authorization for Rivery to access your Google account. To proceed, click on "Allow".

Please Note:

• If nothing happens after you've clicked the "Connect with Youtube" button, it is likely because your browser has blocked the pop up:

• On the right side of the URL in your browser, you will find a "pop-up blocked" button:

• Click on it and select "Always allow popups from Rivery".
• Click again and sign in with Google button and a pop up to connect to Google will show up on your screen.

3. Click on "Save" in order to save the connection in your Rivery account.
4. Click on "Test connection". If the test is successful, you are prepared to begin working with YouTube.

Disconnecting from YouTube Connection

• In order to disconnect from YouTube connection, click on X Remove button in the connection.
• If you wish to unlink Rivery's application from your Google user, please consult the privacy settings for your user account on Google.