Behind the Blackboard! YouTube Search Fails with API 403 Error - Behind the Blackboard Skip Navigation
Download PDF  Icon Download PDF    Print article

YouTube Search Fails with API 403 Error

Date Published: Mar 27,2020

CategoryPlanned First Fix Release:Learn 9.1 Q4 2019 Release,Learn 9.1 Q4 2018 Release,Learn 9.1 Q2 2019 Release,SaaS - Fixed; Product:Learn Administration,Application Components; Version:Learn 9.1 Q4 2019 (3800.0.0),Learn 9.1 Q2 2018 (3400.0.0),Learn 9.1 Q4 2018 (3500.0.0),Learn 9.1 Q2 2019 (3700.0.0),SaaS
Article No.: 000058210
Blackboard Learn
Service Pack(s):
Learn 9.1 Q4 2019 (3800.0.0), Learn 9.1 Q2 2018 (3400.0.0), Learn 9.1 Q4 2018 (3500.0.0), Learn 9.1 Q2 2019 (3700.0.0), SaaS
There is functionality the allows the user to conduct a YouTube search within Learn, and it is using a YouTube API to do so.  This search often fails because YouTube responds with a 403 error message.
Steps to Repeat:
Update (March 27, 2020):
Blackboard has worked with Google to increase the API Quota.  This issue described in this Known Issue article has now been resolved.

Original Course View:
  1. Log into Blackboard Learn environment
  2. Navigate to Course
  3. Go to Build Content > Mashups > YouTube video
  4. In the Search YouTube field, enter a search > Select Go
  1. Log into Blackboard Learn environment
  2. Navigate to Course
  3. Go to Build Content > Item 
  4. In the Content Editor, select Mashups> YouTube Video
  5. In the Search YouTube field, enter a search > Select Go
Ultra Course View: 
  1. Log into Blackboard Learn environment
  2. Navigate to Course
  3. Go to Create > Select Document > Add Content > Insert Content > Insert YouTube Video
  4. In the Search YouTube field, enter a search > Select Search
Observed Behavior: 
In the Original Course View, the following error occurs and YouTube content is not visible:
Error: An error was returned by YouTube: There was a service error: 403 : Access Not Configured. YouTube Data API has not been used in project 28589479198 before or it is disabled.

The following error may have been reported as well:

Error: An error was returned by YouTube: There was a service error: 403: The request can not be completed because you have exceeded your <a href=“/youtube/v3/getting-started#quota”>quota</a>.

In Ultra, no results display; YouTube content is not visible. 

​​​​​Expected Behavior:

The user is able to search YouTube content, which populates without error.



Recently Google decreased the daily quota limit for Learn so clients using the default YouTube API key are seeing 403 errors when users are searching for YouTube videos.  We are working with Google to remediate and will update this article when a solution has been reached.  Blackboard recommends clients setup their own YouTube API Key to have more control over daily limits set by Google. If you have setup your own YouTube API key and are still receiving 403 errors, you can request a higher quote per day through Google's Developer Console.
The following are instructions on how to setup a YouTube API Key.  

Google Developer
  1. Create a Google account, if you do not already have one.  It is suggested to have an account separate from any personal account you may have.  This account should be monitored for any future communications from Google.
  2. Log into the account above
  3. Navigate to
  4. Click "Create Project"
  5. Give the project a name and id
  6. Click Create
  7. Type "Google+ API" in the search bar
  8. Click Google+ API
  9. Click the Enable button
  10. Click Google APIs
  11. Click Enable APIs and Services
  12. Type "YouTube Data API v3" in the search bar
  13. Click YouTube Data API v3
  14. Click the Enable button
  15. Click on Credentials
  16. Click on Create Credentials and select API key
  17. Copy the "Your API key" value to use in the next section. 
Learn Configuration 
  1. Log into Learn as an administrator
  2. Navigate to System Admin -> Building Blocks -> Installed Tools
  3. Click the context icon next to "Mashup - YouTube" and select Settings
  4. In the textbox for "YouTube API Key", enter your YouTube API key from step 18 above
  5. Click Submit
  6. If you have more than one App server, toggle the Mashup - YouTube Building Block to Inactive and then back to Available to propagate the change to all app servers.


Target Release:

Future Reference

Patch Available:


The information contained in the Knowledge Base was written and/or verified by Blackboard Support. It is approved for client use. Nothing in the Knowledge Base shall be deemed to modify your license in any way to any Blackboard product. If you have comments, questions, or concerns, please send an email to © 2021 Blackboard Inc. All rights reserved