Get Make It newsletters delivered to your inbox. All Rights Reserved. Skip Navigation. Success Melinda Gates shares Buffett's advice and what she and Bill won't spend on VIDEO Famous figures who paid off their student loans later in life. Make It. There are 3 ways to pay off student loans—here's how to choose the best one for you. Not us. So he was still involved with that separate American. CBS News reported that then-U. Was he using the vernacular? Was it something stupid to say? You bet your life it was stupid.
The last time these guys unshackled the economy, to use their term, they put the middle class in shackles. All of America except for the very few.
Biden had, in fact, used precisely the same trope before to characterize the impact of Republican economic policies on the middle class. The day after a Republican primary debate in October , Biden said , referring to economic conditions under the George W. My lord, how many times we have to go back to that horror movie?
Revision History | YouTube Data API | Google Developers
The racial composition of the audience is relevant to this debate though not decisive, partly because estimates in the press were rough and contradictory. We asked Tiffany Holland, a reporter who live-blogged the event for the Richmond Times-Dispatch website, for her impression of the racial makeup of the crowd.
In any case, even if only 50 percent of the attendees were African-American, Biden would have found himself gazing out over an audience that included hundreds of black faces. Whether it should taken as a racially charged reference to slavery we leave it to readers to judge for themselves. An image of the all-male Freedom Caucus discussing the future of women's health care coverage sparked anger.
The comment resource's snippet. Following the deprecation, the property will no longer be included in any comment resources. Since neither of these properties will be returned following the deprecation, both properties have been removed from the corresponding resource documentation. The subscriptions. Note that the new parameter only supports retrieval of the most recent subscribers to the authenticated user's channel. To retrieve a complete list of subscribers, use the mySubscribers parameter. That parameter, which does not return subscribers in a particular order, does not limit the number of subscribers that can be retrieved.
The definition of the snippet. The definition of the channelSection. Those parts are only available to the video's owner. For each method, the tool shows code samples for one or more use cases. For example, it provides five code snippets for the search. For each use case, the tool displays the parameters used in the API request.
You can modify the parameter values, in which case the tool updates the code snippets to reflect the parameter values that you provided. Finally, the tool displays the API response to each request. If you have modified the request parameters, the API response is based on your provided parameter values. Note that you need to authorize the tool to submit requests on your behalf for API responses to display. The video resource's new contentDetails. Valid property values are and rectangular. The recordingDetails.
This location is editable, searchable on public videos, and might be displayed to users for public videos. The fileDetails. The value is only visible to the video owner. The definition of the channel resource's contentDetails. This is due to the fact that favorite videos functionality has already been deprecated. Note that this property is not subject to the API deprecation policy. The definition of the ineligibleAccount error, which can be returned by the comments.
The definition of the channels. The Quota Usage section of the Getting Started guide has been updated to link to the Google Developer's Console, where you can see your actual quota and quota usage. The channelBanner resource documentation has been updated to note that the recommended size for the uploaded channel banner image is px by px. The minimum size px by px has not changed. The channel resource's new snippet.
Not all channels have custom URLs. The channel resource's brandingSettings. The API response to a search. The property identifies the region code that was used for the search query. The region code instructs the API to return search results for the specified country. The property value is a two-letter ISO country code that identifies the region. The i18nRegions. The default value is US. If a non-supported region is specified, YouTube might still select another region, rather than the default value, to handle the query.
The definitions of the videoAbuseReportReason resource's snippet. In addition, the videoAbuseReportReasons. The video resource's liveStreamingDetails. The property value is only present if the video is a current live broadcast that has live chat enabled. After the broadcast ends and the live chat concludes, the property is no longer returned for the video.
The video resource's status. European Union EU laws require that certain disclosures must be given to and consents obtained from end users in the EU.
"It Is I" Versus "It Is Me"
The API now supports the ability to set and retrieve localized text for the snippet. You can set localized values for a resource when calling the insert or update method for that resource. To set localized values for a resource, do both of the following:. Ensure that a value is set for the resource's snippet. That property identifies the language of the resource's snippet. Its value can be any supported application language or most other ISO language codes. For example, if you upload a video that has an English title and description, you would set the snippet.
Note for updating channel resources: To set the snippet. Add the localizations object to the resource you are updating. Each object key is a string that identifies an application language or ISO language code, and each key maps to an object that contains the localized title and description for the resource. The sample snippet below sets the resource's default language to English. It also adds localized German and Spanish titles and descriptions to a video:. Important: Remember that when you update the localized data for a resource, your API request must include all of the existing localized versions of the data.
For example, if you sent a subsequent request to add Portuguese data to the video in the example above, the request would need to include the localized data for German, Spanish, and Portuguese. Add the hl parameter to your channels. If localized resource details are available in that language, the resource's snippet. However, if localized details are not available, the snippet. For example, suppose a videos. If the hl parameter were set to de , the resource would contain the following data:.
However, if the hl parameter were set to fr , the snippet. When retrieving a resource, include localizations in the part parameter value to retrieve all of the localized details for that resource. If you are retrieving localized data for a language that is not a current YouTube application language , you need to use this approach to retrieve all localizations and then filter to determine whether the desired localized data exists.
This update does not reflect a change in API behavior. The definition of the video resource's snippet. For example, if a video is uploaded as a private video and then made public at a later time, the property value specifies the time that the video was made public. The updated definition also explains how the value is populated for private and unlisted videos. The definition of the video resource's status. If the request schedules a video to be published at some time in the past, it is published right away.
As such, the effect of setting the status. This property replaces the contentDetails. The definition of the channel resource's brandingSettings. The documentation for the thumbnails. The request body does not contain a thumbnail resource. Previously, the documentation said that you should not provide a request body when calling this method.
The description of the activity resource has been updated to reflect the fact that the activities. The resource's snippet. The video resource's statistics. In accordance with our deprecation policy, this property will continue to be included in video resources for at least one year after this announcement. However, the property value is now always set to 0. Note that this update does not reflect a change in the API's behavior. Specifically, the definition now explains that if a tag contains a space, the API server handles the tag value as though it were wrapped in quotation marks, and the quotation marks count toward the character limit.
So, for the purposes of character limits, the tag Foo-Baz contains seven characters, but the tag Foo Baz contains nine characters. The commentThreads. If a request submits the parameter, the API server ignores the parameter but otherwise handles the request. Threads can be ordered by time or relevance. The default behavior is to order them by time. The video resource's new snippet. The definition of the video resource's contentDetails.
This does not represent a change in actual API behavior. The captions. The new videoAbuseReportReason resource contains information about a reason that a video would be flagged for containing abusive content. The videoAbuseReportReasons. The new videos. The body of the request contains a JSON object that specifies the video being flagged as well as the reason that the video is deemed to contain abusive content.
Valid reasons can be obtained from the videoAbuseReportReason. The migration guide has also been updated with an example for reporting an abusive video. These features are also all explained in the migration guide. The forDeveloper parameter can be used in conjunction with optional search parameters like the q parameter. For this feature, each uploaded video is automatically tagged with the project number that is associated with the developer's application in the Google Developers Console.
When a search request subsequently sets the forDeveloper parameter to true , the API server uses the request's authorization credentials to identify the developer. Therefore, a developer can restrict results to videos uploaded through the developer's own app or website but not to videos uploaded through other apps or sites.
Leveling the playing field
The new feature offers functionality that is similar, albeit not identical, to the developer tags functionality that the v2 API supported. Note: To set the snippet. The API now supports targeting for channelSection resources. Channel section targeting provides a way to restrict visibility of a content section to users that match particular criteria. The API exposes three targeting options.
A user must meet all of the targeting settings for a channel section to be visible. Users who have chosen one of those languages can see the corresponding channel section. The channel section is visible to users that have selected one of those regions as well as users for whom one of those regions is automatically selected.
- The Letter of Christian Liberty.
- Me Father Was A Hero And Me Mother Is A Saint Book.
- Scandal and the Duchess (Mackenzies Series).
- I May Be Crazy, But Its All Good.
Each value in the list is an ISO alpha-2 country code. The documentation for the channelSections. The migration guide has been updated to explain how to migrate applications still using comments functionality from the v2 API. The guide also calls out several commenting features that the v2 API did not support but that are supported in the v3 API. These include:. Retrieving comments about a channel Retrieving all comment threads related to a channel, which means that the API response can contain comments about the channel or any of its videos. Updating the text of a comment Marking a comment as spam Setting a comment's moderation status.
The Subscribing to push notifications guide has been updated to reflect the fact that notifications are only pushed to the Google PubSubHubBub hub and not also to the Superfeedr hub as previously indicated. The API's new commentThread and comment resources let you retrieve, insert, update, delete, and moderate comments. A commentThread resource contains information about a YouTube comment thread, which comprises a top-level comment and replies, if any exist, to that comment. A commentThread resource can represent comments about either a video or a channel.
The top-level comment and the replies are actually comment resources that are nested inside the commentThread resource. It is important to note that the commentThread resource does not necessarily contain all replies to a comment, and you need to use the comments. In addition, some comments do not have replies. Use this method to retrieve comments associated with a particular video or channel. Use the comments. A comment resource contains information about a single YouTube comment. A comment resource can represent a comment about either a video or a channel.
In addition, the comment could be a top-level comment or a reply to a top-level comment. Use this method to retrieve all of the replies to a particular comment. For example, clear a comment for public display or reject a comment as unfit for display. The API request must be authorized by the owner of the channel or video associated with the comments.. Your PubSubHubBub callback server can receive Atom feed notifications when a channel does any of the following activities:.
The migration guide has also been updated to note the new support for push notifications. However, since the v2 API supported numerous other types of push notifications that are not supported in the v3 API, the mention of PubSubHubBub support is still listed in the Deprecated section of that guide. The new captions resource represents a YouTube caption track.
A caption track is associated with exactly one YouTube video. The API supports methods to list , insert , update , download , and delete caption tracks. The migration guide has also been updated to explain how to migrate applications still using captions functionality in the v2 API. The same features were previously and are still listed in other tabs in the guide. For example, the new feature explaining how to update a channel's in-video promotional campaign data is also listed under the Channels profiles tab.
Flagging a video. However, you can use the v3 API to find recommended videos by calling the activities. In the API response, a resource corresponds to a recommended video if the snippet. In that case, the contentDetails. Note that there is no guarantee that the response will contain any particular number of recommended videos. Retrieve channel suggestions. Retrieve new subscription videos — The v3 API does not retrieve a list that only contains videos that have recently been uploaded to channels that the API user subscribes to. However, you can use the v3 API to find new subscription videos by calling the activities.
In the API response, a resource corresponds to a new subscription video if the snippet. Note that there is no guarantee that the response will contain any particular number of new subscription videos. RSS feed support. Notifications were provided for new channel subscriptions and when videos were rated, shared, marked as favorites, commented on, or uploaded.
The v3 API will support push notifications using the PubSubHubbub protocol , but the notifications will only cover video uploads and updates to video titles or video descriptions. While some developers used this field to associate a channel with a particular country, the field's data could not consistently be used for that purpose. Set or retrieve developer tags — The v2 API supported the ability to associate keywords, or developer tags, with a video at the time that the video was uploaded. Developer tags would not be displayed to YouTube users, but video owners could retrieve videos that matched a specific developer tag.
The v3 API will provide a similar, but not identical, feature. Specifically, a developer will be able to search for videos uploaded by the developer's own application. The developer then uses the same project number to search for videos. List videos by publication date, viewcount, or rating — In the v2 API, the orderby parameter let you sort videos in a playlist by position, duration, publication date, title, and several other values. In the v3 API, playlist items are typically sorted by position in ascending order and other sorting options are not available.
There are a few exceptions. A new upload, favorite video, liked video, or recently watched video is automatically added as the first item snippet. So, each of these lists is effectively sorted in order of newest to oldest item based on the times that items were added to the list. Note, however, that a new item added to the "Watch later" playlist is added as the last item in that list, so that list is effectively sorted from oldest to newest item. The v3 API's channels. Using those methods, you can retrieve a list of multiple resources with a single request. With these changes, the guide now identifies all functionality that was supported in the old v2 API that will be deprecated in the current API version v3.
The channelSections. The API now supports the following errors:. The parameter addresses a feature gap that previously existed between the current API version v3 and the previous version v2 , which has already been deprecated. The YouTube Data API v3 migration guide has also been updated to indicate the deprecation of the special feeds and metadata fields that the v2 API provided for describing movies, trailers, television shows, television seasons, and television episodes.
The documentation for the videos. The quota cost for a call to the search. Important: In many cases, you can use other API methods to retrieve information at a lower quota cost. For example, consider these two ways of finding videos uploaded to the GoogleDevelopers channel. Call the channels. Set the forUsername parameter to GoogleDevelopers and the part parameter to contentDetails. In the API response, the contentDetails.
Then call the playlistItems. The channel resource contains two new properties:. The status. This property is only returned if the channel owner authorized the API request. Valid property values are:. See the property definition for more information about these values. The YouTube Help Center also provides more detailed information about this feature.
The invideoPromotion. This feature also picks up a single promotion to show on each video. The definitions of the video resource's snippet. If you call that method to update the snippet part of a video resource, you must set a value for both of those properties. If you try to update the snippet part of a video resource and do not set a value for both of those properties, the API returns an invalidRequest error. That error's description has also been updated. These correspond to the RP13 and RP16 ratings, respectively. The channelBanners. The older API was officially deprecated as of March 4, The playlists.
The description of each API method has been updated to include the quota cost incurred by a call to that method. Similarly, the definitions of part parameters have been updated to specify the quota cost of each part that can be retrieved in an API call. For example, a call to the subscriptions. The subscription resource also contains three parts snippet , contentDetails , and subscriberSnippet , and each of those has a cost of two units.
The video resource now supports 43 new content rating systems, which identify the ratings that videos received from various national rating agencies. A request must specify a value for both parameters to retrieve results based on location, and the API will return an error if a request includes only one of the two parameters. The locationRadius parameter specifies the maximum distance that the location associated with a video can be from the center of the area for the video to still be included in search results.
The channel resource's invideoPromotion. The channelSection resource now can contain information about a few new types of featured content. The channelSection resource's snippet. The definition of the watermark resource's position. The definition of the q parameter for the search.
The value can also use the Boolean OR operator to find videos associated with one of several search terms. The definition of the pageInfo. In addition, the maximum value is 1,, You should not use this value to create pagination links. Instead, use the nextPageToken and prevPageToken property values to determine whether to show pagination links. The watermarks. The new i18nLanguage resource identifies an application language that the YouTube website supports. The application language can also be referred to as a UI language.
For the YouTube website, an application language could be automatically selected based on Google Account settings, browser language, or IP location, and a user could also manually select the desired UI language from the YouTube site footer. The API supports a method to list supported application languages. Supported languages can be used as the value of the hl parameter when calling API methods like videoCategories.
The new i18nRegion resource identifies a geographic area that a YouTube user can select as the preferred content region. The content region can also be referred to as a content locale. For the YouTube website, a content region could be automatically selected based on heuristics like the YouTube domain or the user's IP location, and a user could also manually select the desired content region from the YouTube site footer. The API supports a method to list supported content regions. Supported region codes can be used as the value of the regionCode parameter when calling API methods like search.
The new channelSection resource contains information about a set of videos that a channel has chosen to feature. For example, a section could feature a channel's latest uploads, most popular uploads, or videos from one or more playlists. The API supports methods to list , insert , update , or delete channel sections. You can retrieve a list of channel sections for the authenticated user's channel, by specifying a particular channel ID, or by specifying a list of unique channel section IDs.
The error documentation has also been updated to describe the error messages that the API supports specifically for these new methods. The definition of the video resource's fileDetails object has been updated to explain that that object will only be returned if the video's processingDetails.