YouTube#

Follow these steps to configure YouTube for Social Feeds.

Connecting to YouTube#

Connect to the Google API#

  1. Go to the Google API Console.
  2. Select an existing project or create a new one.
  3. If you have already setup your OAuth Consent Screen, you can skip this step.
    1. Go to the API & ServicesOAuth Consent Screen.
    2. Select External for the User Type setting and click the Create button.
    3. Fill in the mandatory fields as applicable and click the Save and continue button.
    4. Leave the Scopes blank, and click the Save and continue button.
  4. Next, go to the APIs & ServicesCredentials section.
  5. Click Create CredentialsOAuth client ID.
    1. On the following page, select the Application Type as Web application.
    2. Provide a suitable Name so you can identify it in your Google account. This is not required by {plugin}.
    3. Under the Authorized JavaScript origins, click Add URI and enter your project's Site URL.
    4. Under the Authorized redirect URIs, click Add URI and enter the value from the Redirect URI field in Social Feeds.
    5. Then click the Create button.
  6. Once created, a popup will appear with your OAuth credentials. Copy the Client ID and Client Secret values and paste into the fields in Social Feeds.

Local Testing Proxy#

Google requires your Craft install to be on a public domain with SSL enabled. However, you can test out functionality by using the Proxy Redirect URI setting. What this does is modify the URL for the redirect to Verbb servers, to redirect back to your install.

For example, you might have a Redirect URI like the following:

http://my-site.test/social-feeds/auth/callback

Using this URL for Google won't work, as it'll detect .test is a non-public domain name. Using the Proxy Redirect URI will change the redirect URL to be:

https://proxy.verbb.io?return=http://my-site.test/social-feeds/auth/callback

Here, it routes the request through to our Verbb servers, which forwards on the request to the URL in the return parameter (which would be your local project).

Available Content#

Twitter provides the following types of content as posts.

  • Channel (Videos from any YouTube channel)
  • User (Videos from any YouTube user)
  • Playlist (Videos from any YouTube playlist)
  • Search (Videos matching search criteria)

Seach Terms#

To search for videos, you'll need to provide search terms as a query string for the ultimate level of flexibility. These follow the YouTube API (opens new window) docs.

Some example search terms are:

QueryDescription
q=How to make a Pixel and Tonic drink&order=viewCountFind videos for making a Pixel & Tonic cocktail, ordered by views.
q=Funny Cat Videos&publishedAfter=2022-06-30T00:00:00ZFind funny cat videos published after June 30th, 2022.

Previous ← Twitter Next Available Variables →