From 1caf0869bdb97ddd1d2c14b3c6042b79526a2674 Mon Sep 17 00:00:00 2001 From: yoshi-automation Date: Tue, 4 Aug 2020 04:28:01 -0700 Subject: [PATCH] feat: regenerate index files --- discovery/androidmanagement-v1.json | 4 +- discovery/index.json | 17 +- discovery/searchconsole-v1.json | 24 +- discovery/youtube-v3.json | 1692 +++++++++++++++------------ src/index.ts | 1 + 5 files changed, 987 insertions(+), 751 deletions(-) diff --git a/discovery/androidmanagement-v1.json b/discovery/androidmanagement-v1.json index c25778f1d29..ab8e74a29e0 100644 --- a/discovery/androidmanagement-v1.json +++ b/discovery/androidmanagement-v1.json @@ -924,7 +924,7 @@ } } }, - "revision": "20200612", + "revision": "20200803", "rootUrl": "https://androidmanagement.googleapis.com/", "schemas": { "AdvancedSecurityOverrides": { @@ -2526,7 +2526,7 @@ "The app has new permissions that have not been accepted by the admin.", "The app is not available in the user's country.", "There are no licenses available to assign to the user.", - "The enterprise is no longer enrolled with managed Play or the admin has not accepted the latest managed Play terms of service.", + "The enterprise is no longer enrolled with Managed Google Play or the admin has not accepted the latest Managed Google Play Terms of Service.", "The user is no longer valid. The user may have been deleted or disabled." ], "type": "string" diff --git a/discovery/index.json b/discovery/index.json index 949f73919d9..d96f384022c 100644 --- a/discovery/index.json +++ b/discovery/index.json @@ -1494,6 +1494,21 @@ "documentationLink": "https://cloud.google.com/dataflow", "preferred": true }, + { + "kind": "discovery#directoryItem", + "id": "datafusion:v1", + "name": "datafusion", + "version": "v1", + "title": "Cloud Data Fusion API", + "description": "Cloud Data Fusion is a fully-managed, cloud native, enterprise data integration service for quickly building and managing data pipelines. It provides a graphical interface to increase time efficiency and reduce complexity, and allows business users, developers, and data scientists to easily and reliably build scalable data integration solutions to cleanse, prepare, blend, transfer and transform data without having to wrestle with infrastructure.", + "discoveryRestUrl": "https://datafusion.googleapis.com/$discovery/rest?version=v1", + "icons": { + "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png", + "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png" + }, + "documentationLink": "https://cloud.google.com/data-fusion/docs", + "preferred": true + }, { "kind": "discovery#directoryItem", "id": "datafusion:v1beta1", @@ -1507,7 +1522,7 @@ "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png" }, "documentationLink": "https://cloud.google.com/data-fusion/docs", - "preferred": true + "preferred": false }, { "kind": "discovery#directoryItem", diff --git a/discovery/searchconsole-v1.json b/discovery/searchconsole-v1.json index 00876210500..a06b12ebbd7 100644 --- a/discovery/searchconsole-v1.json +++ b/discovery/searchconsole-v1.json @@ -120,7 +120,7 @@ } } }, - "revision": "20200714", + "revision": "20200803", "rootUrl": "https://searchconsole.googleapis.com/", "schemas": { "BlockedResource": { @@ -139,7 +139,7 @@ "id": "Image", "properties": { "data": { - "description": "Image data in format determined by the mime type. Currently, the format\nwill always be \"image/png\", but this might change in the future.", + "description": "Image data in format determined by the mime type. Currently, the format will always be \"image/png\", but this might change in the future.", "format": "byte", "type": "string" }, @@ -166,13 +166,13 @@ "TAP_TARGETS_TOO_CLOSE" ], "enumDescriptions": [ - "Unknown rule. Sorry, we don't have any description for the rule that was\nbroken.", - "Plugins incompatible with mobile devices are being used. [Learn more]\n(https://support.google.com/webmasters/answer/6352293#flash_usage).", - "Viewsport is not specified using the meta viewport tag. [Learn more]\n(https://support.google.com/webmasters/answer/6352293#viewport_not_configured).", - "Viewport defined to a fixed width. [Learn more]\n(https://support.google.com/webmasters/answer/6352293#fixed-width_viewport).", - "Content not sized to viewport. [Learn more]\n(https://support.google.com/webmasters/answer/6352293#content_not_sized_to_viewport).", - "Font size is too small for easy reading on a small screen. [Learn More]\n(https://support.google.com/webmasters/answer/6352293#small_font_size).", - "Touch elements are too close to each other. [Learn more]\n(https://support.google.com/webmasters/answer/6352293#touch_elements_too_close)." + "Unknown rule. Sorry, we don't have any description for the rule that was broken.", + "Plugins incompatible with mobile devices are being used. [Learn more] (https://support.google.com/webmasters/answer/6352293#flash_usage).", + "Viewsport is not specified using the meta viewport tag. [Learn more] (https://support.google.com/webmasters/answer/6352293#viewport_not_configured).", + "Viewport defined to a fixed width. [Learn more] (https://support.google.com/webmasters/answer/6352293#fixed-width_viewport).", + "Content not sized to viewport. [Learn more] (https://support.google.com/webmasters/answer/6352293#content_not_sized_to_viewport).", + "Font size is too small for easy reading on a small screen. [Learn More] (https://support.google.com/webmasters/answer/6352293#small_font_size).", + "Touch elements are too close to each other. [Learn more] (https://support.google.com/webmasters/answer/6352293#touch_elements_too_close)." ], "type": "string" } @@ -206,7 +206,7 @@ "type": "object" }, "RunMobileFriendlyTestResponse": { - "description": "Mobile-friendly test response, including mobile-friendly issues and resource\nissues.", + "description": "Mobile-friendly test response, including mobile-friendly issues and resource issues.", "id": "RunMobileFriendlyTestResponse", "properties": { "mobileFriendliness": { @@ -267,8 +267,8 @@ "enumDescriptions": [ "Internal error when running this test. Please try running the test again.", "Inspection has completed without errors.", - "Inspection terminated in an error state. This indicates a problem in\nGoogle's infrastructure, not a user error. Please try again later.", - "Google can not access the URL because of a user error such as a robots.txt\nblockage, a 403 or 500 code etc. Please make sure that the URL provided is\naccessible by Googlebot and is not password protected." + "Inspection terminated in an error state. This indicates a problem in Google's infrastructure, not a user error. Please try again later.", + "Google can not access the URL because of a user error such as a robots.txt blockage, a 403 or 500 code etc. Please make sure that the URL provided is accessible by Googlebot and is not password protected." ], "type": "string" } diff --git a/discovery/youtube-v3.json b/discovery/youtube-v3.json index 1af5d951f1c..1318d0fc230 100644 --- a/discovery/youtube-v3.json +++ b/discovery/youtube-v3.json @@ -135,7 +135,7 @@ ], "parameters": { "part": { - "description": "The part parameter serves two purposes in\nthis operation. It identifies the properties that the write operation will\nset as well as the properties that the API response will include.", + "description": "The *part* parameter serves two purposes in this operation. It identifies the properties that the write operation will set as well as the properties that the API response will include.", "location": "query", "repeated": true, "required": true, @@ -177,7 +177,7 @@ }, "maxResults": { "default": "5", - "description": "The maxResults parameter specifies the\nmaximum number of items that should be returned in the result set.", + "description": "The *maxResults* parameter specifies the maximum number of items that should be returned in the result set.", "format": "uint32", "location": "query", "type": "integer" @@ -187,12 +187,12 @@ "type": "boolean" }, "pageToken": { - "description": "The pageToken parameter identifies a specific\npage in the result set that should be returned. In an API response, the\nnextPageToken and prevPageToken properties\nidentify other pages that could be retrieved.", + "description": "The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter specifies a\ncomma-separated list of one or more activity resource\nproperties that the API response will include.

If the parameter\nidentifies a property that contains child properties, the child properties\nwill be included in the response. For example, in an activity\nresource, the snippet property contains other properties that\nidentify the type of activity, a display title for the activity, and so\nforth. If you set part=snippet, the API\nresponse will also contain all of those nested properties.", + "description": "The *part* parameter specifies a comma-separated list of one or more activity resource properties that the API response will include. If the parameter identifies a property that contains child properties, the child properties will be included in the response. For example, in an activity resource, the snippet property contains other properties that identify the type of activity, a display title for the activity, and so forth. If you set *part=snippet*, the API response will also contain all of those nested properties.", "location": "query", "repeated": true, "required": true, @@ -247,7 +247,7 @@ "type": "string" }, "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the request's authorization credentials identify a YouTube CMS user\nwho is acting on behalf of the content owner specified in the parameter\nvalue. This parameter is intended for YouTube content partners that own and\nmanage many different YouTube channels. It allows content owners to\nauthenticate once and get access to all their video and channel data,\nwithout having to provide authentication credentials for each individual\nchannel. The actual CMS account that the user authenticates with must be\nlinked to the specified YouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The actual CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" } @@ -279,17 +279,17 @@ "type": "string" }, "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the request's authorization credentials identify a YouTube CMS user\nwho is acting on behalf of the content owner specified in the parameter\nvalue. This parameter is intended for YouTube content partners that own and\nmanage many different YouTube channels. It allows content owners to\nauthenticate once and get access to all their video and channel data,\nwithout having to provide authentication credentials for each individual\nchannel. The actual CMS account that the user authenticates with must be\nlinked to the specified YouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The actual CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "tfmt": { - "description": "Convert the captions into this format. Supported options are\nsbv, srt, and vtt.", + "description": "Convert the captions into this format. Supported options are sbv, srt, and vtt.", "location": "query", "type": "string" }, "tlang": { - "description": "tlang is the language code; machine translate the captions into\nthis language.", + "description": "tlang is the language code; machine translate the captions into this language.", "location": "query", "type": "string" } @@ -331,19 +331,19 @@ "type": "string" }, "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the request's authorization credentials identify a YouTube CMS user\nwho is acting on behalf of the content owner specified in the parameter\nvalue. This parameter is intended for YouTube content partners that own and\nmanage many different YouTube channels. It allows content owners to\nauthenticate once and get access to all their video and channel data,\nwithout having to provide authentication credentials for each individual\nchannel. The actual CMS account that the user authenticates with must be\nlinked to the specified YouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The actual CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter specifies the\ncaption resource parts that the API response will include. Set\nthe parameter value to snippet.", + "description": "The *part* parameter specifies the caption resource parts that the API response will include. Set the parameter value to snippet.", "location": "query", "repeated": true, "required": true, "type": "string" }, "sync": { - "description": "Extra parameter to allow automatically syncing the uploaded\ncaption/transcript with the audio.", + "description": "Extra parameter to allow automatically syncing the uploaded caption/transcript with the audio.", "location": "query", "type": "boolean" } @@ -383,12 +383,12 @@ "type": "string" }, "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the request's authorization credentials identify a YouTube CMS user\nwho is acting on behalf of the content owner specified in the parameter\nvalue. This parameter is intended for YouTube content partners that own and\nmanage many different YouTube channels. It allows content owners to\nauthenticate once and get access to all their video and channel data,\nwithout having to provide authentication credentials for each individual\nchannel. The actual CMS account that the user authenticates with must be\nlinked to the specified YouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The actual CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter specifies a\ncomma-separated list of one or more caption resource parts\nthat the API response will include. The part names that you\ncan include in the parameter value are id and\nsnippet.", + "description": "The *part* parameter specifies a comma-separated list of one or more caption resource parts that the API response will include. The part names that you can include in the parameter value are id and snippet.", "location": "query", "repeated": true, "required": true, @@ -439,19 +439,19 @@ "type": "string" }, "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the request's authorization credentials identify a YouTube CMS user\nwho is acting on behalf of the content owner specified in the parameter\nvalue. This parameter is intended for YouTube content partners that own and\nmanage many different YouTube channels. It allows content owners to\nauthenticate once and get access to all their video and channel data,\nwithout having to provide authentication credentials for each individual\nchannel. The actual CMS account that the user authenticates with must be\nlinked to the specified YouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The actual CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter specifies a\ncomma-separated list of one or more caption resource parts\nthat the API response will include. The part names that you\ncan include in the parameter value are id and\nsnippet.", + "description": "The *part* parameter specifies a comma-separated list of one or more caption resource parts that the API response will include. The part names that you can include in the parameter value are id and snippet.", "location": "query", "repeated": true, "required": true, "type": "string" }, "sync": { - "description": "Extra parameter to allow automatically syncing the uploaded\ncaption/transcript with the audio.", + "description": "Extra parameter to allow automatically syncing the uploaded caption/transcript with the audio.", "location": "query", "type": "boolean" } @@ -495,17 +495,17 @@ "parameterOrder": [], "parameters": { "channelId": { - "description": "Unused, channel_id is currently derived from the security context of the\nrequestor.", + "description": "Unused, channel_id is currently derived from the security context of the requestor.", "location": "query", "type": "string" }, "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the request's authorization credentials identify a YouTube CMS user\nwho is acting on behalf of the content owner specified in the parameter\nvalue. This parameter is intended for YouTube content partners that own and\nmanage many different YouTube channels. It allows content owners to\nauthenticate once and get access to all their video and channel data,\nwithout having to provide authentication credentials for each individual\nchannel. The actual CMS account that the user authenticates with must be\nlinked to the specified YouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The actual CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "onBehalfOfContentOwnerChannel": { - "description": "This parameter can only be used in a properly authorized request.\nNote: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwnerChannel parameter\nspecifies the YouTube channel ID of the channel to which a video is being\nadded. This parameter is required when a request specifies a value for the\nonBehalfOfContentOwner parameter, and it can only be used in\nconjunction with that parameter. In addition, the request must be\nauthorized using a CMS account that is linked to the content owner that the\nonBehalfOfContentOwner parameter specifies. Finally, the\nchannel that the onBehalfOfContentOwnerChannel parameter value\nspecifies must be linked to the content owner that the\nonBehalfOfContentOwner parameter specifies.

This\nparameter is intended for YouTube content partners that own and manage many\ndifferent YouTube channels. It allows content owners to authenticate once\nand perform actions on behalf of the channel specified in the parameter\nvalue, without having to provide authentication credentials for each\nseparate channel.", + "description": "This parameter can only be used in a properly authorized request. *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwnerChannel* parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required when a request specifies a value for the onBehalfOfContentOwner parameter, and it can only be used in conjunction with that parameter. In addition, the request must be authorized using a CMS account that is linked to the content owner that the onBehalfOfContentOwner parameter specifies. Finally, the channel that the onBehalfOfContentOwnerChannel parameter value specifies must be linked to the content owner that the onBehalfOfContentOwner parameter specifies. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and perform actions on behalf of the channel specified in the parameter value, without having to provide authentication credentials for each separate channel.", "location": "query", "type": "string" } @@ -543,7 +543,7 @@ "type": "string" }, "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" } @@ -565,17 +565,17 @@ ], "parameters": { "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "onBehalfOfContentOwnerChannel": { - "description": "This parameter can only be used in a properly authorized request.\nNote: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwnerChannel parameter\nspecifies the YouTube channel ID of the channel to which a video is being\nadded. This parameter is required when a request specifies a value for the\nonBehalfOfContentOwner parameter, and it can only be used in\nconjunction with that parameter. In addition, the request must be\nauthorized using a CMS account that is linked to the content owner that the\nonBehalfOfContentOwner parameter specifies. Finally, the\nchannel that the onBehalfOfContentOwnerChannel parameter value\nspecifies must be linked to the content owner that the\nonBehalfOfContentOwner parameter specifies.

This\nparameter is intended for YouTube content partners that own and manage many\ndifferent YouTube channels. It allows content owners to authenticate once\nand perform actions on behalf of the channel specified in the parameter\nvalue, without having to provide authentication credentials for each\nseparate channel.", + "description": "This parameter can only be used in a properly authorized request. *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwnerChannel* parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required when a request specifies a value for the onBehalfOfContentOwner parameter, and it can only be used in conjunction with that parameter. In addition, the request must be authorized using a CMS account that is linked to the content owner that the onBehalfOfContentOwner parameter specifies. Finally, the channel that the onBehalfOfContentOwnerChannel parameter value specifies must be linked to the content owner that the onBehalfOfContentOwner parameter specifies. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and perform actions on behalf of the channel specified in the parameter value, without having to provide authentication credentials for each separate channel.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter serves two purposes in\nthis operation. It identifies the properties that the write operation will\nset as well as the properties that the API response will\ninclude.

The part names that you can include in the\nparameter value are snippet and contentDetails.", + "description": "The *part* parameter serves two purposes in this operation. It identifies the properties that the write operation will set as well as the properties that the API response will include. The part names that you can include in the parameter value are snippet and contentDetails.", "location": "query", "repeated": true, "required": true, @@ -626,12 +626,12 @@ "type": "boolean" }, "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter specifies a\ncomma-separated list of one or more channelSection resource\nproperties that the API response will include. The part names\nthat you can include in the parameter value are id,\nsnippet, and contentDetails.

If the\nparameter identifies a property that contains child properties, the child\nproperties will be included in the response. For example, in a\nchannelSection resource, the snippet property\ncontains other properties, such as a display title for the channelSection.\nIf you set part=snippet, the API response\nwill also contain all of those nested properties.", + "description": "The *part* parameter specifies a comma-separated list of one or more channelSection resource properties that the API response will include. The part names that you can include in the parameter value are id, snippet, and contentDetails. If the parameter identifies a property that contains child properties, the child properties will be included in the response. For example, in a channelSection resource, the snippet property contains other properties, such as a display title for the channelSection. If you set *part=snippet*, the API response will also contain all of those nested properties.", "location": "query", "repeated": true, "required": true, @@ -659,12 +659,12 @@ ], "parameters": { "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter serves two purposes in\nthis operation. It identifies the properties that the write operation will\nset as well as the properties that the API response will\ninclude.

The part names that you can include in the\nparameter value are snippet and contentDetails.", + "description": "The *part* parameter serves two purposes in this operation. It identifies the properties that the write operation will set as well as the properties that the API response will include. The part names that you can include in the parameter value are snippet and contentDetails.", "location": "query", "repeated": true, "required": true, @@ -708,7 +708,7 @@ "type": "string" }, "hl": { - "description": "Stands for \"host language\". Specifies the localization language of the\nmetadata to be filled into snippet.localized. The field is filled with the\ndefault metadata if there is no localization in the specified language.\nThe parameter value must be a language code included in the list returned\nby the i18nLanguages.list method (e.g. en_US, es_MX).", + "description": "Stands for \"host language\". Specifies the localization language of the metadata to be filled into snippet.localized. The field is filled with the default metadata if there is no localization in the specified language. The parameter value must be a language code included in the list returned by the i18nLanguages.list method (e.g. en_US, es_MX).", "location": "query", "type": "string" }, @@ -725,7 +725,7 @@ }, "maxResults": { "default": "5", - "description": "The maxResults parameter specifies the\nmaximum number of items that should be returned in the result set.", + "description": "The *maxResults* parameter specifies the maximum number of items that should be returned in the result set.", "format": "uint32", "location": "query", "type": "integer" @@ -741,17 +741,17 @@ "type": "boolean" }, "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "pageToken": { - "description": "The pageToken parameter identifies a specific\npage in the result set that should be returned. In an API response, the\nnextPageToken and prevPageToken properties\nidentify other pages that could be retrieved.", + "description": "The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter specifies a\ncomma-separated list of one or more channel resource\nproperties that the API response will include.

If the parameter\nidentifies a property that contains child properties, the child properties\nwill be included in the response. For example, in a channel\nresource, the contentDetails property contains other\nproperties, such as the uploads properties. As such, if you\nset part=contentDetails, the API response\nwill also contain all of those nested properties.", + "description": "The *part* parameter specifies a comma-separated list of one or more channel resource properties that the API response will include. If the parameter identifies a property that contains child properties, the child properties will be included in the response. For example, in a channel resource, the contentDetails property contains other properties, such as the uploads properties. As such, if you set *part=contentDetails*, the API response will also contain all of those nested properties.", "location": "query", "repeated": true, "required": true, @@ -780,12 +780,12 @@ ], "parameters": { "onBehalfOfContentOwner": { - "description": "The onBehalfOfContentOwner parameter\nindicates that the authenticated user is acting on behalf of the content\nowner specified in the parameter value. This parameter is intended for\nYouTube content partners that own and manage many different YouTube\nchannels. It allows content owners to authenticate once and get access to\nall their video and channel data, without having to provide authentication\ncredentials for each individual channel. The actual CMS account that the\nuser authenticates with needs to be linked to the specified YouTube content\nowner.", + "description": "The *onBehalfOfContentOwner* parameter indicates that the authenticated user is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The actual CMS account that the user authenticates with needs to be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter serves two purposes in\nthis operation. It identifies the properties that the write operation will\nset as well as the properties that the API response will\ninclude.

The API currently only allows the parameter value to be\nset to either brandingSettings or\ninvideoPromotion. (You cannot update both of those parts with\na single request.)

Note that this method overrides the existing\nvalues for all of the mutable properties that are contained in any parts\nthat the parameter value specifies.", + "description": "The *part* parameter serves two purposes in this operation. It identifies the properties that the write operation will set as well as the properties that the API response will include. The API currently only allows the parameter value to be set to either brandingSettings or invideoPromotion. (You cannot update both of those parts with a single request.) Note that this method overrides the existing values for all of the mutable properties that are contained in any parts that the parameter value specifies.", "location": "query", "repeated": true, "required": true, @@ -819,7 +819,7 @@ ], "parameters": { "part": { - "description": "The part parameter identifies the properties\nthat the API response will include. Set the parameter value to\nsnippet. The snippet part has a quota cost of 2\nunits.", + "description": "The *part* parameter identifies the properties that the API response will include. Set the parameter value to snippet. The snippet part has a quota cost of 2 units.", "location": "query", "repeated": true, "required": true, @@ -847,12 +847,12 @@ ], "parameters": { "allThreadsRelatedToChannelId": { - "description": "Returns the comment threads of all videos of the channel and the\nchannel comments as well.", + "description": "Returns the comment threads of all videos of the channel and the channel comments as well.", "location": "query", "type": "string" }, "channelId": { - "description": "Returns the comment threads for all the channel comments (ie does not\ninclude comments left on videos).", + "description": "Returns the comment threads for all the channel comments (ie does not include comments left on videos).", "location": "query", "type": "string" }, @@ -864,20 +864,26 @@ }, "maxResults": { "default": "20", - "description": "The maxResults parameter specifies the\nmaximum number of items that should be returned in the result set.", + "description": "The *maxResults* parameter specifies the maximum number of items that should be returned in the result set.", "format": "uint32", "location": "query", "type": "integer" }, "moderationStatus": { "default": "published", - "description": "Limits the returned comment threads to those with the specified\nmoderation status. Not compatible with the 'id' filter.\nValid values: published, heldForReview, likelySpam.", + "description": "Limits the returned comment threads to those with the specified moderation status. Not compatible with the 'id' filter. Valid values: published, heldForReview, likelySpam.", "enum": [ "published", "heldForReview", "likelySpam", "rejected" ], + "enumDescriptions": [ + "", + "", + "", + "" + ], "location": "query", "type": "string" }, @@ -888,23 +894,28 @@ "time", "relevance" ], + "enumDescriptions": [ + "", + "", + "" + ], "location": "query", "type": "string" }, "pageToken": { - "description": "The pageToken parameter identifies a specific\npage in the result set that should be returned. In an API response, the\nnextPageToken and prevPageToken properties\nidentify other pages that could be retrieved.", + "description": "The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter specifies a\ncomma-separated list of one or more commentThread resource\nproperties that the API response will include.", + "description": "The *part* parameter specifies a comma-separated list of one or more commentThread resource properties that the API response will include.", "location": "query", "repeated": true, "required": true, "type": "string" }, "searchTerms": { - "description": "Limits the returned comment threads to those matching the specified\nkey words. Not compatible with the 'id' filter.", + "description": "Limits the returned comment threads to those matching the specified key words. Not compatible with the 'id' filter.", "location": "query", "type": "string" }, @@ -916,6 +927,11 @@ "html", "plainText" ], + "enumDescriptions": [ + "", + "", + "" + ], "location": "query", "type": "string" }, @@ -943,7 +959,7 @@ ], "parameters": { "part": { - "description": "The part parameter specifies a\ncomma-separated list of commentThread resource properties that\nthe API response will include. You must at least include the\nsnippet part in the parameter value since that part contains\nall of the properties that the API request can update.", + "description": "The *part* parameter specifies a comma-separated list of commentThread resource properties that the API response will include. You must at least include the snippet part in the parameter value since that part contains all of the properties that the API request can update.", "location": "query", "repeated": true, "required": true, @@ -995,7 +1011,7 @@ ], "parameters": { "part": { - "description": "The part parameter identifies the properties\nthat the API response will include. Set the parameter value to\nsnippet. The snippet part has a quota cost of 2\nunits.", + "description": "The *part* parameter identifies the properties that the API response will include. Set the parameter value to snippet. The snippet part has a quota cost of 2 units.", "location": "query", "repeated": true, "required": true, @@ -1030,23 +1046,23 @@ }, "maxResults": { "default": "20", - "description": "The maxResults parameter specifies the\nmaximum number of items that should be returned in the result set.", + "description": "The *maxResults* parameter specifies the maximum number of items that should be returned in the result set.", "format": "uint32", "location": "query", "type": "integer" }, "pageToken": { - "description": "The pageToken parameter identifies a specific\npage in the result set that should be returned. In an API response, the\nnextPageToken and prevPageToken properties\nidentify other pages that could be retrieved.", + "description": "The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.", "location": "query", "type": "string" }, "parentId": { - "description": "Returns replies to the specified comment.\nNote, currently YouTube features only one level of replies (ie replies\nto top level comments). However replies to replies may be supported in\nthe future.", + "description": "Returns replies to the specified comment. Note, currently YouTube features only one level of replies (ie replies to top level comments). However replies to replies may be supported in the future.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter specifies a\ncomma-separated list of one or more comment resource\nproperties that the API response will include.", + "description": "The *part* parameter specifies a comma-separated list of one or more comment resource properties that the API response will include.", "location": "query", "repeated": true, "required": true, @@ -1060,6 +1076,11 @@ "html", "plainText" ], + "enumDescriptions": [ + "", + "", + "" + ], "location": "query", "type": "string" } @@ -1073,7 +1094,7 @@ ] }, "markAsSpam": { - "description": "Expresses the caller's opinion that one or more comments should be flagged\nas spam.", + "description": "Expresses the caller's opinion that one or more comments should be flagged as spam.", "flatPath": "youtube/v3/comments/markAsSpam", "httpMethod": "POST", "id": "youtube.comments.markAsSpam", @@ -1106,7 +1127,7 @@ "parameters": { "banAuthor": { "default": "false", - "description": "If set to true the author of the comment gets added to the ban list.\nThis means all future comments of the author will autmomatically be\nrejected.\nOnly valid in combination with STATUS_REJECTED.", + "description": "If set to true the author of the comment gets added to the ban list. This means all future comments of the author will autmomatically be rejected. Only valid in combination with STATUS_REJECTED.", "location": "query", "type": "boolean" }, @@ -1118,13 +1139,19 @@ "type": "string" }, "moderationStatus": { - "description": "Specifies the requested moderation status. Note, comments can be in\nstatuses, which are not available through this call. For example, this\ncall does not allow to mark a comment as 'likely spam'.\nValid values: MODERATION_STATUS_PUBLISHED,\nMODERATION_STATUS_HELD_FOR_REVIEW, MODERATION_STATUS_REJECTED.", + "description": "Specifies the requested moderation status. Note, comments can be in statuses, which are not available through this call. For example, this call does not allow to mark a comment as 'likely spam'. Valid values: MODERATION_STATUS_PUBLISHED, MODERATION_STATUS_HELD_FOR_REVIEW, MODERATION_STATUS_REJECTED.", "enum": [ "published", "heldForReview", "likelySpam", "rejected" ], + "enumDescriptions": [ + "", + "", + "", + "" + ], "location": "query", "required": true, "type": "string" @@ -1145,7 +1172,7 @@ ], "parameters": { "part": { - "description": "The part parameter identifies the properties\nthat the API response will include. You must at least include the\nsnippet part in the parameter value since that part contains\nall of the properties that the API request can update.", + "description": "The *part* parameter identifies the properties that the API response will include. You must at least include the snippet part in the parameter value since that part contains all of the properties that the API request can update.", "location": "query", "repeated": true, "required": true, @@ -1188,7 +1215,7 @@ "type": "string" }, "part": { - "description": "The part parameter specifies the\nguideCategory resource properties that the API response will\ninclude. Set the parameter value to snippet.", + "description": "The *part* parameter specifies the guideCategory resource properties that the API response will include. Set the parameter value to snippet.", "location": "query", "repeated": true, "required": true, @@ -1230,7 +1257,7 @@ "type": "string" }, "part": { - "description": "The part parameter specifies the\ni18nLanguage resource properties that the API response will\ninclude. Set the parameter value to snippet.", + "description": "The *part* parameter specifies the i18nLanguage resource properties that the API response will include. Set the parameter value to snippet.", "location": "query", "repeated": true, "required": true, @@ -1267,7 +1294,7 @@ "type": "string" }, "part": { - "description": "The part parameter specifies the\ni18nRegion resource properties that the API response will\ninclude. Set the parameter value to snippet.", + "description": "The *part* parameter specifies the i18nRegion resource properties that the API response will include. Set the parameter value to snippet.", "location": "query", "repeated": true, "required": true, @@ -1306,17 +1333,17 @@ "type": "string" }, "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "onBehalfOfContentOwnerChannel": { - "description": "This parameter can only be used in a properly authorized request.\nNote: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwnerChannel parameter\nspecifies the YouTube channel ID of the channel to which a video is being\nadded. This parameter is required when a request specifies a value for the\nonBehalfOfContentOwner parameter, and it can only be used in\nconjunction with that parameter. In addition, the request must be\nauthorized using a CMS account that is linked to the content owner that the\nonBehalfOfContentOwner parameter specifies. Finally, the\nchannel that the onBehalfOfContentOwnerChannel parameter value\nspecifies must be linked to the content owner that the\nonBehalfOfContentOwner parameter specifies.

This\nparameter is intended for YouTube content partners that own and manage many\ndifferent YouTube channels. It allows content owners to authenticate once\nand perform actions on behalf of the channel specified in the parameter\nvalue, without having to provide authentication credentials for each\nseparate channel.", + "description": "This parameter can only be used in a properly authorized request. *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwnerChannel* parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required when a request specifies a value for the onBehalfOfContentOwner parameter, and it can only be used in conjunction with that parameter. In addition, the request must be authorized using a CMS account that is linked to the content owner that the onBehalfOfContentOwner parameter specifies. Finally, the channel that the onBehalfOfContentOwnerChannel parameter value specifies must be linked to the content owner that the onBehalfOfContentOwner parameter specifies. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and perform actions on behalf of the channel specified in the parameter value, without having to provide authentication credentials for each separate channel.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter specifies a\ncomma-separated list of one or more liveBroadcast resource\nproperties that the API response will include. The part names\nthat you can include in the parameter value are id,\nsnippet, contentDetails, and status.", + "description": "The *part* parameter specifies a comma-separated list of one or more liveBroadcast resource properties that the API response will include. The part names that you can include in the parameter value are id, snippet, contentDetails, and status.", "location": "query", "repeated": true, "required": true, @@ -1338,7 +1365,7 @@ ] }, "control": { - "description": "Slate and recording control of the live broadcast.\nSupport actions: slate on/off, recording start/stop/pause/resume.\nDesign doc: goto/yt-api-liveBroadcast-control", + "description": "Slate and recording control of the live broadcast. Support actions: slate on/off, recording start/stop/pause/resume. Design doc: goto/yt-api-liveBroadcast-control", "flatPath": "youtube/v3/liveBroadcasts/control", "httpMethod": "POST", "id": "youtube.liveBroadcasts.control", @@ -1359,30 +1386,30 @@ "type": "string" }, "offsetTimeMs": { - "description": "The exact time when the actions (e.g. slate on) are executed.\nIt is an offset from the first frame of the monitor stream.\nIf not set, it means \"now\" or ASAP.\nThis field should not be set if the monitor stream is disabled,\notherwise an error will be returned.", + "description": "The exact time when the actions (e.g. slate on) are executed. It is an offset from the first frame of the monitor stream. If not set, it means \"now\" or ASAP. This field should not be set if the monitor stream is disabled, otherwise an error will be returned.", "format": "uint64", "location": "query", "type": "string" }, "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "onBehalfOfContentOwnerChannel": { - "description": "This parameter can only be used in a properly authorized request.\nNote: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwnerChannel parameter\nspecifies the YouTube channel ID of the channel to which a video is being\nadded. This parameter is required when a request specifies a value for the\nonBehalfOfContentOwner parameter, and it can only be used in\nconjunction with that parameter. In addition, the request must be\nauthorized using a CMS account that is linked to the content owner that the\nonBehalfOfContentOwner parameter specifies. Finally, the\nchannel that the onBehalfOfContentOwnerChannel parameter value\nspecifies must be linked to the content owner that the\nonBehalfOfContentOwner parameter specifies.

This\nparameter is intended for YouTube content partners that own and manage many\ndifferent YouTube channels. It allows content owners to authenticate once\nand perform actions on behalf of the channel specified in the parameter\nvalue, without having to provide authentication credentials for each\nseparate channel.", + "description": "This parameter can only be used in a properly authorized request. *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwnerChannel* parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required when a request specifies a value for the onBehalfOfContentOwner parameter, and it can only be used in conjunction with that parameter. In addition, the request must be authorized using a CMS account that is linked to the content owner that the onBehalfOfContentOwner parameter specifies. Finally, the channel that the onBehalfOfContentOwnerChannel parameter value specifies must be linked to the content owner that the onBehalfOfContentOwner parameter specifies. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and perform actions on behalf of the channel specified in the parameter value, without having to provide authentication credentials for each separate channel.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter specifies a\ncomma-separated list of one or more liveBroadcast resource\nproperties that the API response will include. The part names\nthat you can include in the parameter value are id,\nsnippet, contentDetails, and status.", + "description": "The *part* parameter specifies a comma-separated list of one or more liveBroadcast resource properties that the API response will include. The part names that you can include in the parameter value are id, snippet, contentDetails, and status.", "location": "query", "repeated": true, "required": true, "type": "string" }, "walltime": { - "description": "The wall clock time at which the action should be executed.\nOnly one of offset_time_ms and walltime may be set at a time.", + "description": "The wall clock time at which the action should be executed. Only one of offset_time_ms and walltime may be set at a time.", "format": "google-datetime", "location": "query", "type": "string" @@ -1413,12 +1440,12 @@ "type": "string" }, "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "onBehalfOfContentOwnerChannel": { - "description": "This parameter can only be used in a properly authorized request.\nNote: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwnerChannel parameter\nspecifies the YouTube channel ID of the channel to which a video is being\nadded. This parameter is required when a request specifies a value for the\nonBehalfOfContentOwner parameter, and it can only be used in\nconjunction with that parameter. In addition, the request must be\nauthorized using a CMS account that is linked to the content owner that the\nonBehalfOfContentOwner parameter specifies. Finally, the\nchannel that the onBehalfOfContentOwnerChannel parameter value\nspecifies must be linked to the content owner that the\nonBehalfOfContentOwner parameter specifies.

This\nparameter is intended for YouTube content partners that own and manage many\ndifferent YouTube channels. It allows content owners to authenticate once\nand perform actions on behalf of the channel specified in the parameter\nvalue, without having to provide authentication credentials for each\nseparate channel.", + "description": "This parameter can only be used in a properly authorized request. *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwnerChannel* parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required when a request specifies a value for the onBehalfOfContentOwner parameter, and it can only be used in conjunction with that parameter. In addition, the request must be authorized using a CMS account that is linked to the content owner that the onBehalfOfContentOwner parameter specifies. Finally, the channel that the onBehalfOfContentOwnerChannel parameter value specifies must be linked to the content owner that the onBehalfOfContentOwner parameter specifies. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and perform actions on behalf of the channel specified in the parameter value, without having to provide authentication credentials for each separate channel.", "location": "query", "type": "string" } @@ -1439,17 +1466,17 @@ ], "parameters": { "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "onBehalfOfContentOwnerChannel": { - "description": "This parameter can only be used in a properly authorized request.\nNote: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwnerChannel parameter\nspecifies the YouTube channel ID of the channel to which a video is being\nadded. This parameter is required when a request specifies a value for the\nonBehalfOfContentOwner parameter, and it can only be used in\nconjunction with that parameter. In addition, the request must be\nauthorized using a CMS account that is linked to the content owner that the\nonBehalfOfContentOwner parameter specifies. Finally, the\nchannel that the onBehalfOfContentOwnerChannel parameter value\nspecifies must be linked to the content owner that the\nonBehalfOfContentOwner parameter specifies.

This\nparameter is intended for YouTube content partners that own and manage many\ndifferent YouTube channels. It allows content owners to authenticate once\nand perform actions on behalf of the channel specified in the parameter\nvalue, without having to provide authentication credentials for each\nseparate channel.", + "description": "This parameter can only be used in a properly authorized request. *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwnerChannel* parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required when a request specifies a value for the onBehalfOfContentOwner parameter, and it can only be used in conjunction with that parameter. In addition, the request must be authorized using a CMS account that is linked to the content owner that the onBehalfOfContentOwner parameter specifies. Finally, the channel that the onBehalfOfContentOwnerChannel parameter value specifies must be linked to the content owner that the onBehalfOfContentOwner parameter specifies. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and perform actions on behalf of the channel specified in the parameter value, without having to provide authentication credentials for each separate channel.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter serves two purposes in\nthis operation. It identifies the properties that the write operation will\nset as well as the properties that the API response will\ninclude.

The part properties that you can include in\nthe parameter value are id, snippet,\ncontentDetails, and status.", + "description": "The *part* parameter serves two purposes in this operation. It identifies the properties that the write operation will set as well as the properties that the API response will include. The part properties that you can include in the parameter value are id, snippet, contentDetails, and status.", "location": "query", "repeated": true, "required": true, @@ -1486,6 +1513,13 @@ "upcoming", "completed" ], + "enumDescriptions": [ + "", + "", + "", + "", + "" + ], "location": "query", "type": "string" }, @@ -1498,6 +1532,12 @@ "event", "persistent" ], + "enumDescriptions": [ + "", + "", + "", + "" + ], "location": "query", "type": "string" }, @@ -1509,7 +1549,7 @@ }, "maxResults": { "default": "5", - "description": "The maxResults parameter specifies the\nmaximum number of items that should be returned in the result set.", + "description": "The *maxResults* parameter specifies the maximum number of items that should be returned in the result set.", "format": "uint32", "location": "query", "type": "integer" @@ -1519,22 +1559,22 @@ "type": "boolean" }, "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "onBehalfOfContentOwnerChannel": { - "description": "This parameter can only be used in a properly authorized request.\nNote: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwnerChannel parameter\nspecifies the YouTube channel ID of the channel to which a video is being\nadded. This parameter is required when a request specifies a value for the\nonBehalfOfContentOwner parameter, and it can only be used in\nconjunction with that parameter. In addition, the request must be\nauthorized using a CMS account that is linked to the content owner that the\nonBehalfOfContentOwner parameter specifies. Finally, the\nchannel that the onBehalfOfContentOwnerChannel parameter value\nspecifies must be linked to the content owner that the\nonBehalfOfContentOwner parameter specifies.

This\nparameter is intended for YouTube content partners that own and manage many\ndifferent YouTube channels. It allows content owners to authenticate once\nand perform actions on behalf of the channel specified in the parameter\nvalue, without having to provide authentication credentials for each\nseparate channel.", + "description": "This parameter can only be used in a properly authorized request. *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwnerChannel* parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required when a request specifies a value for the onBehalfOfContentOwner parameter, and it can only be used in conjunction with that parameter. In addition, the request must be authorized using a CMS account that is linked to the content owner that the onBehalfOfContentOwner parameter specifies. Finally, the channel that the onBehalfOfContentOwnerChannel parameter value specifies must be linked to the content owner that the onBehalfOfContentOwner parameter specifies. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and perform actions on behalf of the channel specified in the parameter value, without having to provide authentication credentials for each separate channel.", "location": "query", "type": "string" }, "pageToken": { - "description": "The pageToken parameter identifies a specific\npage in the result set that should be returned. In an API response, the\nnextPageToken and prevPageToken properties\nidentify other pages that could be retrieved.", + "description": "The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter specifies a\ncomma-separated list of one or more liveBroadcast resource\nproperties that the API response will include. The part names\nthat you can include in the parameter value are id,\nsnippet, contentDetails, and status.", + "description": "The *part* parameter specifies a comma-separated list of one or more liveBroadcast resource properties that the API response will include. The part names that you can include in the parameter value are id, snippet, contentDetails, and status.", "location": "query", "repeated": true, "required": true, @@ -1570,6 +1610,12 @@ "live", "complete" ], + "enumDescriptions": [ + "", + "", + "", + "" + ], "location": "query", "required": true, "type": "string" @@ -1581,17 +1627,17 @@ "type": "string" }, "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "onBehalfOfContentOwnerChannel": { - "description": "This parameter can only be used in a properly authorized request.\nNote: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwnerChannel parameter\nspecifies the YouTube channel ID of the channel to which a video is being\nadded. This parameter is required when a request specifies a value for the\nonBehalfOfContentOwner parameter, and it can only be used in\nconjunction with that parameter. In addition, the request must be\nauthorized using a CMS account that is linked to the content owner that the\nonBehalfOfContentOwner parameter specifies. Finally, the\nchannel that the onBehalfOfContentOwnerChannel parameter value\nspecifies must be linked to the content owner that the\nonBehalfOfContentOwner parameter specifies.

This\nparameter is intended for YouTube content partners that own and manage many\ndifferent YouTube channels. It allows content owners to authenticate once\nand perform actions on behalf of the channel specified in the parameter\nvalue, without having to provide authentication credentials for each\nseparate channel.", + "description": "This parameter can only be used in a properly authorized request. *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwnerChannel* parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required when a request specifies a value for the onBehalfOfContentOwner parameter, and it can only be used in conjunction with that parameter. In addition, the request must be authorized using a CMS account that is linked to the content owner that the onBehalfOfContentOwner parameter specifies. Finally, the channel that the onBehalfOfContentOwnerChannel parameter value specifies must be linked to the content owner that the onBehalfOfContentOwner parameter specifies. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and perform actions on behalf of the channel specified in the parameter value, without having to provide authentication credentials for each separate channel.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter specifies a\ncomma-separated list of one or more liveBroadcast resource\nproperties that the API response will include. The part names\nthat you can include in the parameter value are id,\nsnippet, contentDetails, and status.", + "description": "The *part* parameter specifies a comma-separated list of one or more liveBroadcast resource properties that the API response will include. The part names that you can include in the parameter value are id, snippet, contentDetails, and status.", "location": "query", "repeated": true, "required": true, @@ -1617,17 +1663,17 @@ ], "parameters": { "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "onBehalfOfContentOwnerChannel": { - "description": "This parameter can only be used in a properly authorized request.\nNote: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwnerChannel parameter\nspecifies the YouTube channel ID of the channel to which a video is being\nadded. This parameter is required when a request specifies a value for the\nonBehalfOfContentOwner parameter, and it can only be used in\nconjunction with that parameter. In addition, the request must be\nauthorized using a CMS account that is linked to the content owner that the\nonBehalfOfContentOwner parameter specifies. Finally, the\nchannel that the onBehalfOfContentOwnerChannel parameter value\nspecifies must be linked to the content owner that the\nonBehalfOfContentOwner parameter specifies.

This\nparameter is intended for YouTube content partners that own and manage many\ndifferent YouTube channels. It allows content owners to authenticate once\nand perform actions on behalf of the channel specified in the parameter\nvalue, without having to provide authentication credentials for each\nseparate channel.", + "description": "This parameter can only be used in a properly authorized request. *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwnerChannel* parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required when a request specifies a value for the onBehalfOfContentOwner parameter, and it can only be used in conjunction with that parameter. In addition, the request must be authorized using a CMS account that is linked to the content owner that the onBehalfOfContentOwner parameter specifies. Finally, the channel that the onBehalfOfContentOwnerChannel parameter value specifies must be linked to the content owner that the onBehalfOfContentOwner parameter specifies. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and perform actions on behalf of the channel specified in the parameter value, without having to provide authentication credentials for each separate channel.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter serves two purposes in\nthis operation. It identifies the properties that the write operation will\nset as well as the properties that the API response will\ninclude.

The part properties that you can include in\nthe parameter value are id, snippet,\ncontentDetails, and status.

Note that this\nmethod will override the existing values for all of the mutable properties\nthat are contained in any parts that the parameter value specifies. For\nexample, a\nbroadcast's privacy status is defined in the status part. As\nsuch, if your request is updating a private or unlisted broadcast, and the\nrequest's part parameter value includes the\nstatus part, the broadcast's privacy setting will be updated\nto whatever value the request body specifies. If the request body does not\nspecify a value, the existing privacy setting will be removed and the\nbroadcast will revert to the default privacy setting.", + "description": "The *part* parameter serves two purposes in this operation. It identifies the properties that the write operation will set as well as the properties that the API response will include. The part properties that you can include in the parameter value are id, snippet, contentDetails, and status. Note that this method will override the existing values for all of the mutable properties that are contained in any parts that the parameter value specifies. For example, a broadcast's privacy status is defined in the status part. As such, if your request is updating a private or unlisted broadcast, and the request's part parameter value includes the status part, the broadcast's privacy setting will be updated to whatever value the request body specifies. If the request body does not specify a value, the existing privacy setting will be removed and the broadcast will revert to the default privacy setting.", "location": "query", "repeated": true, "required": true, @@ -1681,7 +1727,7 @@ ], "parameters": { "part": { - "description": "The part parameter serves two purposes in\nthis operation. It identifies the properties that the write operation will\nset as well as the properties that the API response returns. Set the\nparameter value to snippet.", + "description": "The *part* parameter serves two purposes in this operation. It identifies the properties that the write operation will set as well as the properties that the API response returns. Set the parameter value to snippet.", "location": "query", "repeated": true, "required": true, @@ -1735,7 +1781,7 @@ ], "parameters": { "part": { - "description": "The part parameter serves two purposes. It\nidentifies the properties that the write operation will set as well as the\nproperties that the API response will include. Set the parameter value to\nsnippet.", + "description": "The *part* parameter serves two purposes. It identifies the properties that the write operation will set as well as the properties that the API response will include. Set the parameter value to snippet.", "location": "query", "repeated": true, "required": true, @@ -1765,7 +1811,7 @@ ], "parameters": { "hl": { - "description": "Specifies the localization language in which the system messages\nshould be returned.", + "description": "Specifies the localization language in which the system messages should be returned.", "location": "query", "type": "string" }, @@ -1777,25 +1823,25 @@ }, "maxResults": { "default": "500", - "description": "The maxResults parameter specifies the\nmaximum number of items that should be returned in the result set.", + "description": "The *maxResults* parameter specifies the maximum number of items that should be returned in the result set.", "format": "uint32", "location": "query", "type": "integer" }, "pageToken": { - "description": "The pageToken parameter identifies a specific\npage in the result set that should be returned. In an API response, the\nnextPageToken property identify other pages that could be\nretrieved.", + "description": "The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken property identify other pages that could be retrieved.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter specifies the\nliveChatComment resource parts that the API response will\ninclude. Supported values are id and snippet.", + "description": "The *part* parameter specifies the liveChatComment resource parts that the API response will include. Supported values are id and snippet.", "location": "query", "repeated": true, "required": true, "type": "string" }, "profileImageSize": { - "description": "Specifies the size of the profile image that should be\nreturned for each user.", + "description": "Specifies the size of the profile image that should be returned for each user.", "format": "uint32", "location": "query", "type": "integer" @@ -1846,7 +1892,7 @@ ], "parameters": { "part": { - "description": "The part parameter serves two purposes in\nthis operation. It identifies the properties that the write operation will\nset as well as the properties that the API response returns. Set the\nparameter value to snippet.", + "description": "The *part* parameter serves two purposes in this operation. It identifies the properties that the write operation will set as well as the properties that the API response returns. Set the parameter value to snippet.", "location": "query", "repeated": true, "required": true, @@ -1883,18 +1929,18 @@ }, "maxResults": { "default": "5", - "description": "The maxResults parameter specifies the\nmaximum number of items that should be returned in the result set.", + "description": "The *maxResults* parameter specifies the maximum number of items that should be returned in the result set.", "format": "uint32", "location": "query", "type": "integer" }, "pageToken": { - "description": "The pageToken parameter identifies a specific\npage in the result set that should be returned. In an API response, the\nnextPageToken and prevPageToken properties\nidentify other pages that could be retrieved.", + "description": "The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter specifies the\nliveChatModerator resource parts that the API response will\ninclude. Supported values are id and snippet.", + "description": "The *part* parameter specifies the liveChatModerator resource parts that the API response will include. Supported values are id and snippet.", "location": "query", "repeated": true, "required": true, @@ -1930,12 +1976,12 @@ "type": "string" }, "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "onBehalfOfContentOwnerChannel": { - "description": "This parameter can only be used in a properly authorized request.\nNote: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwnerChannel parameter\nspecifies the YouTube channel ID of the channel to which a video is being\nadded. This parameter is required when a request specifies a value for the\nonBehalfOfContentOwner parameter, and it can only be used in\nconjunction with that parameter. In addition, the request must be\nauthorized using a CMS account that is linked to the content owner that the\nonBehalfOfContentOwner parameter specifies. Finally, the\nchannel that the onBehalfOfContentOwnerChannel parameter value\nspecifies must be linked to the content owner that the\nonBehalfOfContentOwner parameter specifies.

This\nparameter is intended for YouTube content partners that own and manage many\ndifferent YouTube channels. It allows content owners to authenticate once\nand perform actions on behalf of the channel specified in the parameter\nvalue, without having to provide authentication credentials for each\nseparate channel.", + "description": "This parameter can only be used in a properly authorized request. *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwnerChannel* parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required when a request specifies a value for the onBehalfOfContentOwner parameter, and it can only be used in conjunction with that parameter. In addition, the request must be authorized using a CMS account that is linked to the content owner that the onBehalfOfContentOwner parameter specifies. Finally, the channel that the onBehalfOfContentOwnerChannel parameter value specifies must be linked to the content owner that the onBehalfOfContentOwner parameter specifies. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and perform actions on behalf of the channel specified in the parameter value, without having to provide authentication credentials for each separate channel.", "location": "query", "type": "string" } @@ -1956,17 +2002,17 @@ ], "parameters": { "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "onBehalfOfContentOwnerChannel": { - "description": "This parameter can only be used in a properly authorized request.\nNote: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwnerChannel parameter\nspecifies the YouTube channel ID of the channel to which a video is being\nadded. This parameter is required when a request specifies a value for the\nonBehalfOfContentOwner parameter, and it can only be used in\nconjunction with that parameter. In addition, the request must be\nauthorized using a CMS account that is linked to the content owner that the\nonBehalfOfContentOwner parameter specifies. Finally, the\nchannel that the onBehalfOfContentOwnerChannel parameter value\nspecifies must be linked to the content owner that the\nonBehalfOfContentOwner parameter specifies.

This\nparameter is intended for YouTube content partners that own and manage many\ndifferent YouTube channels. It allows content owners to authenticate once\nand perform actions on behalf of the channel specified in the parameter\nvalue, without having to provide authentication credentials for each\nseparate channel.", + "description": "This parameter can only be used in a properly authorized request. *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwnerChannel* parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required when a request specifies a value for the onBehalfOfContentOwner parameter, and it can only be used in conjunction with that parameter. In addition, the request must be authorized using a CMS account that is linked to the content owner that the onBehalfOfContentOwner parameter specifies. Finally, the channel that the onBehalfOfContentOwnerChannel parameter value specifies must be linked to the content owner that the onBehalfOfContentOwner parameter specifies. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and perform actions on behalf of the channel specified in the parameter value, without having to provide authentication credentials for each separate channel.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter serves two purposes in\nthis operation. It identifies the properties that the write operation will\nset as well as the properties that the API response will\ninclude.

The part properties that you can include in\nthe parameter value are id, snippet,\ncdn, and status.", + "description": "The *part* parameter serves two purposes in this operation. It identifies the properties that the write operation will set as well as the properties that the API response will include. The part properties that you can include in the parameter value are id, snippet, cdn, and status.", "location": "query", "repeated": true, "required": true, @@ -2002,7 +2048,7 @@ }, "maxResults": { "default": "5", - "description": "The maxResults parameter specifies the\nmaximum number of items that should be returned in the result set.", + "description": "The *maxResults* parameter specifies the maximum number of items that should be returned in the result set.", "format": "uint32", "location": "query", "type": "integer" @@ -2012,22 +2058,22 @@ "type": "boolean" }, "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "onBehalfOfContentOwnerChannel": { - "description": "This parameter can only be used in a properly authorized request.\nNote: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwnerChannel parameter\nspecifies the YouTube channel ID of the channel to which a video is being\nadded. This parameter is required when a request specifies a value for the\nonBehalfOfContentOwner parameter, and it can only be used in\nconjunction with that parameter. In addition, the request must be\nauthorized using a CMS account that is linked to the content owner that the\nonBehalfOfContentOwner parameter specifies. Finally, the\nchannel that the onBehalfOfContentOwnerChannel parameter value\nspecifies must be linked to the content owner that the\nonBehalfOfContentOwner parameter specifies.

This\nparameter is intended for YouTube content partners that own and manage many\ndifferent YouTube channels. It allows content owners to authenticate once\nand perform actions on behalf of the channel specified in the parameter\nvalue, without having to provide authentication credentials for each\nseparate channel.", + "description": "This parameter can only be used in a properly authorized request. *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwnerChannel* parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required when a request specifies a value for the onBehalfOfContentOwner parameter, and it can only be used in conjunction with that parameter. In addition, the request must be authorized using a CMS account that is linked to the content owner that the onBehalfOfContentOwner parameter specifies. Finally, the channel that the onBehalfOfContentOwnerChannel parameter value specifies must be linked to the content owner that the onBehalfOfContentOwner parameter specifies. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and perform actions on behalf of the channel specified in the parameter value, without having to provide authentication credentials for each separate channel.", "location": "query", "type": "string" }, "pageToken": { - "description": "The pageToken parameter identifies a specific\npage in the result set that should be returned. In an API response, the\nnextPageToken and prevPageToken properties\nidentify other pages that could be retrieved.", + "description": "The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter specifies a\ncomma-separated list of one or more liveStream resource\nproperties that the API response will include. The part names\nthat you can include in the parameter value are id,\nsnippet, cdn, and status.", + "description": "The *part* parameter specifies a comma-separated list of one or more liveStream resource properties that the API response will include. The part names that you can include in the parameter value are id, snippet, cdn, and status.", "location": "query", "repeated": true, "required": true, @@ -2054,17 +2100,17 @@ ], "parameters": { "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "onBehalfOfContentOwnerChannel": { - "description": "This parameter can only be used in a properly authorized request.\nNote: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwnerChannel parameter\nspecifies the YouTube channel ID of the channel to which a video is being\nadded. This parameter is required when a request specifies a value for the\nonBehalfOfContentOwner parameter, and it can only be used in\nconjunction with that parameter. In addition, the request must be\nauthorized using a CMS account that is linked to the content owner that the\nonBehalfOfContentOwner parameter specifies. Finally, the\nchannel that the onBehalfOfContentOwnerChannel parameter value\nspecifies must be linked to the content owner that the\nonBehalfOfContentOwner parameter specifies.

This\nparameter is intended for YouTube content partners that own and manage many\ndifferent YouTube channels. It allows content owners to authenticate once\nand perform actions on behalf of the channel specified in the parameter\nvalue, without having to provide authentication credentials for each\nseparate channel.", + "description": "This parameter can only be used in a properly authorized request. *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwnerChannel* parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required when a request specifies a value for the onBehalfOfContentOwner parameter, and it can only be used in conjunction with that parameter. In addition, the request must be authorized using a CMS account that is linked to the content owner that the onBehalfOfContentOwner parameter specifies. Finally, the channel that the onBehalfOfContentOwnerChannel parameter value specifies must be linked to the content owner that the onBehalfOfContentOwner parameter specifies. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and perform actions on behalf of the channel specified in the parameter value, without having to provide authentication credentials for each separate channel.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter serves two purposes in\nthis operation. It identifies the properties that the write operation will\nset as well as the properties that the API response will\ninclude.

The part properties that you can include in\nthe parameter value are id, snippet,\ncdn, and status.

Note that this method\nwill override the existing values for all of the mutable properties that\nare contained in any parts that the parameter value specifies. If the\nrequest body does not specify a value for a mutable property, the existing\nvalue for that property will be removed.", + "description": "The *part* parameter serves two purposes in this operation. It identifies the properties that the write operation will set as well as the properties that the API response will include. The part properties that you can include in the parameter value are id, snippet, cdn, and status. Note that this method will override the existing values for all of the mutable properties that are contained in any parts that the parameter value specifies. If the request body does not specify a value for a mutable property, the existing value for that property will be removed.", "location": "query", "repeated": true, "required": true, @@ -2097,7 +2143,7 @@ ], "parameters": { "filterByMemberChannelId": { - "description": "Comma separated list of channel IDs. Only data about members that are part\nof this list will be included in the response.", + "description": "Comma separated list of channel IDs. Only data about members that are part of this list will be included in the response.", "location": "query", "type": "string" }, @@ -2108,7 +2154,7 @@ }, "maxResults": { "default": "5", - "description": "The maxResults parameter specifies the\nmaximum number of items that should be returned in the result set.", + "description": "The *maxResults* parameter specifies the maximum number of items that should be returned in the result set.", "format": "uint32", "location": "query", "type": "integer" @@ -2121,16 +2167,21 @@ "updates", "all_current" ], + "enumDescriptions": [ + "", + "", + "" + ], "location": "query", "type": "string" }, "pageToken": { - "description": "The pageToken parameter identifies a specific\npage in the result set that should be returned. In an API response, the\nnextPageToken and prevPageToken properties\nidentify other pages that could be retrieved.", + "description": "The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter specifies the\nmember resource parts that the API response will include. Set\nthe parameter value to snippet.", + "description": "The *part* parameter specifies the member resource parts that the API response will include. Set the parameter value to snippet.", "location": "query", "repeated": true, "required": true, @@ -2163,7 +2214,7 @@ ], "parameters": { "part": { - "description": "The part parameter specifies the\nmembershipsLevel resource parts that the API response will\ninclude. Supported values are id and snippet.", + "description": "The *part* parameter specifies the membershipsLevel resource parts that the API response will include. Supported values are id and snippet.", "location": "query", "repeated": true, "required": true, @@ -2201,7 +2252,7 @@ "type": "string" }, "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" } @@ -2223,12 +2274,12 @@ ], "parameters": { "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter serves two purposes in\nthis operation. It identifies the properties that the write operation will\nset as well as the properties that the API response will include.", + "description": "The *part* parameter serves two purposes in this operation. It identifies the properties that the write operation will set as well as the properties that the API response will include.", "location": "query", "repeated": true, "required": true, @@ -2264,23 +2315,23 @@ }, "maxResults": { "default": "5", - "description": "The maxResults parameter specifies the\nmaximum number of items that should be returned in the result set.", + "description": "The *maxResults* parameter specifies the maximum number of items that should be returned in the result set.", "format": "uint32", "location": "query", "type": "integer" }, "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "pageToken": { - "description": "The pageToken parameter identifies a specific\npage in the result set that should be returned. In an API response, the\nnextPageToken and prevPageToken properties\nidentify other pages that could be retrieved.", + "description": "The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter specifies a\ncomma-separated list of one or more playlistItem resource\nproperties that the API response will include.

If the parameter\nidentifies a property that contains child properties, the child properties\nwill be included in the response. For example, in a\nplaylistItem resource, the snippet property\ncontains numerous fields, including the title,\ndescription, position, and\nresourceId properties. As such, if you set\npart=snippet, the API response will contain\nall of those properties.", + "description": "The *part* parameter specifies a comma-separated list of one or more playlistItem resource properties that the API response will include. If the parameter identifies a property that contains child properties, the child properties will be included in the response. For example, in a playlistItem resource, the snippet property contains numerous fields, including the title, description, position, and resourceId properties. As such, if you set *part=snippet*, the API response will contain all of those properties.", "location": "query", "repeated": true, "required": true, @@ -2318,12 +2369,12 @@ ], "parameters": { "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter serves two purposes in\nthis operation. It identifies the properties that the write operation will\nset as well as the properties that the API response will\ninclude.

Note that this method will override the existing values\nfor all of the mutable properties that are contained in any parts that the\nparameter value specifies. For example, a playlist item can specify a start\ntime and end time, which identify the times portion of the video that\nshould play when users watch the video in the playlist. If your request is\nupdating a playlist item that sets these values, and the\nrequest's part parameter value includes the\ncontentDetails part, the playlist item's start and end times\nwill be updated to whatever value the request body specifies. If the\nrequest body does not specify values, the existing start and end times will\nbe removed and replaced with the default settings.", + "description": "The *part* parameter serves two purposes in this operation. It identifies the properties that the write operation will set as well as the properties that the API response will include. Note that this method will override the existing values for all of the mutable properties that are contained in any parts that the parameter value specifies. For example, a playlist item can specify a start time and end time, which identify the times portion of the video that should play when users watch the video in the playlist. If your request is updating a playlist item that sets these values, and the request's part parameter value includes the contentDetails part, the playlist item's start and end times will be updated to whatever value the request body specifies. If the request body does not specify values, the existing start and end times will be removed and replaced with the default settings.", "location": "query", "repeated": true, "required": true, @@ -2362,7 +2413,7 @@ "type": "string" }, "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" } @@ -2384,17 +2435,17 @@ ], "parameters": { "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "onBehalfOfContentOwnerChannel": { - "description": "This parameter can only be used in a properly authorized request.\nNote: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwnerChannel parameter\nspecifies the YouTube channel ID of the channel to which a video is being\nadded. This parameter is required when a request specifies a value for the\nonBehalfOfContentOwner parameter, and it can only be used in\nconjunction with that parameter. In addition, the request must be\nauthorized using a CMS account that is linked to the content owner that the\nonBehalfOfContentOwner parameter specifies. Finally, the\nchannel that the onBehalfOfContentOwnerChannel parameter value\nspecifies must be linked to the content owner that the\nonBehalfOfContentOwner parameter specifies.

This\nparameter is intended for YouTube content partners that own and manage many\ndifferent YouTube channels. It allows content owners to authenticate once\nand perform actions on behalf of the channel specified in the parameter\nvalue, without having to provide authentication credentials for each\nseparate channel.", + "description": "This parameter can only be used in a properly authorized request. *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwnerChannel* parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required when a request specifies a value for the onBehalfOfContentOwner parameter, and it can only be used in conjunction with that parameter. In addition, the request must be authorized using a CMS account that is linked to the content owner that the onBehalfOfContentOwner parameter specifies. Finally, the channel that the onBehalfOfContentOwnerChannel parameter value specifies must be linked to the content owner that the onBehalfOfContentOwner parameter specifies. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and perform actions on behalf of the channel specified in the parameter value, without having to provide authentication credentials for each separate channel.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter serves two purposes in\nthis operation. It identifies the properties that the write operation will\nset as well as the properties that the API response will include.", + "description": "The *part* parameter serves two purposes in this operation. It identifies the properties that the write operation will set as well as the properties that the API response will include.", "location": "query", "repeated": true, "required": true, @@ -2441,7 +2492,7 @@ }, "maxResults": { "default": "5", - "description": "The maxResults parameter specifies the\nmaximum number of items that should be returned in the result set.", + "description": "The *maxResults* parameter specifies the maximum number of items that should be returned in the result set.", "format": "uint32", "location": "query", "type": "integer" @@ -2452,22 +2503,22 @@ "type": "boolean" }, "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "onBehalfOfContentOwnerChannel": { - "description": "This parameter can only be used in a properly authorized request.\nNote: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwnerChannel parameter\nspecifies the YouTube channel ID of the channel to which a video is being\nadded. This parameter is required when a request specifies a value for the\nonBehalfOfContentOwner parameter, and it can only be used in\nconjunction with that parameter. In addition, the request must be\nauthorized using a CMS account that is linked to the content owner that the\nonBehalfOfContentOwner parameter specifies. Finally, the\nchannel that the onBehalfOfContentOwnerChannel parameter value\nspecifies must be linked to the content owner that the\nonBehalfOfContentOwner parameter specifies.

This\nparameter is intended for YouTube content partners that own and manage many\ndifferent YouTube channels. It allows content owners to authenticate once\nand perform actions on behalf of the channel specified in the parameter\nvalue, without having to provide authentication credentials for each\nseparate channel.", + "description": "This parameter can only be used in a properly authorized request. *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwnerChannel* parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required when a request specifies a value for the onBehalfOfContentOwner parameter, and it can only be used in conjunction with that parameter. In addition, the request must be authorized using a CMS account that is linked to the content owner that the onBehalfOfContentOwner parameter specifies. Finally, the channel that the onBehalfOfContentOwnerChannel parameter value specifies must be linked to the content owner that the onBehalfOfContentOwner parameter specifies. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and perform actions on behalf of the channel specified in the parameter value, without having to provide authentication credentials for each separate channel.", "location": "query", "type": "string" }, "pageToken": { - "description": "The pageToken parameter identifies a specific\npage in the result set that should be returned. In an API response, the\nnextPageToken and prevPageToken properties\nidentify other pages that could be retrieved.", + "description": "The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter specifies a\ncomma-separated list of one or more playlist resource\nproperties that the API response will include.

If the parameter\nidentifies a property that contains child properties, the child properties\nwill be included in the response. For example, in a playlist\nresource, the snippet property contains properties like\nauthor, title, description,\ntags, and timeCreated. As such, if you set\npart=snippet, the API response will contain\nall of those properties.", + "description": "The *part* parameter specifies a comma-separated list of one or more playlist resource properties that the API response will include. If the parameter identifies a property that contains child properties, the child properties will be included in the response. For example, in a playlist resource, the snippet property contains properties like author, title, description, tags, and timeCreated. As such, if you set *part=snippet*, the API response will contain all of those properties.", "location": "query", "repeated": true, "required": true, @@ -2495,12 +2546,12 @@ ], "parameters": { "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter serves two purposes in\nthis operation. It identifies the properties that the write operation will\nset as well as the properties that the API response will\ninclude.

Note that this method will override the existing values\nfor mutable properties that are contained in any parts that the request\nbody specifies. For example, a\nplaylist's description is contained in the snippet part, which\nmust be included in the request body. If the request does not specify a\nvalue for the snippet.description property, the playlist's\nexisting description will be deleted.", + "description": "The *part* parameter serves two purposes in this operation. It identifies the properties that the write operation will set as well as the properties that the API response will include. Note that this method will override the existing values for mutable properties that are contained in any parts that the request body specifies. For example, a playlist's description is contained in the snippet part, which must be included in the request body. If the request does not specify a value for the snippet.description property, the playlist's existing description will be deleted.", "location": "query", "repeated": true, "required": true, @@ -2545,6 +2596,11 @@ "any", "show" ], + "enumDescriptions": [ + "", + "", + "" + ], "location": "query", "type": "string" }, @@ -2556,6 +2612,12 @@ "live", "completed" ], + "enumDescriptions": [ + "", + "", + "", + "" + ], "location": "query", "type": "string" }, @@ -2565,7 +2627,7 @@ "type": "boolean" }, "forDeveloper": { - "description": "Restrict the search to only retrieve videos uploaded using the project id\nof the authenticated user.", + "description": "Restrict the search to only retrieve videos uploaded using the project id of the authenticated user.", "location": "query", "type": "boolean" }, @@ -2586,13 +2648,13 @@ }, "maxResults": { "default": "5", - "description": "The maxResults parameter specifies the\nmaximum number of items that should be returned in the result set.", + "description": "The *maxResults* parameter specifies the maximum number of items that should be returned in the result set.", "format": "uint32", "location": "query", "type": "integer" }, "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, @@ -2608,16 +2670,25 @@ "title", "videoCount" ], + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "" + ], "location": "query", "type": "string" }, "pageToken": { - "description": "The pageToken parameter identifies a specific\npage in the result set that should be returned. In an API response, the\nnextPageToken and prevPageToken properties\nidentify other pages that could be retrieved.", + "description": "The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter specifies a\ncomma-separated list of one or more search resource properties\nthat the API response will include. Set the parameter value to\nsnippet.", + "description": "The *part* parameter specifies a comma-separated list of one or more search resource properties that the API response will include. Set the parameter value to snippet.", "location": "query", "repeated": true, "required": true, @@ -2657,13 +2728,19 @@ }, "safeSearch": { "default": "moderate", - "description": "Indicates whether the search results should include restricted content as\nwell as standard content.", + "description": "Indicates whether the search results should include restricted content as well as standard content.", "enum": [ "safeSearchSettingUnspecified", "none", "moderate", "strict" ], + "enumDescriptions": [ + "", + "", + "", + "" + ], "location": "query", "type": "string" }, @@ -2687,6 +2764,12 @@ "closedCaption", "none" ], + "enumDescriptions": [ + "", + "", + "", + "" + ], "location": "query", "type": "string" }, @@ -2702,6 +2785,11 @@ "standard", "high" ], + "enumDescriptions": [ + "", + "", + "" + ], "location": "query", "type": "string" }, @@ -2712,6 +2800,11 @@ "2d", "3d" ], + "enumDescriptions": [ + "", + "2d", + "3d" + ], "location": "query", "type": "string" }, @@ -2724,6 +2817,13 @@ "medium", "long" ], + "enumDescriptions": [ + "", + "", + "", + "", + "" + ], "location": "query", "type": "string" }, @@ -2734,6 +2834,11 @@ "any", "true" ], + "enumDescriptions": [ + "", + "", + "" + ], "location": "query", "type": "string" }, @@ -2744,6 +2849,11 @@ "youtube", "creativeCommon" ], + "enumDescriptions": [ + "", + "", + "" + ], "location": "query", "type": "string" }, @@ -2754,6 +2864,11 @@ "any", "true" ], + "enumDescriptions": [ + "", + "", + "" + ], "location": "query", "type": "string" }, @@ -2765,6 +2880,12 @@ "movie", "episode" ], + "enumDescriptions": [ + "", + "", + "", + "" + ], "location": "query", "type": "string" } @@ -2785,7 +2906,7 @@ "sponsors": { "methods": { "list": { - "description": "Retrieves a list of sponsors that match the request criteria for a\nchannel.", + "description": "Retrieves a list of sponsors that match the request criteria for a channel.", "flatPath": "youtube/v3/sponsors", "httpMethod": "GET", "id": "youtube.sponsors.list", @@ -2801,23 +2922,28 @@ "newest", "all" ], + "enumDescriptions": [ + "", + "", + "" + ], "location": "query", "type": "string" }, "maxResults": { "default": "5", - "description": "The maxResults parameter specifies the\nmaximum number of items that should be returned in the result set.", + "description": "The *maxResults* parameter specifies the maximum number of items that should be returned in the result set.", "format": "uint32", "location": "query", "type": "integer" }, "pageToken": { - "description": "The pageToken parameter identifies a specific\npage in the result set that should be returned. In an API response, the\nnextPageToken and prevPageToken properties\nidentify other pages that could be retrieved.", + "description": "The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter specifies the\nsponsor resource parts that the API response will include.\nSupported values are id and snippet.", + "description": "The *part* parameter specifies the sponsor resource parts that the API response will include. Supported values are id and snippet.", "location": "query", "repeated": true, "required": true, @@ -2870,7 +2996,7 @@ ], "parameters": { "part": { - "description": "The part parameter serves two purposes in\nthis operation. It identifies the properties that the write operation will\nset as well as the properties that the API response will include.", + "description": "The *part* parameter serves two purposes in this operation. It identifies the properties that the write operation will set as well as the properties that the API response will include.", "location": "query", "repeated": true, "required": true, @@ -2905,7 +3031,7 @@ "type": "string" }, "forChannelId": { - "description": "Return the subscriptions to the subset of these channels that the\nauthenticated user is subscribed to.", + "description": "Return the subscriptions to the subset of these channels that the authenticated user is subscribed to.", "location": "query", "type": "string" }, @@ -2917,7 +3043,7 @@ }, "maxResults": { "default": "5", - "description": "The maxResults parameter specifies the\nmaximum number of items that should be returned in the result set.", + "description": "The *maxResults* parameter specifies the maximum number of items that should be returned in the result set.", "format": "uint32", "location": "query", "type": "integer" @@ -2937,12 +3063,12 @@ "type": "boolean" }, "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "onBehalfOfContentOwnerChannel": { - "description": "This parameter can only be used in a properly authorized request.\nNote: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwnerChannel parameter\nspecifies the YouTube channel ID of the channel to which a video is being\nadded. This parameter is required when a request specifies a value for the\nonBehalfOfContentOwner parameter, and it can only be used in\nconjunction with that parameter. In addition, the request must be\nauthorized using a CMS account that is linked to the content owner that the\nonBehalfOfContentOwner parameter specifies. Finally, the\nchannel that the onBehalfOfContentOwnerChannel parameter value\nspecifies must be linked to the content owner that the\nonBehalfOfContentOwner parameter specifies.

This\nparameter is intended for YouTube content partners that own and manage many\ndifferent YouTube channels. It allows content owners to authenticate once\nand perform actions on behalf of the channel specified in the parameter\nvalue, without having to provide authentication credentials for each\nseparate channel.", + "description": "This parameter can only be used in a properly authorized request. *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwnerChannel* parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required when a request specifies a value for the onBehalfOfContentOwner parameter, and it can only be used in conjunction with that parameter. In addition, the request must be authorized using a CMS account that is linked to the content owner that the onBehalfOfContentOwner parameter specifies. Finally, the channel that the onBehalfOfContentOwnerChannel parameter value specifies must be linked to the content owner that the onBehalfOfContentOwner parameter specifies. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and perform actions on behalf of the channel specified in the parameter value, without having to provide authentication credentials for each separate channel.", "location": "query", "type": "string" }, @@ -2955,16 +3081,22 @@ "unread", "alphabetical" ], + "enumDescriptions": [ + "", + "", + "", + "" + ], "location": "query", "type": "string" }, "pageToken": { - "description": "The pageToken parameter identifies a specific\npage in the result set that should be returned. In an API response, the\nnextPageToken and prevPageToken properties\nidentify other pages that could be retrieved.", + "description": "The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter specifies a\ncomma-separated list of one or more subscription resource\nproperties that the API response will include.

If the parameter\nidentifies a property that contains child properties, the child properties\nwill be included in the response. For example, in a\nsubscription resource, the snippet property\ncontains other properties, such as a display title for the subscription. If\nyou set part=snippet, the API response will\nalso contain all of those nested properties.", + "description": "The *part* parameter specifies a comma-separated list of one or more subscription resource properties that the API response will include. If the parameter identifies a property that contains child properties, the child properties will be included in the response. For example, in a subscription resource, the snippet property contains other properties, such as a display title for the subscription. If you set *part=snippet*, the API response will also contain all of those nested properties.", "location": "query", "repeated": true, "required": true, @@ -3002,18 +3134,18 @@ }, "maxResults": { "default": "5", - "description": "The maxResults parameter specifies the\nmaximum number of items that should be returned in the result set.", + "description": "The *maxResults* parameter specifies the maximum number of items that should be returned in the result set.", "format": "uint32", "location": "query", "type": "integer" }, "pageToken": { - "description": "The pageToken parameter identifies a specific\npage in the result set that should be returned. In an API response, the\nnextPageToken and prevPageToken properties\nidentify other pages that could be retrieved.", + "description": "The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter specifies the\nsuperChatEvent resource parts that the API response will\ninclude. Supported values are id and snippet.", + "description": "The *part* parameter specifies the superChatEvent resource parts that the API response will include. Supported values are id and snippet.", "location": "query", "repeated": true, "required": true, @@ -3093,6 +3225,10 @@ "linkUnspecified", "channelToStoreLink" ], + "enumDescriptions": [ + "", + "A link that is connecting (or about to connect) a channel with a store on a merchandising platform in order to enable retail commerce capabilities for that channel on YouTube." + ], "location": "query", "required": true, "type": "string" @@ -3110,7 +3246,7 @@ ], "parameters": { "part": { - "description": "The part parameter specifies the\nthirdPartyLink resource parts that the API request and\nresponse will include. Supported values are linkingToken,\nstatus, and snippet.", + "description": "The *part* parameter specifies the thirdPartyLink resource parts that the API request and response will include. Supported values are linkingToken, status, and snippet.", "location": "query", "repeated": true, "required": true, @@ -3140,7 +3276,7 @@ "type": "string" }, "part": { - "description": "The part parameter specifies the\nthirdPartyLink resource parts that the API response will\ninclude. Supported values are linkingToken,\nstatus, and snippet.", + "description": "The *part* parameter specifies the thirdPartyLink resource parts that the API response will include. Supported values are linkingToken, status, and snippet.", "location": "query", "repeated": true, "required": true, @@ -3152,6 +3288,10 @@ "linkUnspecified", "channelToStoreLink" ], + "enumDescriptions": [ + "", + "A link that is connecting (or about to connect) a channel with a store on a merchandising platform in order to enable retail commerce capabilities for that channel on YouTube." + ], "location": "query", "type": "string" } @@ -3171,7 +3311,7 @@ ], "parameters": { "part": { - "description": "The part parameter specifies the\nthirdPartyLink resource parts that the API request and\nresponse will include. Supported values are linkingToken,\nstatus, and snippet.", + "description": "The *part* parameter specifies the thirdPartyLink resource parts that the API request and response will include. Supported values are linkingToken, status, and snippet.", "location": "query", "repeated": true, "required": true, @@ -3191,7 +3331,7 @@ "thumbnails": { "methods": { "set": { - "description": "As this is not an insert in a strict sense (it supports uploading/setting\nof a thumbnail for multiple videos, which doesn't result in creation of a\nsingle resource), I use a custom verb here.", + "description": "As this is not an insert in a strict sense (it supports uploading/setting of a thumbnail for multiple videos, which doesn't result in creation of a single resource), I use a custom verb here.", "flatPath": "youtube/v3/thumbnails/set", "httpMethod": "POST", "id": "youtube.thumbnails.set", @@ -3214,7 +3354,7 @@ ], "parameters": { "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The actual\nCMS account that the user authenticates with must be linked to the\nspecified YouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The actual CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, @@ -3256,7 +3396,7 @@ "type": "string" }, "part": { - "description": "The part parameter specifies the\nvideoCategory resource parts that the API response will\ninclude. Supported values are id and snippet.", + "description": "The *part* parameter specifies the videoCategory resource parts that the API response will include. Supported values are id and snippet.", "location": "query", "repeated": true, "required": true, @@ -3298,7 +3438,7 @@ "type": "string" }, "part": { - "description": "The part parameter specifies the\nvideoCategory resource properties that the API response will\ninclude. Set the parameter value to snippet.", + "description": "The *part* parameter specifies the videoCategory resource properties that the API response will include. Set the parameter value to snippet.", "location": "query", "repeated": true, "required": true, @@ -3339,7 +3479,7 @@ "type": "string" }, "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The actual\nCMS account that the user authenticates with must be linked to the\nspecified YouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The actual CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" } @@ -3352,7 +3492,7 @@ ] }, "getRating": { - "description": "Retrieves the ratings that the authorized user gave to a list of specified\nvideos.", + "description": "Retrieves the ratings that the authorized user gave to a list of specified videos.", "flatPath": "youtube/v3/videos/getRating", "httpMethod": "GET", "id": "youtube.videos.getRating", @@ -3367,7 +3507,7 @@ "type": "string" }, "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" } @@ -3411,22 +3551,22 @@ }, "notifySubscribers": { "default": "true", - "description": "Notify the channel subscribers about the new video. As default, the\nnotification is enabled.", + "description": "Notify the channel subscribers about the new video. As default, the notification is enabled.", "location": "query", "type": "boolean" }, "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "onBehalfOfContentOwnerChannel": { - "description": "This parameter can only be used in a properly authorized request.\nNote: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwnerChannel parameter\nspecifies the YouTube channel ID of the channel to which a video is being\nadded. This parameter is required when a request specifies a value for the\nonBehalfOfContentOwner parameter, and it can only be used in\nconjunction with that parameter. In addition, the request must be\nauthorized using a CMS account that is linked to the content owner that the\nonBehalfOfContentOwner parameter specifies. Finally, the\nchannel that the onBehalfOfContentOwnerChannel parameter value\nspecifies must be linked to the content owner that the\nonBehalfOfContentOwner parameter specifies.

This\nparameter is intended for YouTube content partners that own and manage many\ndifferent YouTube channels. It allows content owners to authenticate once\nand perform actions on behalf of the channel specified in the parameter\nvalue, without having to provide authentication credentials for each\nseparate channel.", + "description": "This parameter can only be used in a properly authorized request. *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwnerChannel* parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required when a request specifies a value for the onBehalfOfContentOwner parameter, and it can only be used in conjunction with that parameter. In addition, the request must be authorized using a CMS account that is linked to the content owner that the onBehalfOfContentOwner parameter specifies. Finally, the channel that the onBehalfOfContentOwnerChannel parameter value specifies must be linked to the content owner that the onBehalfOfContentOwner parameter specifies. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and perform actions on behalf of the channel specified in the parameter value, without having to provide authentication credentials for each separate channel.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter serves two purposes in\nthis operation. It identifies the properties that the write operation will\nset as well as the properties that the API response will\ninclude.

Note that not all parts contain properties that can be\nset when inserting or updating a video. For example, the\nstatistics object encapsulates statistics that YouTube\ncalculates for a video and does not contain values that you can set or\nmodify. If the parameter value specifies a part that does not\ncontain mutable values, that part will still be included in\nthe API response.", + "description": "The *part* parameter serves two purposes in this operation. It identifies the properties that the write operation will set as well as the properties that the API response will include. Note that not all parts contain properties that can be set when inserting or updating a video. For example, the statistics object encapsulates statistics that YouTube calculates for a video and does not contain values that you can set or modify. If the parameter value specifies a part that does not contain mutable values, that part will still be included in the API response.", "location": "query", "repeated": true, "required": true, @@ -3468,11 +3608,15 @@ "chartUnspecified", "mostPopular" ], + "enumDescriptions": [ + "", + "" + ], "location": "query", "type": "string" }, "hl": { - "description": "Stands for \"host language\". Specifies the localization language of the\nmetadata to be filled into snippet.localized. The field is filled with the\ndefault metadata if there is no localization in the specified language.\nThe parameter value must be a language code included in the list returned\nby the i18nLanguages.list method (e.g. en_US, es_MX).", + "description": "Stands for \"host language\". Specifies the localization language of the metadata to be filled into snippet.localized. The field is filled with the default metadata if there is no localization in the specified language. The parameter value must be a language code included in the list returned by the i18nLanguages.list method (e.g. en_US, es_MX).", "location": "query", "type": "string" }, @@ -3493,7 +3637,7 @@ }, "maxResults": { "default": "5", - "description": "The maxResults parameter specifies the\nmaximum number of items that should be returned in the result\nset.

Note: This parameter is supported for use in\nconjunction with the myRating and\nchart parameters, but it is not supported\nfor use in conjunction with the id\nparameter.", + "description": "The *maxResults* parameter specifies the maximum number of items that should be returned in the result set. *Note:* This parameter is supported for use in conjunction with the myRating and chart parameters, but it is not supported for use in conjunction with the id parameter.", "format": "uint32", "location": "query", "type": "integer" @@ -3505,27 +3649,32 @@ "type": "integer" }, "myRating": { - "description": "Return videos liked/disliked by the authenticated user.\nDoes not support RateType.RATED_TYPE_NONE.", + "description": "Return videos liked/disliked by the authenticated user. Does not support RateType.RATED_TYPE_NONE.", "enum": [ "none", "like", "dislike" ], + "enumDescriptions": [ + "", + "", + "" + ], "location": "query", "type": "string" }, "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "pageToken": { - "description": "The pageToken parameter identifies a specific\npage in the result set that should be returned. In an API response, the\nnextPageToken and prevPageToken properties\nidentify other pages that could be retrieved.

Note:\nThis parameter is supported for use in conjunction with the myRating and chart parameters, but it is not supported for use\nin conjunction with the id parameter.", + "description": "The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved. *Note:* This parameter is supported for use in conjunction with the myRating and chart parameters, but it is not supported for use in conjunction with the id parameter.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter specifies a\ncomma-separated list of one or more video resource properties\nthat the API response will include.

If the parameter identifies a\nproperty that contains child properties, the child properties will be\nincluded in the response. For example, in a video resource,\nthe snippet property contains the channelId,\ntitle, description, tags, and\ncategoryId properties. As such, if you set\npart=snippet, the API response will contain\nall of those properties.", + "description": "The *part* parameter specifies a comma-separated list of one or more video resource properties that the API response will include. If the parameter identifies a property that contains child properties, the child properties will be included in the response. For example, in a video resource, the snippet property contains the channelId, title, description, tags, and categoryId properties. As such, if you set *part=snippet*, the API response will contain all of those properties.", "location": "query", "repeated": true, "required": true, @@ -3575,6 +3724,11 @@ "like", "dislike" ], + "enumDescriptions": [ + "", + "", + "" + ], "location": "query", "required": true, "type": "string" @@ -3595,7 +3749,7 @@ "parameterOrder": [], "parameters": { "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" } @@ -3620,12 +3774,12 @@ ], "parameters": { "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The actual\nCMS account that the user authenticates with must be linked to the\nspecified YouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The actual CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" }, "part": { - "description": "The part parameter serves two purposes in\nthis operation. It identifies the properties that the write operation will\nset as well as the properties that the API response will\ninclude.

Note that this method will override the existing values\nfor all of the mutable properties that are contained in any parts that the\nparameter value specifies. For example, a\nvideo's privacy setting is contained in the status part. As\nsuch, if your request is updating a private video, and the request's\npart parameter value includes the status part,\nthe\nvideo's privacy setting will be updated to whatever value the request body\nspecifies. If the request body does not specify a value, the existing\nprivacy setting will be removed and the video will revert to the default\nprivacy setting.

In addition, not all parts contain properties\nthat can be set when inserting or updating a video. For example, the\nstatistics object encapsulates statistics that YouTube\ncalculates for a video and does not contain values that you can set or\nmodify. If the parameter value specifies a part that does not\ncontain mutable values, that part will still be included in\nthe API response.", + "description": "The *part* parameter serves two purposes in this operation. It identifies the properties that the write operation will set as well as the properties that the API response will include. Note that this method will override the existing values for all of the mutable properties that are contained in any parts that the parameter value specifies. For example, a video's privacy setting is contained in the status part. As such, if your request is updating a private video, and the request's part parameter value includes the status part, the video's privacy setting will be updated to whatever value the request body specifies. If the request body does not specify a value, the existing privacy setting will be removed and the video will revert to the default privacy setting. In addition, not all parts contain properties that can be set when inserting or updating a video. For example, the statistics object encapsulates statistics that YouTube calculates for a video and does not contain values that you can set or modify. If the parameter value specifies a part that does not contain mutable values, that part will still be included in the API response.", "location": "query", "repeated": true, "required": true, @@ -3678,7 +3832,7 @@ "type": "string" }, "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" } @@ -3710,7 +3864,7 @@ "type": "string" }, "onBehalfOfContentOwner": { - "description": "Note: This parameter is intended exclusively for YouTube\ncontent partners.

The\nonBehalfOfContentOwner parameter indicates\nthat the\nrequest's authorization credentials identify a YouTube CMS user who is\nacting on behalf of the content owner specified in the parameter value.\nThis parameter is intended for YouTube content partners that own and manage\nmany different YouTube channels. It allows content owners to authenticate\nonce and get access to all their video and channel data, without having to\nprovide authentication credentials for each individual channel. The CMS\naccount that the user authenticates with must be linked to the specified\nYouTube content owner.", + "description": "*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.", "location": "query", "type": "string" } @@ -3729,7 +3883,7 @@ "v3": { "methods": { "infocards": { - "description": "Updates infocards for a given video.\nNote:\n* If the card id is not provided, a new card will be created.\n* If the card id is provided, that card will be updated.\n* Existing cards will be discarded if they're not included in the request.", + "description": "Updates infocards for a given video. Note: * If the card id is not provided, a new card will be created. * If the card id is provided, that card will be updated. * Existing cards will be discarded if they're not included in the request.", "flatPath": "youtube/v3/infocards", "httpMethod": "POST", "id": "youtube.youtube.v3.infocards", @@ -3816,7 +3970,7 @@ } } }, - "revision": "20200722", + "revision": "20200802", "rootUrl": "https://www.googleapis.com/", "schemas": { "AbuseReport": { @@ -3857,11 +4011,11 @@ "id": "AccessPolicy", "properties": { "allowed": { - "description": "The value of allowed indicates whether the access to the\npolicy is allowed or denied by default.", + "description": "The value of allowed indicates whether the access to the policy is allowed or denied by default.", "type": "boolean" }, "exception": { - "description": "A list of region codes that identify countries where the default policy do\nnot apply.", + "description": "A list of region codes that identify countries where the default policy do not apply.", "items": { "type": "string" }, @@ -3871,12 +4025,12 @@ "type": "object" }, "Activity": { - "description": "An activity resource contains\ninformation about an action that a particular channel, or user, has\ntaken on YouTube.The actions reported in activity feeds include rating\na video, sharing a video, marking a video as a favorite, commenting on\na video, uploading a video, and so forth. Each activity\nresource identifies the type of action, the channel associated with\nthe action, and the resource(s) associated with the action, such as\nthe video that was rated or uploaded.", + "description": "An *activity* resource contains information about an action that a particular channel, or user, has taken on YouTube.The actions reported in activity feeds include rating a video, sharing a video, marking a video as a favorite, commenting on a video, uploading a video, and so forth. Each activity resource identifies the type of action, the channel associated with the action, and the resource(s) associated with the action, such as the video that was rated or uploaded.", "id": "Activity", "properties": { "contentDetails": { "$ref": "ActivityContentDetails", - "description": "The contentDetails object contains information about the\ncontent associated with the activity. For example, if the\nsnippet.type value is videoRated, then the\ncontentDetails object's content identifies the rated video." + "description": "The contentDetails object contains information about the content associated with the activity. For example, if the snippet.type value is videoRated, then the contentDetails object's content identifies the rated video." }, "etag": { "description": "Etag of this resource", @@ -3888,63 +4042,63 @@ }, "kind": { "default": "youtube#activity", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#activity\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#activity\".", "type": "string" }, "snippet": { "$ref": "ActivitySnippet", - "description": "The snippet object contains basic details about the\nactivity, including the activity's type and group ID." + "description": "The snippet object contains basic details about the activity, including the activity's type and group ID." } }, "type": "object" }, "ActivityContentDetails": { - "description": "Details about the content of an activity: the video that was shared, the\nchannel that was subscribed to, etc.", + "description": "Details about the content of an activity: the video that was shared, the channel that was subscribed to, etc.", "id": "ActivityContentDetails", "properties": { "bulletin": { "$ref": "ActivityContentDetailsBulletin", - "description": "The bulletin object contains details about a channel\nbulletin post. This object is only present if the\nsnippet.type is bulletin." + "description": "The bulletin object contains details about a channel bulletin post. This object is only present if the snippet.type is bulletin." }, "channelItem": { "$ref": "ActivityContentDetailsChannelItem", - "description": "The channelItem object contains details about a resource\nwhich was added to a channel. This property is only present if the\nsnippet.type is channelItem." + "description": "The channelItem object contains details about a resource which was added to a channel. This property is only present if the snippet.type is channelItem." }, "comment": { "$ref": "ActivityContentDetailsComment", - "description": "The comment object contains information about a resource\nthat received a comment. This property is only present if the\nsnippet.type is comment." + "description": "The comment object contains information about a resource that received a comment. This property is only present if the snippet.type is comment." }, "favorite": { "$ref": "ActivityContentDetailsFavorite", - "description": "The favorite object contains information about a video that\nwas marked as a favorite video. This property is only present if the\nsnippet.type is favorite." + "description": "The favorite object contains information about a video that was marked as a favorite video. This property is only present if the snippet.type is favorite." }, "like": { "$ref": "ActivityContentDetailsLike", - "description": "The like object contains information about a resource that\nreceived a positive (like) rating. This property is only present if\nthe snippet.type is like." + "description": "The like object contains information about a resource that received a positive (like) rating. This property is only present if the snippet.type is like." }, "playlistItem": { "$ref": "ActivityContentDetailsPlaylistItem", - "description": "The playlistItem object contains information about a\nnew playlist item. This property is only present if the\nsnippet.type is playlistItem." + "description": "The playlistItem object contains information about a new playlist item. This property is only present if the snippet.type is playlistItem." }, "promotedItem": { "$ref": "ActivityContentDetailsPromotedItem", - "description": "The promotedItem object contains details about a resource\nwhich is being promoted. This property is only present if the\nsnippet.type is promotedItem." + "description": "The promotedItem object contains details about a resource which is being promoted. This property is only present if the snippet.type is promotedItem." }, "recommendation": { "$ref": "ActivityContentDetailsRecommendation", - "description": "The recommendation object contains information about a\nrecommended resource. This property is only present if the\nsnippet.type is recommendation." + "description": "The recommendation object contains information about a recommended resource. This property is only present if the snippet.type is recommendation." }, "social": { "$ref": "ActivityContentDetailsSocial", - "description": "The social object contains details about a social network\npost. This property is only present if the snippet.type\nis social." + "description": "The social object contains details about a social network post. This property is only present if the snippet.type is social." }, "subscription": { "$ref": "ActivityContentDetailsSubscription", - "description": "The subscription object contains information about a\nchannel that a user subscribed to. This property is only\npresent if the snippet.type is subscription." + "description": "The subscription object contains information about a channel that a user subscribed to. This property is only present if the snippet.type is subscription." }, "upload": { "$ref": "ActivityContentDetailsUpload", - "description": "The upload object contains information about the uploaded\nvideo. This property is only present if the snippet.type\nis upload." + "description": "The upload object contains information about the uploaded video. This property is only present if the snippet.type is upload." } }, "type": "object" @@ -3955,7 +4109,7 @@ "properties": { "resourceId": { "$ref": "ResourceId", - "description": "The resourceId object contains information that\nidentifies the resource associated with a bulletin post.\n@mutable youtube.activities.insert" + "description": "The resourceId object contains information that identifies the resource associated with a bulletin post. @mutable youtube.activities.insert" } }, "type": "object" @@ -3966,7 +4120,7 @@ "properties": { "resourceId": { "$ref": "ResourceId", - "description": "The resourceId object contains information that\nidentifies the resource that was added to the channel." + "description": "The resourceId object contains information that identifies the resource that was added to the channel." } }, "type": "object" @@ -3977,7 +4131,7 @@ "properties": { "resourceId": { "$ref": "ResourceId", - "description": "The resourceId object contains information that\nidentifies the resource associated with the comment." + "description": "The resourceId object contains information that identifies the resource associated with the comment." } }, "type": "object" @@ -3988,7 +4142,7 @@ "properties": { "resourceId": { "$ref": "ResourceId", - "description": "The resourceId object contains information that\nidentifies the resource that was marked as a favorite." + "description": "The resourceId object contains information that identifies the resource that was marked as a favorite." } }, "type": "object" @@ -3999,7 +4153,7 @@ "properties": { "resourceId": { "$ref": "ResourceId", - "description": "The resourceId object contains information that identifies\nthe rated resource." + "description": "The resourceId object contains information that identifies the rated resource." } }, "type": "object" @@ -4018,7 +4172,7 @@ }, "resourceId": { "$ref": "ResourceId", - "description": "The resourceId object contains information about the\nresource that was added to the playlist." + "description": "The resourceId object contains information about the resource that was added to the playlist." } }, "type": "object" @@ -4032,15 +4186,15 @@ "type": "string" }, "clickTrackingUrl": { - "description": "The URL the client should ping to indicate that the user clicked through\non this promoted item.", + "description": "The URL the client should ping to indicate that the user clicked through on this promoted item.", "type": "string" }, "creativeViewUrl": { - "description": "The URL the client should ping to indicate that the user was shown this\npromoted item.", + "description": "The URL the client should ping to indicate that the user was shown this promoted item.", "type": "string" }, "ctaType": { - "description": "The type of call-to-action, a message to the user indicating action that\ncan be taken.", + "description": "The type of call-to-action, a message to the user indicating action that can be taken.", "enum": [ "ctaTypeUnspecified", "visitAdvertiserSite" @@ -4052,7 +4206,7 @@ "type": "string" }, "customCtaButtonText": { - "description": "The custom call-to-action button text. If specified, it will override\nthe default button text for the cta_type.", + "description": "The custom call-to-action button text. If specified, it will override the default button text for the cta_type.", "type": "string" }, "descriptionText": { @@ -4060,18 +4214,18 @@ "type": "string" }, "destinationUrl": { - "description": "The URL the client should direct the user to, if the user chooses to\nvisit the advertiser's website.", + "description": "The URL the client should direct the user to, if the user chooses to visit the advertiser's website.", "type": "string" }, "forecastingUrl": { - "description": "The list of forecasting URLs. The client should ping all of these URLs\nwhen a promoted item is not available, to indicate that a promoted item\ncould have been shown.", + "description": "The list of forecasting URLs. The client should ping all of these URLs when a promoted item is not available, to indicate that a promoted item could have been shown.", "items": { "type": "string" }, "type": "array" }, "impressionUrl": { - "description": "The list of impression URLs. The client should ping all of these URLs to\nindicate that the user was shown this promoted item.", + "description": "The list of impression URLs. The client should ping all of these URLs to indicate that the user was shown this promoted item.", "items": { "type": "string" }, @@ -4106,11 +4260,11 @@ }, "resourceId": { "$ref": "ResourceId", - "description": "The resourceId object contains information that\nidentifies the recommended resource." + "description": "The resourceId object contains information that identifies the recommended resource." }, "seedResourceId": { "$ref": "ResourceId", - "description": "The seedResourceId object contains information about\nthe resource that caused the recommendation." + "description": "The seedResourceId object contains information about the resource that caused the recommendation." } }, "type": "object" @@ -4133,7 +4287,7 @@ }, "resourceId": { "$ref": "ResourceId", - "description": "The resourceId object encapsulates information that\nidentifies the resource associated with a social network post." + "description": "The resourceId object encapsulates information that identifies the resource associated with a social network post." }, "type": { "description": "The name of the social network.", @@ -4160,7 +4314,7 @@ "properties": { "resourceId": { "$ref": "ResourceId", - "description": "The resourceId object contains information that\nidentifies the resource that the user subscribed to." + "description": "The resourceId object contains information that identifies the resource that the user subscribed to." } }, "type": "object" @@ -4195,11 +4349,11 @@ }, "kind": { "default": "youtube#activityListResponse", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#activityListResponse\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#activityListResponse\".", "type": "string" }, "nextPageToken": { - "description": "The token that can be used as the value of the pageToken\nparameter to retrieve the next page in the result set.", + "description": "The token that can be used as the value of the pageToken parameter to retrieve the next page in the result set.", "type": "string" }, "pageInfo": { @@ -4207,25 +4361,25 @@ "description": "General pagination information." }, "prevPageToken": { - "description": "The token that can be used as the value of the pageToken\nparameter to retrieve the previous page in the result set.", + "description": "The token that can be used as the value of the pageToken parameter to retrieve the previous page in the result set.", "type": "string" }, "tokenPagination": { "$ref": "TokenPagination" }, "visitorId": { - "description": "The visitorId identifies the visitor.", + "description": "The visitorId identifies the visitor.", "type": "string" } }, "type": "object" }, "ActivitySnippet": { - "description": "Basic details about an activity, including title, description, thumbnails,\nactivity type and group.\nNext ID: 12", + "description": "Basic details about an activity, including title, description, thumbnails, activity type and group. Next ID: 12", "id": "ActivitySnippet", "properties": { "channelId": { - "description": "The ID that YouTube uses to uniquely identify the channel associated\nwith the activity.", + "description": "The ID that YouTube uses to uniquely identify the channel associated with the activity.", "type": "string" }, "channelTitle": { @@ -4233,20 +4387,20 @@ "type": "string" }, "description": { - "description": "The description of the resource primarily associated with the activity.\n@mutable youtube.activities.insert", + "description": "The description of the resource primarily associated with the activity. @mutable youtube.activities.insert", "type": "string" }, "groupId": { - "description": "The group ID associated with the activity. A group ID identifies user\nevents that are associated with the same user and resource. For example,\nif a user rates a video and marks the same video as a favorite, the\nentries for those events would have the same group ID in the user's\nactivity feed. In your user interface, you can avoid repetition by\ngrouping events with the same groupId value.", + "description": "The group ID associated with the activity. A group ID identifies user events that are associated with the same user and resource. For example, if a user rates a video and marks the same video as a favorite, the entries for those events would have the same group ID in the user's activity feed. In your user interface, you can avoid repetition by grouping events with the same groupId value.", "type": "string" }, "publishedAt": { - "description": "The date and time that the video was uploaded. The value is specified\nin ISO 8601\nformat.", + "description": "The date and time that the video was uploaded. The value is specified in ISO 8601 format.", "type": "string" }, "thumbnails": { "$ref": "ThumbnailDetails", - "description": "A map of thumbnail images associated with the resource that is primarily\nassociated with the activity. For each object in the map, the key is the\nname of the thumbnail image, and the value is an object that contains\nother information about the thumbnail." + "description": "A map of thumbnail images associated with the resource that is primarily associated with the activity. For each object in the map, the key is the name of the thumbnail image, and the value is an object that contains other information about the thumbnail." }, "title": { "description": "The title of the resource primarily associated with the activity.", @@ -4288,7 +4442,7 @@ "type": "object" }, "Caption": { - "description": "A caption resource represents a YouTube\ncaption track. A caption track is associated with exactly one YouTube\nvideo.", + "description": "A *caption* resource represents a YouTube caption track. A caption track is associated with exactly one YouTube video.", "id": "Caption", "properties": { "etag": { @@ -4306,12 +4460,12 @@ }, "kind": { "default": "youtube#caption", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#caption\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#caption\".", "type": "string" }, "snippet": { "$ref": "CaptionSnippet", - "description": "The snippet object contains basic details about the caption." + "description": "The snippet object contains basic details about the caption." } }, "type": "object" @@ -4336,11 +4490,11 @@ }, "kind": { "default": "youtube#captionListResponse", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#captionListResponse\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#captionListResponse\".", "type": "string" }, "visitorId": { - "description": "The visitorId identifies the visitor.", + "description": "The visitorId identifies the visitor.", "type": "string" } }, @@ -4367,7 +4521,7 @@ "type": "string" }, "failureReason": { - "description": "The reason that YouTube failed to process the caption track. This\nproperty is only present if the state\nproperty's value is failed.", + "description": "The reason that YouTube failed to process the caption track. This property is only present if the state property's value is failed.", "enum": [ "unknownFormat", "unsupportedFormat", @@ -4381,35 +4535,35 @@ "type": "string" }, "isAutoSynced": { - "description": "Indicates whether YouTube synchronized the caption track to the audio\ntrack in the video. The value will be true if a sync was\nexplicitly requested when the caption track was uploaded. For example,\nwhen calling the captions.insert or\ncaptions.update methods, you can set the sync\nparameter to true to instruct YouTube to sync the uploaded\ntrack to the video. If the value is false, YouTube uses\nthe time codes in the uploaded caption track to determine when to display\ncaptions.", + "description": "Indicates whether YouTube synchronized the caption track to the audio track in the video. The value will be true if a sync was explicitly requested when the caption track was uploaded. For example, when calling the captions.insert or captions.update methods, you can set the sync parameter to true to instruct YouTube to sync the uploaded track to the video. If the value is false, YouTube uses the time codes in the uploaded caption track to determine when to display captions.", "type": "boolean" }, "isCC": { - "description": "Indicates whether the track contains closed captions for the deaf\nand hard of hearing. The default value is false.", + "description": "Indicates whether the track contains closed captions for the deaf and hard of hearing. The default value is false.", "type": "boolean" }, "isDraft": { - "description": "Indicates whether the caption track is a draft. If the value is\ntrue, then the track is not publicly visible.\nThe default value is false.\n@mutable youtube.captions.insert youtube.captions.update", + "description": "Indicates whether the caption track is a draft. If the value is true, then the track is not publicly visible. The default value is false. @mutable youtube.captions.insert youtube.captions.update", "type": "boolean" }, "isEasyReader": { - "description": "Indicates whether caption track is formatted for \"easy reader,\"\nmeaning it is at a third-grade level for language learners.\nThe default value is false.", + "description": "Indicates whether caption track is formatted for \"easy reader,\" meaning it is at a third-grade level for language learners. The default value is false.", "type": "boolean" }, "isLarge": { - "description": "Indicates whether the caption track uses large text for the\nvision-impaired. The default value is false.", + "description": "Indicates whether the caption track uses large text for the vision-impaired. The default value is false.", "type": "boolean" }, "language": { - "description": "The language of the caption track. The property value is a\nBCP-47\n language tag.", + "description": "The language of the caption track. The property value is a BCP-47 language tag.", "type": "string" }, "lastUpdated": { - "description": "The date and time when the caption track was last updated. The value is\nspecified in ISO 8601\nformat.", + "description": "The date and time when the caption track was last updated. The value is specified in ISO 8601 format.", "type": "string" }, "name": { - "description": "The name of the caption track. The name is intended to be visible\nto the user as an option during playback.", + "description": "The name of the caption track. The name is intended to be visible to the user as an option during playback.", "type": "string" }, "status": { @@ -4446,7 +4600,7 @@ "youtube.captions.insert" ] }, - "description": "The ID that YouTube uses to uniquely identify the video associated\nwith the caption track.\n@mutable youtube.captions.insert", + "description": "The ID that YouTube uses to uniquely identify the video associated with the caption track. @mutable youtube.captions.insert", "type": "string" } }, @@ -4457,7 +4611,7 @@ "id": "CdnSettings", "properties": { "format": { - "description": "The format of the video stream that you are sending to Youtube.

", + "description": "The format of the video stream that you are sending to Youtube. ", "type": "string" }, "frameRate": { @@ -4476,7 +4630,7 @@ }, "ingestionInfo": { "$ref": "IngestionInfo", - "description": "The ingestionInfo object contains information that YouTube\nprovides that you need to transmit your RTMP or HTTP stream to YouTube." + "description": "The ingestionInfo object contains information that YouTube provides that you need to transmit your RTMP or HTTP stream to YouTube." }, "ingestionType": { "description": " The method or protocol used to transmit the video stream.", @@ -4522,28 +4676,28 @@ "type": "object" }, "Channel": { - "description": "A channel resource contains\ninformation about a YouTube channel.", + "description": "A *channel* resource contains information about a YouTube channel.", "id": "Channel", "properties": { "auditDetails": { "$ref": "ChannelAuditDetails", - "description": "The auditionDetails object encapsulates channel data\nthat is relevant for YouTube Partners during the audition process." + "description": "The auditionDetails object encapsulates channel data that is relevant for YouTube Partners during the audition process." }, "brandingSettings": { "$ref": "ChannelBrandingSettings", - "description": "The brandingSettings object encapsulates information about\nthe branding of the channel." + "description": "The brandingSettings object encapsulates information about the branding of the channel." }, "contentDetails": { "$ref": "ChannelContentDetails", - "description": "The contentDetails object encapsulates information about the\nchannel's content." + "description": "The contentDetails object encapsulates information about the channel's content." }, "contentOwnerDetails": { "$ref": "ChannelContentOwnerDetails", - "description": "The contentOwnerDetails object encapsulates channel data\nthat is relevant for YouTube Partners linked with the channel." + "description": "The contentOwnerDetails object encapsulates channel data that is relevant for YouTube Partners linked with the channel." }, "conversionPings": { "$ref": "ChannelConversionPings", - "description": "The conversionPings object encapsulates information about\nconversion pings that need to be respected by the channel." + "description": "The conversionPings object encapsulates information about conversion pings that need to be respected by the channel." }, "etag": { "description": "Etag of this resource.", @@ -4555,11 +4709,11 @@ }, "invideoPromotion": { "$ref": "InvideoPromotion", - "description": "The invideoPromotion object encapsulates information about\npromotion campaign associated with the channel." + "description": "The invideoPromotion object encapsulates information about promotion campaign associated with the channel." }, "kind": { "default": "youtube#channel", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#channel\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#channel\".", "type": "string" }, "localizations": { @@ -4571,25 +4725,25 @@ }, "snippet": { "$ref": "ChannelSnippet", - "description": "The snippet object contains basic details about the channel,\nsuch as its title, description, and thumbnail images." + "description": "The snippet object contains basic details about the channel, such as its title, description, and thumbnail images." }, "statistics": { "$ref": "ChannelStatistics", - "description": "The statistics object encapsulates statistics for the channel." + "description": "The statistics object encapsulates statistics for the channel." }, "status": { "$ref": "ChannelStatus", - "description": "The status object encapsulates information about the privacy\nstatus of the channel." + "description": "The status object encapsulates information about the privacy status of the channel." }, "topicDetails": { "$ref": "ChannelTopicDetails", - "description": "The topicDetails object encapsulates information about\nFreebase topics associated with the\nchannel." + "description": "The topicDetails object encapsulates information about Freebase topics associated with the channel." } }, "type": "object" }, "ChannelAuditDetails": { - "description": "The auditDetails object encapsulates channel data that is\nrelevant for YouTube Partners during the audit process.", + "description": "The auditDetails object encapsulates channel data that is relevant for YouTube Partners during the audit process.", "id": "ChannelAuditDetails", "properties": { "communityGuidelinesGoodStanding": { @@ -4616,7 +4770,7 @@ }, "kind": { "default": "youtube#channelBannerResource", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#channelBannerResource\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#channelBannerResource\".", "type": "string" }, "url": { @@ -4656,11 +4810,11 @@ "id": "ChannelCard", "properties": { "channelId": { - "description": "External channel ID.\nRequired.", + "description": "External channel ID. Required.", "type": "string" }, "customMessage": { - "description": "Each card can have a custom message.\nRequired.", + "description": "Each card can have a custom message. Required.", "type": "string" } }, @@ -4673,23 +4827,23 @@ "relatedPlaylists": { "properties": { "favorites": { - "description": "The ID of the playlist that contains the channel\"s favorite videos. Use\nthe playlistItems.insert\nand playlistItems.delete\nto add or remove items from that list.", + "description": "The ID of the playlist that contains the channel\"s favorite videos. Use the playlistItems.insert and playlistItems.delete to add or remove items from that list.", "type": "string" }, "likes": { - "description": "The ID of the playlist that contains the channel\"s liked videos. Use the\n \nplaylistItems.insert and playlistItems.delete\nto add or remove items from that list.", + "description": "The ID of the playlist that contains the channel\"s liked videos. Use the playlistItems.insert and playlistItems.delete to add or remove items from that list.", "type": "string" }, "uploads": { - "description": "The ID of the playlist that contains the channel\"s uploaded videos. Use\nthe videos.insert method to\nupload new videos and the videos.delete method to\ndelete previously uploaded videos.", + "description": "The ID of the playlist that contains the channel\"s uploaded videos. Use the videos.insert method to upload new videos and the videos.delete method to delete previously uploaded videos.", "type": "string" }, "watchHistory": { - "description": "The ID of the playlist that contains the channel\"s watch history. Use the\n playlistItems.insert\nand playlistItems.delete\nto add or remove items from that list.", + "description": "The ID of the playlist that contains the channel\"s watch history. Use the playlistItems.insert and playlistItems.delete to add or remove items from that list.", "type": "string" }, "watchLater": { - "description": "The ID of the playlist that contains the channel\"s watch later playlist.\nUse the playlistItems.insert\nand playlistItems.delete\nto add or remove items from that list.", + "description": "The ID of the playlist that contains the channel\"s watch later playlist. Use the playlistItems.insert and playlistItems.delete to add or remove items from that list.", "type": "string" } }, @@ -4699,7 +4853,7 @@ "type": "object" }, "ChannelContentOwnerDetails": { - "description": "The contentOwnerDetails object encapsulates channel data that\nis relevant for YouTube Partners linked with the channel.", + "description": "The contentOwnerDetails object encapsulates channel data that is relevant for YouTube Partners linked with the channel.", "id": "ChannelContentOwnerDetails", "properties": { "contentOwner": { @@ -4707,14 +4861,14 @@ "type": "string" }, "timeLinked": { - "description": "The date and time of when the channel was linked to the content owner.\nThe value is specified in ISO\n8601\nformat.", + "description": "The date and time of when the channel was linked to the content owner. The value is specified in ISO 8601 format.", "type": "string" } }, "type": "object" }, "ChannelConversionPing": { - "description": "Pings that the app shall fire (authenticated by biscotti cookie). Each ping\nhas a context, in which the app must fire the ping, and a url identifying the\nping.", + "description": "Pings that the app shall fire (authenticated by biscotti cookie). Each ping has a context, in which the app must fire the ping, and a url identifying the ping.", "id": "ChannelConversionPing", "properties": { "context": { @@ -4732,18 +4886,18 @@ "type": "string" }, "conversionUrl": { - "description": "The url (without the schema) that the player shall send the ping to.\nIt's at caller's descretion to decide which schema to use (http vs https)\nExample of a returned url: //googleads.g.doubleclick.net/pagead/\nviewthroughconversion/962985656/?data=path%3DtHe_path%3Btype%3D\ncview%3Butuid%3DGISQtTNGYqaYl4sKxoVvKA&labe=default\nThe caller must append biscotti authentication (ms param in case of\nmobile, for example) to this ping.", + "description": "The url (without the schema) that the player shall send the ping to. It's at caller's descretion to decide which schema to use (http vs https) Example of a returned url: //googleads.g.doubleclick.net/pagead/ viewthroughconversion/962985656/?data=path%3DtHe_path%3Btype%3D cview%3Butuid%3DGISQtTNGYqaYl4sKxoVvKA&labe=default The caller must append biscotti authentication (ms param in case of mobile, for example) to this ping.", "type": "string" } }, "type": "object" }, "ChannelConversionPings": { - "description": "The conversionPings object encapsulates information about\nconversion pings that need to be respected by the channel.", + "description": "The conversionPings object encapsulates information about conversion pings that need to be respected by the channel.", "id": "ChannelConversionPings", "properties": { "pings": { - "description": "Pings that the app shall fire (authenticated by biscotti cookie). Each ping\nhas a context, in which the app must fire the ping, and a url identifying\nthe ping.", + "description": "Pings that the app shall fire (authenticated by biscotti cookie). Each ping has a context, in which the app must fire the ping, and a url identifying the ping.", "items": { "$ref": "ChannelConversionPing" }, @@ -4771,11 +4925,11 @@ }, "kind": { "default": "youtube#channelListResponse", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#channelListResponse\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#channelListResponse\".", "type": "string" }, "nextPageToken": { - "description": "The token that can be used as the value of the pageToken\nparameter to retrieve the next page in the result set.", + "description": "The token that can be used as the value of the pageToken parameter to retrieve the next page in the result set.", "type": "string" }, "pageInfo": { @@ -4783,14 +4937,14 @@ "description": "General pagination information." }, "prevPageToken": { - "description": "The token that can be used as the value of the pageToken\nparameter to retrieve the previous page in the result set.", + "description": "The token that can be used as the value of the pageToken parameter to retrieve the previous page in the result set.", "type": "string" }, "tokenPagination": { "$ref": "TokenPagination" }, "visitorId": { - "description": "The visitorId identifies the visitor.", + "description": "The visitorId identifies the visitor.", "type": "string" } }, @@ -4838,7 +4992,7 @@ "properties": { "contentDetails": { "$ref": "ChannelSectionContentDetails", - "description": "The contentDetails object contains details about the channel\nsection content, such as a list of playlists or channels featured in the\nsection." + "description": "The contentDetails object contains details about the channel section content, such as a list of playlists or channels featured in the section." }, "etag": { "description": "Etag of this resource.", @@ -4850,7 +5004,7 @@ }, "kind": { "default": "youtube#channelSection", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#channelSection\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#channelSection\".", "type": "string" }, "localizations": { @@ -4862,11 +5016,11 @@ }, "snippet": { "$ref": "ChannelSectionSnippet", - "description": "The snippet object contains basic details about the channel\nsection, such as its type, style and title." + "description": "The snippet object contains basic details about the channel section, such as its type, style and title." }, "targeting": { "$ref": "ChannelSectionTargeting", - "description": "The targeting object contains basic targeting settings about\nthe channel section." + "description": "The targeting object contains basic targeting settings about the channel section." } }, "type": "object" @@ -4883,7 +5037,7 @@ "type": "array" }, "playlists": { - "description": "The playlist ids for type single_playlist and multiple_playlists. For\nsinglePlaylist, only one playlistId is allowed.", + "description": "The playlist ids for type single_playlist and multiple_playlists. For singlePlaylist, only one playlistId is allowed.", "items": { "type": "string" }, @@ -4912,11 +5066,11 @@ }, "kind": { "default": "youtube#channelSectionListResponse", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#channelSectionListResponse\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#channelSectionListResponse\".", "type": "string" }, "visitorId": { - "description": "The visitorId identifies the visitor.", + "description": "The visitorId identifies the visitor.", "type": "string" } }, @@ -4938,7 +5092,7 @@ "id": "ChannelSectionSnippet", "properties": { "channelId": { - "description": "The ID that YouTube uses to uniquely identify the channel that published\nthe channel section.", + "description": "The ID that YouTube uses to uniquely identify the channel that published the channel section.", "type": "string" }, "defaultLanguage": { @@ -5080,7 +5234,7 @@ "type": "string" }, "moderateComments": { - "description": "Whether user-submitted comments left on the channel page need to be\napproved by the channel owner to be publicly visible.", + "description": "Whether user-submitted comments left on the channel page need to be approved by the channel owner to be publicly visible.", "type": "boolean" }, "profileColor": { @@ -5100,7 +5254,7 @@ "type": "string" }, "trackingAnalyticsAccountId": { - "description": "The ID for a Google Analytics account to track and measure traffic to the\nchannels.", + "description": "The ID for a Google Analytics account to track and measure traffic to the channels.", "type": "string" }, "unsubscribedTrailer": { @@ -5135,12 +5289,12 @@ "description": "Localized title and description, read-only." }, "publishedAt": { - "description": "The date and time that the channel was created. The value is specified in\n< a href=\"//www.w3.org/TR/NOTE-datetime\">ISO 8601\nformat.", + "description": "The date and time that the channel was created. The value is specified in < a href=\"//www.w3.org/TR/NOTE-datetime\">ISO 8601 format.", "type": "string" }, "thumbnails": { "$ref": "ThumbnailDetails", - "description": "A map of thumbnail images associated with the channel. For each object in\nthe map, the key is the name of the thumbnail image, and the value is an\nobject that contains other information about the thumbnail.

When\ndisplaying thumbnails in your application, make sure that your code uses\nthe image URLs exactly as they are returned in API responses. For example,\nyour application should not use the http domain instead of the\nhttps domain in a URL returned in an API response.

\nBeginning in July 2018, channel thumbnail URLs will only be available in\nthe https domain, which is how the URLs appear in API\nresponses. After that time, you might see broken images in your application\nif it tries to load YouTube images from the http domain." + "description": "A map of thumbnail images associated with the channel. For each object in the map, the key is the name of the thumbnail image, and the value is an object that contains other information about the thumbnail. When displaying thumbnails in your application, make sure that your code uses the image URLs exactly as they are returned in API responses. For example, your application should not use the http domain instead of the https domain in a URL returned in an API response. Beginning in July 2018, channel thumbnail URLs will only be available in the https domain, which is how the URLs appear in API responses. After that time, you might see broken images in your application if it tries to load YouTube images from the http domain." }, "title": { "description": "The channel's title.", @@ -5150,7 +5304,7 @@ "type": "object" }, "ChannelStatistics": { - "description": "Statistics about a channel: number of subscribers, number of videos in the\nchannel, etc.", + "description": "Statistics about a channel: number of subscribers, number of videos in the channel, etc.", "id": "ChannelStatistics", "properties": { "commentCount": { @@ -5185,11 +5339,11 @@ "id": "ChannelStatus", "properties": { "isLinked": { - "description": "If true, then the user is linked to either a YouTube username or G+\naccount. Otherwise, the user doesn't have a public YouTube identity.", + "description": "If true, then the user is linked to either a YouTube username or G+ account. Otherwise, the user doesn't have a public YouTube identity.", "type": "boolean" }, "longUploadsStatus": { - "description": "The long uploads status of this channel. See\nhttps://support.google.com/youtube/answer/71673 for more information.", + "description": "The long uploads status of this channel. See https://support.google.com/youtube/answer/71673 for more information.", "enum": [ "longUploadsUnspecified", "allowed", @@ -5228,7 +5382,7 @@ "type": "object" }, "ChannelToStoreLinkDetails": { - "description": "Information specific to a store on a merchandising platform linked to a\nYouTube channel.", + "description": "Information specific to a store on a merchandising platform linked to a YouTube channel.", "id": "ChannelToStoreLinkDetails", "properties": { "storeName": { @@ -5254,7 +5408,7 @@ "type": "array" }, "topicIds": { - "description": "A list of Freebase topic IDs associated with the channel. You can retrieve\ninformation about each topic using the Freebase Topic API.", + "description": "A list of Freebase topic IDs associated with the channel. You can retrieve information about each topic using the Freebase Topic API.", "items": { "type": "string" }, @@ -5264,7 +5418,7 @@ "type": "object" }, "Comment": { - "description": "A comment represents a single YouTube comment.", + "description": "A *comment* represents a single YouTube comment.", "id": "Comment", "properties": { "etag": { @@ -5277,12 +5431,12 @@ }, "kind": { "default": "youtube#comment", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#comment\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#comment\".", "type": "string" }, "snippet": { "$ref": "CommentSnippet", - "description": "The snippet object contains basic details about the comment." + "description": "The snippet object contains basic details about the comment." } }, "type": "object" @@ -5307,11 +5461,11 @@ }, "kind": { "default": "youtube#commentListResponse", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#commentListResponse\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#commentListResponse\".", "type": "string" }, "nextPageToken": { - "description": "The token that can be used as the value of the pageToken\nparameter to retrieve the next page in the result set.", + "description": "The token that can be used as the value of the pageToken parameter to retrieve the next page in the result set.", "type": "string" }, "pageInfo": { @@ -5322,7 +5476,7 @@ "$ref": "TokenPagination" }, "visitorId": { - "description": "The visitorId identifies the visitor.", + "description": "The visitorId identifies the visitor.", "type": "string" } }, @@ -5352,7 +5506,7 @@ "type": "boolean" }, "channelId": { - "description": "The id of the corresponding YouTube channel. In case of a channel comment\nthis is the channel the comment refers to. In case of a video comment\nit's the video's channel.", + "description": "The id of the corresponding YouTube channel. In case of a channel comment this is the channel the comment refers to. In case of a video comment it's the video's channel.", "type": "string" }, "likeCount": { @@ -5361,7 +5515,7 @@ "type": "integer" }, "moderationStatus": { - "description": "The comment's moderation status. Will not be set if the comments were\nrequested through the id filter.", + "description": "The comment's moderation status. Will not be set if the comments were requested through the id filter.", "enum": [ "published", "heldForReview", @@ -5381,19 +5535,19 @@ "type": "string" }, "publishedAt": { - "description": "The date and time when the comment was orignally published. The value is\nspecified in ISO 8601\nformat.", + "description": "The date and time when the comment was orignally published. The value is specified in ISO 8601 format.", "type": "string" }, "textDisplay": { - "description": "The comment's text. The format is either plain text or HTML dependent on\nwhat has been requested. Even the plain text representation may differ\nfrom the text originally posted in that it may replace video links with\nvideo titles etc.", + "description": "The comment's text. The format is either plain text or HTML dependent on what has been requested. Even the plain text representation may differ from the text originally posted in that it may replace video links with video titles etc.", "type": "string" }, "textOriginal": { - "description": "The comment's original raw text as initially posted or last updated. The\noriginal text will only be returned if it is accessible to the viewer,\nwhich is only guaranteed if the viewer is the comment's author.", + "description": "The comment's original raw text as initially posted or last updated. The original text will only be returned if it is accessible to the viewer, which is only guaranteed if the viewer is the comment's author.", "type": "string" }, "updatedAt": { - "description": "The date and time when was last updated . The value is\nspecified in ISO 8601\nformat.", + "description": "The date and time when was last updated . The value is specified in ISO 8601 format.", "type": "string" }, "videoId": { @@ -5401,7 +5555,7 @@ "type": "string" }, "viewerRating": { - "description": "The rating the viewer has given to this comment. For the time being this\nwill never return RATE_TYPE_DISLIKE and instead return RATE_TYPE_NONE.\nThis may change in the future.", + "description": "The rating the viewer has given to this comment. For the time being this will never return RATE_TYPE_DISLIKE and instead return RATE_TYPE_NONE. This may change in the future.", "enum": [ "none", "like", @@ -5428,7 +5582,7 @@ "type": "object" }, "CommentThread": { - "description": "A comment thread represents information that\napplies to a top level comment and all its replies. It can also include the\ntop level comment itself and some of the replies.", + "description": "A *comment thread* represents information that applies to a top level comment and all its replies. It can also include the top level comment itself and some of the replies.", "id": "CommentThread", "properties": { "etag": { @@ -5441,16 +5595,16 @@ }, "kind": { "default": "youtube#commentThread", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#commentThread\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#commentThread\".", "type": "string" }, "replies": { "$ref": "CommentThreadReplies", - "description": "The replies object contains a limited number of replies (if\nany) to the top level comment found in the snippet." + "description": "The replies object contains a limited number of replies (if any) to the top level comment found in the snippet." }, "snippet": { "$ref": "CommentThreadSnippet", - "description": "The snippet object contains basic details about the comment\nthread and also the top level comment." + "description": "The snippet object contains basic details about the comment thread and also the top level comment." } }, "type": "object" @@ -5475,11 +5629,11 @@ }, "kind": { "default": "youtube#commentThreadListResponse", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#commentThreadListResponse\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#commentThreadListResponse\".", "type": "string" }, "nextPageToken": { - "description": "The token that can be used as the value of the pageToken\nparameter to retrieve the next page in the result set.", + "description": "The token that can be used as the value of the pageToken parameter to retrieve the next page in the result set.", "type": "string" }, "pageInfo": { @@ -5490,7 +5644,7 @@ "$ref": "TokenPagination" }, "visitorId": { - "description": "The visitorId identifies the visitor.", + "description": "The visitorId identifies the visitor.", "type": "string" } }, @@ -5501,7 +5655,7 @@ "id": "CommentThreadReplies", "properties": { "comments": { - "description": "A limited number of replies. Unless the number of replies returned equals\ntotal_reply_count in the snippet the returned replies are only a subset\nof the total number of replies.", + "description": "A limited number of replies. Unless the number of replies returned equals total_reply_count in the snippet the returned replies are only a subset of the total number of replies.", "items": { "$ref": "Comment" }, @@ -5515,15 +5669,15 @@ "id": "CommentThreadSnippet", "properties": { "canReply": { - "description": "Whether the current viewer of the thread can reply to it. This is viewer\nspecific - other viewers may see a different value for this field.", + "description": "Whether the current viewer of the thread can reply to it. This is viewer specific - other viewers may see a different value for this field.", "type": "boolean" }, "channelId": { - "description": "The YouTube channel the comments in the thread refer to or the channel\nwith the video the comments refer to. If video_id isn't set the comments\nrefer to the channel itself.", + "description": "The YouTube channel the comments in the thread refer to or the channel with the video the comments refer to. If video_id isn't set the comments refer to the channel itself.", "type": "string" }, "isPublic": { - "description": "Whether the thread (and therefore all its comments) is visible to all\nYouTube users.", + "description": "Whether the thread (and therefore all its comments) is visible to all YouTube users.", "type": "boolean" }, "topLevelComment": { @@ -5536,18 +5690,18 @@ "type": "integer" }, "videoId": { - "description": "The ID of the video the comments refer to, if any. No video_id implies a\nchannel discussion comment.", + "description": "The ID of the video the comments refer to, if any. No video_id implies a channel discussion comment.", "type": "string" } }, "type": "object" }, "ContentRating": { - "description": "Ratings schemes. The country-specific ratings are mostly for\nmovies and shows.\nLINT.IfChange", + "description": "Ratings schemes. The country-specific ratings are mostly for movies and shows. LINT.IfChange", "id": "ContentRating", "properties": { "acbRating": { - "description": "The video's Australian Classification Board (ACB) or Australian\nCommunications and Media Authority (ACMA) rating. ACMA ratings are used\nto classify children's television programming.", + "description": "The video's Australian Classification Board (ACB) or Australian Communications and Media Authority (ACMA) rating. ACMA ratings are used to classify children's television programming.", "enum": [ "acbUnspecified", "acbE", @@ -5563,8 +5717,8 @@ "enumDescriptions": [ "", "E", - "Programs that have been given a P classification by the\nAustralian Communications and Media Authority. These programs are\nintended for preschool children.", - "Programs that have been given a C classification by the\nAustralian Communications and Media Authority. These programs are\nintended for children (other than preschool children) who are younger\nthan 14 years of age.", + "Programs that have been given a P classification by the Australian Communications and Media Authority. These programs are intended for preschool children.", + "Programs that have been given a C classification by the Australian Communications and Media Authority. These programs are intended for children (other than preschool children) who are younger than 14 years of age.", "G", "PG", "M", @@ -5575,7 +5729,7 @@ "type": "string" }, "agcomRating": { - "description": "The video's rating from Italy's Autorità per le Garanzie nelle\nComunicazioni (AGCOM).", + "description": "The video's rating from Italy's Autorità per le Garanzie nelle Comunicazioni (AGCOM).", "enum": [ "agcomUnspecified", "agcomT", @@ -5593,7 +5747,7 @@ "type": "string" }, "anatelRating": { - "description": "The video's Anatel (Asociación Nacional de Televisión)\nrating for Chilean television.", + "description": "The video's Anatel (Asociación Nacional de Televisión) rating for Chilean television.", "enum": [ "anatelUnspecified", "anatelF", @@ -5671,7 +5825,7 @@ "type": "string" }, "bmukkRating": { - "description": "The video's rating from the Austrian Board of Media Classification\n(Bundesministerium für Unterricht, Kunst und Kultur).", + "description": "The video's rating from the Austrian Board of Media Classification (Bundesministerium für Unterricht, Kunst und Kultur).", "enum": [ "bmukkUnspecified", "bmukkAa", @@ -5697,7 +5851,7 @@ "type": "string" }, "catvRating": { - "description": "Rating system for Canadian TV - Canadian TV Classification System\nThe video's rating from the Canadian Radio-Television and\nTelecommunications Commission (CRTC) for Canadian English-language\nbroadcasts. For more information, see the\nCanadian\nBroadcast Standards Council website.", + "description": "Rating system for Canadian TV - Canadian TV Classification System The video's rating from the Canadian Radio-Television and Telecommunications Commission (CRTC) for Canadian English-language broadcasts. For more information, see the Canadian Broadcast Standards Council website.", "enum": [ "catvUnspecified", "catvC", @@ -5723,7 +5877,7 @@ "type": "string" }, "catvfrRating": { - "description": "The video's rating from the Canadian Radio-Television and\nTelecommunications Commission (CRTC) for Canadian French-language\nbroadcasts. For more information, see the\nCanadian\nBroadcast Standards Council website.", + "description": "The video's rating from the Canadian Radio-Television and Telecommunications Commission (CRTC) for Canadian French-language broadcasts. For more information, see the Canadian Broadcast Standards Council website.", "enum": [ "catvfrUnspecified", "catvfrG", @@ -5767,7 +5921,7 @@ "type": "string" }, "cccRating": { - "description": "The video's Consejo de Calificación Cinematográfica (Chile)\nrating.", + "description": "The video's Consejo de Calificación Cinematográfica (Chile) rating.", "enum": [ "cccUnspecified", "cccTe", @@ -5791,7 +5945,7 @@ "type": "string" }, "cceRating": { - "description": "The video's rating from Portugal's Comissão de\nClassificação de Espect´culos.", + "description": "The video's rating from Portugal's Comissão de Classificação de Espect´culos.", "enum": [ "cceUnspecified", "cceM4", @@ -5861,7 +6015,7 @@ "type": "string" }, "cicfRating": { - "description": "The video's rating from the Commission de Contrôle des Films\n(Belgium).", + "description": "The video's rating from the Commission de Contrôle des Films (Belgium).", "enum": [ "cicfUnspecified", "cicfE", @@ -5879,7 +6033,7 @@ "type": "string" }, "cnaRating": { - "description": "The video's rating from Romania's CONSILIUL NATIONAL AL AUDIOVIZUALULUI\n(CNA).", + "description": "The video's rating from Romania's CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA).", "enum": [ "cnaUnspecified", "cnaAp", @@ -5927,7 +6081,7 @@ "type": "string" }, "csaRating": { - "description": "The video's rating from France's Conseil supérieur de\nl’audiovisuel, which rates broadcast content.", + "description": "The video's rating from France's Conseil supérieur de l’audiovisuel, which rates broadcast content.", "enum": [ "csaUnspecified", "csaT", @@ -5951,7 +6105,7 @@ "type": "string" }, "cscfRating": { - "description": "The video's rating from Luxembourg's Commission de surveillance\nde la classification des films (CSCF).", + "description": "The video's rating from Luxembourg's Commission de surveillance de la classification des films (CSCF).", "enum": [ "cscfUnspecified", "cscfAl", @@ -5997,7 +6151,7 @@ "type": "string" }, "djctqRating": { - "description": "The video's Departamento de Justiça, Classificação,\nQualificação e Títulos (DJCQT - Brazil) rating.", + "description": "The video's Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - Brazil) rating.", "enum": [ "djctqUnspecified", "djctqL", @@ -6056,7 +6210,7 @@ "description": "Reasons that explain why the video received its DJCQT (Brazil) rating.", "enumDescriptions": [ "", - "Brazil rating content descriptors. See http://go/brazilratings section F.\nViolência (Violence)", + "Brazil rating content descriptors. See http://go/brazilratings section F. Violência (Violence)", "Violência extrema (Extreme violence)", "Conteúdo sexual (Sexual content)", "Nudez (Nudity)", @@ -6085,12 +6239,27 @@ "djctqCriminalActs", "djctqImpactingContent" ], + "enumDescriptions": [ + "", + "Brazil rating content descriptors. See http://go/brazilratings section F. Violência (Violence)", + "Violência extrema (Extreme violence)", + "Conteúdo sexual (Sexual content)", + "Nudez (Nudity)", + "Sexo (Sex)", + "Sexo Explícito (Explicit sex)", + "Drogas (Drugs)", + "Drogas Lícitas (Legal drugs)", + "Drogas Ilícitas (Illegal drugs)", + "Linguagem Imprópria (Inappropriate language)", + "Atos Criminosos (Criminal Acts)", + "Conteúdo Impactante (Impacting content)" + ], "type": "string" }, "type": "array" }, "ecbmctRating": { - "description": "Rating system in Turkey - Evaluation and Classification Board of the\nMinistry of Culture and Tourism", + "description": "Rating system in Turkey - Evaluation and Classification Board of the Ministry of Culture and Tourism", "enum": [ "ecbmctUnspecified", "ecbmctG", @@ -6164,7 +6333,7 @@ "type": "string" }, "eirinRating": { - "description": "The video's Eirin (映倫) rating.\nEirin is the Japanese rating system.", + "description": "The video's Eirin (映倫) rating. Eirin is the Japanese rating system.", "enum": [ "eirinUnspecified", "eirinG", @@ -6212,7 +6381,7 @@ "type": "string" }, "fcoRating": { - "description": "The video's rating from Hong Kong's Office for Film, Newspaper\nand Article Administration.", + "description": "The video's rating from Hong Kong's Office for Film, Newspaper and Article Administration.", "enum": [ "fcoUnspecified", "fcoI", @@ -6234,7 +6403,7 @@ "type": "string" }, "fmocRating": { - "description": "This property has been deprecated. Use the\ncontentDetails.contentRating.cncRating\ninstead.", + "description": "This property has been deprecated. Use the contentDetails.contentRating.cncRating instead.", "enum": [ "fmocUnspecified", "fmocU", @@ -6320,12 +6489,26 @@ "fpbCriminalTechniques", "fpbImitativeActsTechniques" ], + "enumDescriptions": [ + "", + "South Africa rating content descriptors.", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "" + ], "type": "string" }, "type": "array" }, "fskRating": { - "description": "The video's Freiwillige Selbstkontrolle der Filmwirtschaft\n(FSK - Germany) rating.", + "description": "The video's Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - Germany) rating.", "enum": [ "fskUnspecified", "fsk0", @@ -6373,7 +6556,7 @@ "type": "string" }, "icaaRating": { - "description": "The video's Instituto de la Cinematografía y de las Artes\nAudiovisuales (ICAA - Spain) rating.", + "description": "The video's Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA - Spain) rating.", "enum": [ "icaaUnspecified", "icaaApta", @@ -6399,7 +6582,7 @@ "type": "string" }, "ifcoRating": { - "description": "The video's Irish Film Classification Office (IFCO - Ireland) rating.\nSee the IFCO\nwebsite for more information.", + "description": "The video's Irish Film Classification Office (IFCO - Ireland) rating. See the IFCO website for more information.", "enum": [ "ifcoUnspecified", "ifcoG", @@ -6449,7 +6632,7 @@ "type": "string" }, "incaaRating": { - "description": "The video's INCAA (Instituto Nacional de Cine y Artes Audiovisuales -\nArgentina) rating.", + "description": "The video's INCAA (Instituto Nacional de Cine y Artes Audiovisuales - Argentina) rating.", "enum": [ "incaaUnspecified", "incaaAtp", @@ -6491,7 +6674,7 @@ "type": "string" }, "kijkwijzerRating": { - "description": "The video's NICAM/Kijkwijzer rating from the Nederlands Instituut\nvoor de Classificatie van Audiovisuele Media (Netherlands).", + "description": "The video's NICAM/Kijkwijzer rating from the Nederlands Instituut voor de Classificatie van Audiovisuele Media (Netherlands).", "enum": [ "kijkwijzerUnspecified", "kijkwijzerAl", @@ -6515,7 +6698,7 @@ "type": "string" }, "kmrbRating": { - "description": "The video's Korea Media Rating Board\n(영상물등급위원회) rating.\nThe KMRB rates videos in South Korea.", + "description": "The video's Korea Media Rating Board (영상물등급위원회) rating. The KMRB rates videos in South Korea.", "enum": [ "kmrbUnspecified", "kmrbAll", @@ -6527,11 +6710,11 @@ ], "enumDescriptions": [ "", - "전체관람가", - "12세 이상 관람가", - "15세 이상 관람가", + "전체관람가", + "12세 이상 관람가", + "15세 이상 관람가", "", - "청소년 관람불가", + "청소년 관람불가", "" ], "type": "string" @@ -6584,16 +6767,16 @@ "PG", "12A", "12", - "14 - this rating was removed from the new classification structure\nintroduced in 2013.", + "14 - this rating was removed from the new classification structure introduced in 2013.", "15", - "16 - this rating was removed from the new classification structure\nintroduced in 2013.", + "16 - this rating was removed from the new classification structure introduced in 2013.", "18", "" ], "type": "string" }, "mccypRating": { - "description": "The video's rating from the Danish Film Institute's (Det Danske\nFilminstitut) Media Council for Children and Young People.", + "description": "The video's rating from the Danish Film Institute's (Det Danske Filminstitut) Media Council for Children and Young People.", "enum": [ "mccypUnspecified", "mccypA", @@ -6639,7 +6822,7 @@ "type": "string" }, "mdaRating": { - "description": "The video's rating from Singapore's Media Development Authority (MDA) and,\nspecifically, it's Board of Film Censors (BFC).", + "description": "The video's rating from Singapore's Media Development Authority (MDA) and, specifically, it's Board of Film Censors (BFC).", "enum": [ "mdaUnspecified", "mdaG", @@ -6691,7 +6874,7 @@ "type": "string" }, "mekuRating": { - "description": "The video's rating from Finland's Kansallinen Audiovisuaalinen Instituutti\n(National Audiovisual Institute).", + "description": "The video's rating from Finland's Kansallinen Audiovisuaalinen Instituutti (National Audiovisual Institute).", "enum": [ "mekuUnspecified", "mekuS", @@ -6713,7 +6896,7 @@ "type": "string" }, "menaMpaaRating": { - "description": "The rating system for MENA countries, a clone of MPAA. It is needed to\nprevent titles go live w/o additional QC check, since some of them can be\ninappropriate for the countries at all. See b/33408548 for more details.", + "description": "The rating system for MENA countries, a clone of MPAA. It is needed to prevent titles go live w/o additional QC check, since some of them can be inappropriate for the countries at all. See b/33408548 for more details.", "enum": [ "menaMpaaUnspecified", "menaMpaaG", @@ -6733,7 +6916,7 @@ "type": "string" }, "mibacRating": { - "description": "The video's rating from the Ministero dei Beni e delle Attività\nCulturali e del Turismo (Italy).", + "description": "The video's rating from the Ministero dei Beni e delle Attività Culturali e del Turismo (Italy).", "enum": [ "mibacUnspecified", "mibacT", @@ -6783,7 +6966,7 @@ "type": "string" }, "moctwRating": { - "description": "The video's rating from Taiwan's Ministry of Culture\n(文化部).", + "description": "The video's rating from Taiwan's Ministry of Culture (文化部).", "enum": [ "moctwUnspecified", "moctwG", @@ -6831,7 +7014,7 @@ "type": "string" }, "mpaatRating": { - "description": "The rating system for trailer, DVD, and Ad in the US. See\nhttp://movielabs.com/md/ratings/v2.3/html/US_MPAAT_Ratings.html.", + "description": "The rating system for trailer, DVD, and Ad in the US. See http://movielabs.com/md/ratings/v2.3/html/US_MPAAT_Ratings.html.", "enum": [ "mpaatUnspecified", "mpaatGb", @@ -6845,7 +7028,7 @@ "type": "string" }, "mtrcbRating": { - "description": "The video's rating from the Movie and Television Review and\nClassification Board (Philippines).", + "description": "The video's rating from the Movie and Television Review and Classification Board (Philippines).", "enum": [ "mtrcbUnspecified", "mtrcbG", @@ -6917,7 +7100,7 @@ "type": "string" }, "nfrcRating": { - "description": "The video's rating from the Bulgarian\nNational Film Center.", + "description": "The video's rating from the Bulgarian National Film Center.", "enum": [ "nfrcUnspecified", "nfrcA", @@ -6965,7 +7148,7 @@ "type": "string" }, "nkclvRating": { - "description": "The video's rating from the Nacionãlais Kino centrs (National Film\nCentre of Latvia).", + "description": "The video's rating from the Nacionãlais Kino centrs (National Film Centre of Latvia).", "enum": [ "nkclvUnspecified", "nkclvU", @@ -7013,7 +7196,7 @@ "type": "string" }, "oflcRating": { - "description": "The video's Office of Film and Literature Classification\n(OFLC - New Zealand) rating.", + "description": "The video's Office of Film and Literature Classification (OFLC - New Zealand) rating.", "enum": [ "oflcUnspecified", "oflcG", @@ -7065,7 +7248,7 @@ "type": "string" }, "rcnofRating": { - "description": "The video's rating from the Hungarian Nemzeti Filmiroda, the Rating\nCommittee of the National Office of Film.", + "description": "The video's rating from the Hungarian Nemzeti Filmiroda, the Rating Committee of the National Office of Film.", "enum": [ "rcnofUnspecified", "rcnofI", @@ -7111,7 +7294,7 @@ "type": "string" }, "rtcRating": { - "description": "The video's General Directorate of Radio, Television and Cinematography\n(Mexico) rating.", + "description": "The video's General Directorate of Radio, Television and Cinematography (Mexico) rating.", "enum": [ "rtcUnspecified", "rtcAa", @@ -7135,7 +7318,7 @@ "type": "string" }, "rteRating": { - "description": "The video's rating from Ireland's Raidió Teilifís\nÉireann.", + "description": "The video's rating from Ireland's Raidió Teilifís Éireann.", "enum": [ "rteUnspecified", "rteGa", @@ -7155,7 +7338,7 @@ "type": "string" }, "russiaRating": { - "description": "The video's National Film Registry of the Russian Federation\n(MKRF - Russia) rating.", + "description": "The video's National Film Registry of the Russian Federation (MKRF - Russia) rating.", "enum": [ "russiaUnspecified", "russia0", @@ -7221,7 +7404,7 @@ "type": "string" }, "smsaRating": { - "description": "The video's rating from Statens medieråd (Sweden's National Media\nCouncil).", + "description": "The video's rating from Statens medieråd (Sweden's National Media Council).", "enum": [ "smsaUnspecified", "smsaA", @@ -7319,7 +7502,7 @@ "type": "object" }, "GuideCategory": { - "description": "A guideCategory resource identifies a category\nthat YouTube algorithmically assigns based on a\nchannel's content or other indicators, such as the channel's popularity. The\nlist is similar to video categories, with the\ndifference being that a video's uploader can assign a video category but only\nYouTube can assign a channel category.", + "description": "A *guideCategory* resource identifies a category that YouTube algorithmically assigns based on a channel's content or other indicators, such as the channel's popularity. The list is similar to video categories, with the difference being that a video's uploader can assign a video category but only YouTube can assign a channel category.", "id": "GuideCategory", "properties": { "etag": { @@ -7332,12 +7515,12 @@ }, "kind": { "default": "youtube#guideCategory", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#guideCategory\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#guideCategory\".", "type": "string" }, "snippet": { "$ref": "GuideCategorySnippet", - "description": "The snippet object contains basic details about the category,\nsuch as its title." + "description": "The snippet object contains basic details about the category, such as its title." } }, "type": "object" @@ -7354,7 +7537,7 @@ "type": "string" }, "items": { - "description": "A list of categories that can be associated with YouTube channels. In this\nmap, the category ID is the map key, and its value is the corresponding\nguideCategory resource.", + "description": "A list of categories that can be associated with YouTube channels. In this map, the category ID is the map key, and its value is the corresponding guideCategory resource.", "items": { "$ref": "GuideCategory" }, @@ -7362,25 +7545,25 @@ }, "kind": { "default": "youtube#guideCategoryListResponse", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#guideCategoryListResponse\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#guideCategoryListResponse\".", "type": "string" }, "nextPageToken": { - "description": "The token that can be used as the value of the pageToken\nparameter to retrieve the next page in the result set.", + "description": "The token that can be used as the value of the pageToken parameter to retrieve the next page in the result set.", "type": "string" }, "pageInfo": { "$ref": "PageInfo" }, "prevPageToken": { - "description": "The token that can be used as the value of the pageToken\nparameter to retrieve the previous page in the result set.", + "description": "The token that can be used as the value of the pageToken parameter to retrieve the previous page in the result set.", "type": "string" }, "tokenPagination": { "$ref": "TokenPagination" }, "visitorId": { - "description": "The visitorId identifies the visitor.", + "description": "The visitorId identifies the visitor.", "type": "string" } }, @@ -7401,7 +7584,7 @@ "type": "object" }, "I18nLanguage": { - "description": "An i18nLanguage resource identifies a UI\nlanguage currently supported by YouTube.", + "description": "An *i18nLanguage* resource identifies a UI language currently supported by YouTube.", "id": "I18nLanguage", "properties": { "etag": { @@ -7414,12 +7597,12 @@ }, "kind": { "default": "youtube#i18nLanguage", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#i18nLanguage\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#i18nLanguage\".", "type": "string" }, "snippet": { "$ref": "I18nLanguageSnippet", - "description": "The snippet object contains basic details about the i18n\nlanguage, such as language code and human-readable name." + "description": "The snippet object contains basic details about the i18n language, such as language code and human-readable name." } }, "type": "object" @@ -7436,7 +7619,7 @@ "type": "string" }, "items": { - "description": "A list of supported i18n languages. In this map, the i18n language ID is\nthe map key, and its value is the corresponding i18nLanguage\nresource.", + "description": "A list of supported i18n languages. In this map, the i18n language ID is the map key, and its value is the corresponding i18nLanguage resource.", "items": { "$ref": "I18nLanguage" }, @@ -7444,18 +7627,18 @@ }, "kind": { "default": "youtube#i18nLanguageListResponse", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#i18nLanguageListResponse\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#i18nLanguageListResponse\".", "type": "string" }, "visitorId": { - "description": "The visitorId identifies the visitor.", + "description": "The visitorId identifies the visitor.", "type": "string" } }, "type": "object" }, "I18nLanguageSnippet": { - "description": "Basic details about an i18n language, such as language code and\nhuman-readable name.", + "description": "Basic details about an i18n language, such as language code and human-readable name.", "id": "I18nLanguageSnippet", "properties": { "hl": { @@ -7470,7 +7653,7 @@ "type": "object" }, "I18nRegion": { - "description": "A i18nRegion resource identifies a region where\nYouTube is available.", + "description": "A *i18nRegion* resource identifies a region where YouTube is available.", "id": "I18nRegion", "properties": { "etag": { @@ -7483,12 +7666,12 @@ }, "kind": { "default": "youtube#i18nRegion", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#i18nRegion\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#i18nRegion\".", "type": "string" }, "snippet": { "$ref": "I18nRegionSnippet", - "description": "The snippet object contains basic details about the i18n\nregion, such as region code and human-readable name." + "description": "The snippet object contains basic details about the i18n region, such as region code and human-readable name." } }, "type": "object" @@ -7505,7 +7688,7 @@ "type": "string" }, "items": { - "description": "A list of regions where YouTube is available. In this map, the i18n region\nID is the map key, and its value is the corresponding\ni18nRegion resource.", + "description": "A list of regions where YouTube is available. In this map, the i18n region ID is the map key, and its value is the corresponding i18nRegion resource.", "items": { "$ref": "I18nRegion" }, @@ -7513,18 +7696,18 @@ }, "kind": { "default": "youtube#i18nRegionListResponse", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#i18nRegionListResponse\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#i18nRegionListResponse\".", "type": "string" }, "visitorId": { - "description": "The visitorId identifies the visitor.", + "description": "The visitorId identifies the visitor.", "type": "string" } }, "type": "object" }, "I18nRegionSnippet": { - "description": "Basic details about an i18n region, such as region code and human-readable\nname.", + "description": "Basic details about an i18n region, such as region code and human-readable name.", "id": "I18nRegionSnippet", "properties": { "gl": { @@ -7544,10 +7727,10 @@ "properties": { "backgroundImageUrl": { "$ref": "LocalizedProperty", - "description": "The URL for the background image shown on the video watch page. The image\nshould be 1200px by 615px, with a maximum file size of 128k." + "description": "The URL for the background image shown on the video watch page. The image should be 1200px by 615px, with a maximum file size of 128k." }, "bannerExternalUrl": { - "description": "This is used only in update requests; if it's set, we use this URL to\ngenerate all of the above banner URLs.", + "description": "This is used only in update requests; if it's set, we use this URL to generate all of the above banner URLs.", "type": "string" }, "bannerImageUrl": { @@ -7612,7 +7795,7 @@ }, "largeBrandedBannerImageUrl": { "$ref": "LocalizedProperty", - "description": "The URL for the 854px by 70px image that appears below the video player in\nthe expanded video view of the video watch page." + "description": "The URL for the 854px by 70px image that appears below the video player in the expanded video view of the video watch page." }, "smallBrandedBannerImageImapScript": { "$ref": "LocalizedProperty", @@ -7620,10 +7803,10 @@ }, "smallBrandedBannerImageUrl": { "$ref": "LocalizedProperty", - "description": "The URL for the 640px by 70px banner image that appears below the video\nplayer in the default view of the video watch page.\nThe URL for the image that appears above the top-left corner of the video\nplayer. This is a 25-pixel-high image with a flexible width that cannot\nexceed 170 pixels." + "description": "The URL for the 640px by 70px banner image that appears below the video player in the default view of the video watch page. The URL for the image that appears above the top-left corner of the video player. This is a 25-pixel-high image with a flexible width that cannot exceed 170 pixels." }, "trackingImageUrl": { - "description": "The URL for a 1px by 1px tracking pixel that can be used to collect\nstatistics for views of the channel or video pages.", + "description": "The URL for a 1px by 1px tracking pixel that can be used to collect statistics for views of the channel or video pages.", "type": "string" }, "watchIconImageUrl": { @@ -7669,7 +7852,7 @@ }, "teaser": { "$ref": "InfoCardSnippetTeaser", - "description": "Each card can have a teaser.\nRequired." + "description": "Each card can have a teaser. Required." }, "videoInfocard": { "$ref": "VideoCard" @@ -7681,12 +7864,12 @@ "id": "InfoCardSnippetTeaser", "properties": { "teaserStartOffset": { - "description": "The offset from the video start at which the teaser should be displayed\n(activated), in milliseconds.\nRequired.", + "description": "The offset from the video start at which the teaser should be displayed (activated), in milliseconds. Required.", "format": "google-duration", "type": "string" }, "teaserText": { - "description": "The teaser text to show at the top of the player for the info-card.\nRequired for channel and link type cards.\nOptional for video and playlist type cards.", + "description": "The teaser text to show at the top of the player for the info-card. Required for channel and link type cards. Optional for video and playlist type cards.", "type": "string" } }, @@ -7732,19 +7915,19 @@ "id": "IngestionInfo", "properties": { "backupIngestionAddress": { - "description": "The backup ingestion URL that you should use to stream video to\nYouTube. You have the option of simultaneously streaming the content\nthat you are sending to the ingestionAddress to this URL.", + "description": "The backup ingestion URL that you should use to stream video to YouTube. You have the option of simultaneously streaming the content that you are sending to the ingestionAddress to this URL.", "type": "string" }, "ingestionAddress": { - "description": "The primary ingestion URL that you should use to stream video to\nYouTube. You must stream video to this URL.

\nDepending on which application or tool you use to encode\nyour video stream, you may need to enter the stream URL and stream\nname separately or you may need to concatenate them in the following\nformat:
STREAM_URL/STREAM_NAME
", + "description": "The primary ingestion URL that you should use to stream video to YouTube. You must stream video to this URL. Depending on which application or tool you use to encode your video stream, you may need to enter the stream URL and stream name separately or you may need to concatenate them in the following format: *STREAM_URL/STREAM_NAME* ", "type": "string" }, "rtmpsBackupIngestionAddress": { - "description": "This ingestion url may be used instead of\nbackupIngestionAddress in order to stream via RTMPS. Not\napplicable to non-RTMP streams.", + "description": "This ingestion url may be used instead of backupIngestionAddress in order to stream via RTMPS. Not applicable to non-RTMP streams.", "type": "string" }, "rtmpsIngestionAddress": { - "description": "This ingestion url may be used instead of\ningestionAddress in order to stream via RTMPS. Not applicable\nto non-RTMP streams.", + "description": "This ingestion url may be used instead of ingestionAddress in order to stream via RTMPS. Not applicable to non-RTMP streams.", "type": "string" }, "streamName": { @@ -7755,7 +7938,7 @@ "type": "object" }, "InvideoBranding": { - "description": "LINT.IfChange\nDescribes an invideo branding.", + "description": "LINT.IfChange Describes an invideo branding.", "id": "InvideoBranding", "properties": { "imageBytes": { @@ -7769,10 +7952,10 @@ }, "position": { "$ref": "InvideoPosition", - "description": "The spatial position within the video where the branding watermark will be\ndisplayed." + "description": "The spatial position within the video where the branding watermark will be displayed." }, "targetChannelId": { - "description": "The channel to which this branding links. If not present it defaults to\nthe current channel.", + "description": "The channel to which this branding links. If not present it defaults to the current channel.", "type": "string" }, "timing": { @@ -7783,7 +7966,7 @@ "type": "object" }, "InvideoPosition": { - "description": "Describes the spatial position of a visual widget inside a video. It is a\nunion of various position types, out of which only will be set one.", + "description": "Describes the spatial position of a visual widget inside a video. It is a union of various position types, out of which only will be set one.", "id": "InvideoPosition", "properties": { "cornerPosition": { @@ -7816,12 +7999,12 @@ "type": "object" }, "InvideoPromotion": { - "description": "Describes an invideo promotion campaign consisting of multiple promoted\nitems. A campaign belongs to a single channel_id.", + "description": "Describes an invideo promotion campaign consisting of multiple promoted items. A campaign belongs to a single channel_id.", "id": "InvideoPromotion", "properties": { "defaultTiming": { "$ref": "InvideoTiming", - "description": "The default temporal position within the video where the promoted item will\nbe displayed. Can be overridden by more specific timing in the item." + "description": "The default temporal position within the video where the promoted item will be displayed. Can be overridden by more specific timing in the item." }, "items": { "description": "List of promoted items in decreasing priority.", @@ -7832,10 +8015,10 @@ }, "position": { "$ref": "InvideoPosition", - "description": "The spatial position within the video where the promoted item will be\ndisplayed." + "description": "The spatial position within the video where the promoted item will be displayed." }, "useSmartTiming": { - "description": "Indicates whether the channel's promotional campaign uses \"smart timing.\"\nThis feature attempts to show promotions at a point in the video when they\nare more likely to be clicked and less likely to disrupt the viewing\nexperience. This feature also picks up a single promotion to show on each\nvideo.", + "description": "Indicates whether the channel's promotional campaign uses \"smart timing.\" This feature attempts to show promotions at a point in the video when they are more likely to be clicked and less likely to disrupt the viewing experience. This feature also picks up a single promotion to show on each video.", "type": "boolean" } }, @@ -7846,17 +8029,17 @@ "id": "InvideoTiming", "properties": { "durationMs": { - "description": "Defines the duration in milliseconds for which the promotion should be\ndisplayed. If missing, the client should use the default.", + "description": "Defines the duration in milliseconds for which the promotion should be displayed. If missing, the client should use the default.", "format": "uint64", "type": "string" }, "offsetMs": { - "description": "Defines the time at which the promotion will appear. Depending on the value\nof type the value of the offsetMs field will\nrepresent a time offset from the start or from the end of the video,\nexpressed in milliseconds.", + "description": "Defines the time at which the promotion will appear. Depending on the value of type the value of the offsetMs field will represent a time offset from the start or from the end of the video, expressed in milliseconds.", "format": "uint64", "type": "string" }, "type": { - "description": "Describes a timing type. If the value is offsetFromStart, then\nthe offsetMs field represents an offset from the start of the\nvideo. If the value is offsetFromEnd, then the\noffsetMs field represents an offset from the end of the video.", + "description": "Describes a timing type. If the value is offsetFromStart, then the offsetMs field represents an offset from the start of the video. If the value is offsetFromEnd, then the offsetMs field represents an offset from the end of the video.", "enum": [ "offsetFromStart", "offsetFromEnd" @@ -7893,7 +8076,7 @@ "id": "LinkCard", "properties": { "customLinkText": { - "description": "Custom text to show as the website link.\nRequired.", + "description": "Custom text to show as the website link. Required.", "type": "string" }, "externalImageUrl": { @@ -7901,11 +8084,11 @@ "type": "string" }, "targetUrl": { - "description": "The URL to which this card points.\nRequired.", + "description": "The URL to which this card points. Required.", "type": "string" }, "title": { - "description": "The title to show on the card.\nRequired.", + "description": "The title to show on the card. Required.", "type": "string" }, "uploadedImage": { @@ -7931,12 +8114,12 @@ "type": "object" }, "LiveBroadcast": { - "description": "A liveBroadcast resource represents an event\nthat will be streamed, via live video, on YouTube.", + "description": "A *liveBroadcast* resource represents an event that will be streamed, via live video, on YouTube.", "id": "LiveBroadcast", "properties": { "contentDetails": { "$ref": "LiveBroadcastContentDetails", - "description": "The contentDetails object contains information about the\nevent's video content, such as whether the content can be shown in an\nembedded video player or if it will be archived and therefore available\nfor viewing after the event has concluded." + "description": "The contentDetails object contains information about the event's video content, such as whether the content can be shown in an embedded video player or if it will be archived and therefore available for viewing after the event has concluded." }, "etag": { "description": "Etag of this resource.", @@ -7948,20 +8131,20 @@ }, "kind": { "default": "youtube#liveBroadcast", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#liveBroadcast\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#liveBroadcast\".", "type": "string" }, "snippet": { "$ref": "LiveBroadcastSnippet", - "description": "The snippet object contains basic details about the event,\nincluding its title, description, start time, and end time." + "description": "The snippet object contains basic details about the event, including its title, description, start time, and end time." }, "statistics": { "$ref": "LiveBroadcastStatistics", - "description": "The statistics object contains info about the event's current\nstats. These include concurrent viewers and total chat count. Statistics\ncan change (in either direction) during the lifetime of an event.\nStatistics are only returned while the event is live." + "description": "The statistics object contains info about the event's current stats. These include concurrent viewers and total chat count. Statistics can change (in either direction) during the lifetime of an event. Statistics are only returned while the event is live." }, "status": { "$ref": "LiveBroadcastStatus", - "description": "The status object contains information about the event's\nstatus." + "description": "The status object contains information about the event's status." } }, "type": "object" @@ -7971,11 +8154,11 @@ "id": "LiveBroadcastContentDetails", "properties": { "boundStreamId": { - "description": "This value uniquely identifies the\nlive stream\nbound to the broadcast.", + "description": "This value uniquely identifies the live stream bound to the broadcast.", "type": "string" }, "boundStreamLastUpdateTimeMs": { - "description": "The date and time that the live stream referenced by\nboundStreamId was last updated.", + "description": "The date and time that the live stream referenced by boundStreamId was last updated.", "type": "string" }, "closedCaptionsType": { @@ -7994,15 +8177,15 @@ "type": "string" }, "enableAutoStart": { - "description": "This setting indicates whether auto start is enabled for this broadcast.\n The default value for this property is false.

\n This setting can only be used by Events.", + "description": "This setting indicates whether auto start is enabled for this broadcast. The default value for this property is false. This setting can only be used by Events.", "type": "boolean" }, "enableAutoStop": { - "description": "This setting indicates whether auto stop is enabled for this broadcast.\nThe default value for this property is false.

\nThis setting can only be used by Events.", + "description": "This setting indicates whether auto stop is enabled for this broadcast. The default value for this property is false. This setting can only be used by Events.", "type": "boolean" }, "enableClosedCaptions": { - "description": "This setting indicates whether HTTP POST closed captioning is enabled for\nthis broadcast. The ingestion URL of the closed captions is returned\nthrough the liveStreams API. This is mutually exclusive with using the\nclosed_captions_type property, and is equivalent to setting\nclosed_captions_type to CLOSED_CAPTIONS_HTTP_POST.", + "description": "This setting indicates whether HTTP POST closed captioning is enabled for this broadcast. The ingestion URL of the closed captions is returned through the liveStreams API. This is mutually exclusive with using the closed_captions_type property, and is equivalent to setting closed_captions_type to CLOSED_CAPTIONS_HTTP_POST.", "type": "boolean" }, "enableContentEncryption": { @@ -8011,7 +8194,7 @@ "youtube.liveBroadcasts.update" ] }, - "description": "This setting indicates whether YouTube should enable content encryption\nfor the broadcast.", + "description": "This setting indicates whether YouTube should enable content encryption for the broadcast.", "type": "boolean" }, "enableDvr": { @@ -8020,7 +8203,7 @@ "youtube.liveBroadcasts.update" ] }, - "description": "This setting determines whether viewers can access DVR controls while\nwatching the video. DVR controls enable the viewer to control the video\nplayback experience by pausing, rewinding, or fast forwarding content.\nThe default value for this property is true.

\n\nImportant: You must set the value to true\nand also set the enableArchive property's value to\ntrue if you want to make playback available immediately\nafter the broadcast ends.", + "description": "This setting determines whether viewers can access DVR controls while watching the video. DVR controls enable the viewer to control the video playback experience by pausing, rewinding, or fast forwarding content. The default value for this property is true. *Important:* You must set the value to true and also set the enableArchive property's value to true if you want to make playback available immediately after the broadcast ends.", "type": "boolean" }, "enableEmbed": { @@ -8029,7 +8212,7 @@ "youtube.liveBroadcasts.update" ] }, - "description": "This setting indicates whether the broadcast video can be played in an\nembedded player. If you choose to archive the video (using the\nenableArchive property), this setting will also apply to\nthe archived video.", + "description": "This setting indicates whether the broadcast video can be played in an embedded player. If you choose to archive the video (using the enableArchive property), this setting will also apply to the archived video.", "type": "boolean" }, "enableLowLatency": { @@ -8037,7 +8220,7 @@ "type": "boolean" }, "latencyPreference": { - "description": "If both this and enable_low_latency are set, they must match.\nLATENCY_NORMAL should match enable_low_latency=false\nLATENCY_LOW should match enable_low_latency=true\nLATENCY_ULTRA_LOW should have enable_low_latency omitted.", + "description": "If both this and enable_low_latency are set, they must match. LATENCY_NORMAL should match enable_low_latency=false LATENCY_LOW should match enable_low_latency=true LATENCY_ULTRA_LOW should have enable_low_latency omitted.", "enum": [ "latencyPreferenceUnspecified", "normal", @@ -8048,21 +8231,21 @@ "", "Best for: highest quality viewer playbacks and higher resolutions.", "Best for: near real-time interaction, with minimal playback buffering.", - "Best for: real-time interaction\nDoes not support: Closed captions, 1440p, and 4k resolutions" + "Best for: real-time interaction Does not support: Closed captions, 1440p, and 4k resolutions" ], "type": "string" }, "mesh": { - "description": "The mesh for projecting the video if projection is\nmesh. The mesh value must be a UTF-8 string containing the\nbase-64 encoding of 3D mesh data that follows the \nSpherical Video V2 RFC specification for an mshp box, excluding the box\nsize and type but including the following four reserved zero bytes for the\nversion and flags.", + "description": "The mesh for projecting the video if projection is mesh. The mesh value must be a UTF-8 string containing the base-64 encoding of 3D mesh data that follows the Spherical Video V2 RFC specification for an mshp box, excluding the box size and type but including the following four reserved zero bytes for the version and flags.", "format": "byte", "type": "string" }, "monitorStream": { "$ref": "MonitorStreamInfo", - "description": "The monitorStream object contains information about the\nmonitor stream, which the broadcaster can use to review the event\ncontent before the broadcast stream is shown publicly." + "description": "The monitorStream object contains information about the monitor stream, which the broadcaster can use to review the event content before the broadcast stream is shown publicly." }, "projection": { - "description": "The projection format of this broadcast. This defaults to\nrectangular.", + "description": "The projection format of this broadcast. This defaults to rectangular.", "enum": [ "projectionUnspecified", "rectangular", @@ -8083,7 +8266,7 @@ "youtube.liveBroadcasts.update" ] }, - "description": "Automatically start recording after the event goes live.\nThe default value for this property is true.

\n\nImportant: You must also set the enableDvr\nproperty's value to\ntrue if you want the playback to be available immediately\nafter the broadcast ends. If you set this property's value to\ntrue but do not also set the enableDvr property\nto true, there may be a delay of around one day before the\narchived video will be available for playback.", + "description": "Automatically start recording after the event goes live. The default value for this property is true. *Important:* You must also set the enableDvr property's value to true if you want the playback to be available immediately after the broadcast ends. If you set this property's value to true but do not also set the enableDvr property to true, there may be a delay of around one day before the archived video will be available for playback.", "type": "boolean" }, "startWithSlate": { @@ -8092,7 +8275,7 @@ "youtube.liveBroadcasts.update" ] }, - "description": "This setting indicates whether the broadcast should automatically begin\nwith an in-stream\nslate when you update the broadcast's status to live.\nAfter updating the status, you then need to send a\nliveCuepoints.insert\nrequest that sets the cuepoint's eventState to\nend to remove the in-stream slate and make your broadcast\nstream visible to viewers.", + "description": "This setting indicates whether the broadcast should automatically begin with an in-stream slate when you update the broadcast's status to live. After updating the status, you then need to send a liveCuepoints.insert request that sets the cuepoint's eventState to end to remove the in-stream slate and make your broadcast stream visible to viewers.", "type": "boolean" } }, @@ -8118,11 +8301,11 @@ }, "kind": { "default": "youtube#liveBroadcastListResponse", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#liveBroadcastListResponse\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#liveBroadcastListResponse\".", "type": "string" }, "nextPageToken": { - "description": "The token that can be used as the value of the pageToken\nparameter to retrieve the next page in the result set.", + "description": "The token that can be used as the value of the pageToken parameter to retrieve the next page in the result set.", "type": "string" }, "pageInfo": { @@ -8130,14 +8313,14 @@ "description": "General pagination information." }, "prevPageToken": { - "description": "The token that can be used as the value of the pageToken\nparameter to retrieve the previous page in the result set.", + "description": "The token that can be used as the value of the pageToken parameter to retrieve the previous page in the result set.", "type": "string" }, "tokenPagination": { "$ref": "TokenPagination" }, "visitorId": { - "description": "The visitorId identifies the visitor.", + "description": "The visitorId identifies the visitor.", "type": "string" } }, @@ -8148,23 +8331,23 @@ "id": "LiveBroadcastSnippet", "properties": { "actualEndTime": { - "description": "The date and time that the broadcast actually ended. This information is\nonly available once the broadcast's state is complete. The\nvalue is specified in ISO 8601\nformat.", + "description": "The date and time that the broadcast actually ended. This information is only available once the broadcast's state is complete. The value is specified in ISO 8601 format.", "type": "string" }, "actualStartTime": { - "description": "The date and time that the broadcast actually started. This information is\nonly available once the broadcast's state is live. The\nvalue is specified in ISO 8601\nformat.", + "description": "The date and time that the broadcast actually started. This information is only available once the broadcast's state is live. The value is specified in ISO 8601 format.", "type": "string" }, "channelId": { - "description": "The ID that YouTube uses to uniquely identify the channel that\nis publishing the broadcast.", + "description": "The ID that YouTube uses to uniquely identify the channel that is publishing the broadcast.", "type": "string" }, "description": { - "description": "The broadcast's description. As with the title, you can set\nthis field by modifying the broadcast resource or by setting the\ndescription\nfield of the corresponding video resource.", + "description": "The broadcast's description. As with the title, you can set this field by modifying the broadcast resource or by setting the description field of the corresponding video resource.", "type": "string" }, "isDefaultBroadcast": { - "description": "Indicates whether this broadcast is the default broadcast.\nInternal only.", + "description": "Indicates whether this broadcast is the default broadcast. Internal only.", "type": "boolean" }, "liveChatId": { @@ -8172,34 +8355,34 @@ "type": "string" }, "publishedAt": { - "description": "The date and time that the broadcast was added to YouTube's live broadcast\nschedule. The value is specified in\nISO 8601\nformat.", + "description": "The date and time that the broadcast was added to YouTube's live broadcast schedule. The value is specified in ISO 8601 format.", "type": "string" }, "scheduledEndTime": { - "description": "The date and time that the broadcast is scheduled to end. The value\nis specified in ISO 8601\nformat.", + "description": "The date and time that the broadcast is scheduled to end. The value is specified in ISO 8601 format.", "type": "string" }, "scheduledStartTime": { - "description": "The date and time that the broadcast is scheduled to start. The value\nis specified in ISO 8601\nformat.", + "description": "The date and time that the broadcast is scheduled to start. The value is specified in ISO 8601 format.", "type": "string" }, "thumbnails": { "$ref": "ThumbnailDetails", - "description": "A map of thumbnail images associated with the broadcast. For each nested\nobject in this object, the key is the name of the thumbnail image, and\nthe value is an object that contains other information about the\nthumbnail." + "description": "A map of thumbnail images associated with the broadcast. For each nested object in this object, the key is the name of the thumbnail image, and the value is an object that contains other information about the thumbnail." }, "title": { - "description": "The broadcast's title. Note that the broadcast represents exactly one\nYouTube video. You can set this field by modifying the broadcast resource\nor by setting the\ntitle\nfield of the corresponding video resource.", + "description": "The broadcast's title. Note that the broadcast represents exactly one YouTube video. You can set this field by modifying the broadcast resource or by setting the title field of the corresponding video resource.", "type": "string" } }, "type": "object" }, "LiveBroadcastStatistics": { - "description": "Statistics about the live broadcast. These represent a snapshot of the values\nat the time of the request. Statistics are only returned for live broadcasts.", + "description": "Statistics about the live broadcast. These represent a snapshot of the values at the time of the request. Statistics are only returned for live broadcasts.", "id": "LiveBroadcastStatistics", "properties": { "totalChatCount": { - "description": "The total number of live chat messages currently on the broadcast. The\nproperty and its value will be present if the broadcast is public, has\nthe live chat feature enabled, and has at least one message. Note that\nthis field will not be filled after the broadcast ends. So this property\nwould not identify the number of chat messages for an archived video of a\ncompleted live broadcast.", + "description": "The total number of live chat messages currently on the broadcast. The property and its value will be present if the broadcast is public, has the live chat feature enabled, and has at least one message. Note that this field will not be filled after the broadcast ends. So this property would not identify the number of chat messages for an archived video of a completed live broadcast.", "format": "uint64", "type": "string" } @@ -8211,7 +8394,7 @@ "id": "LiveBroadcastStatus", "properties": { "lifeCycleStatus": { - "description": "The broadcast's status. The status can be updated using the API's\nliveBroadcasts.transition method.", + "description": "The broadcast's status. The status can be updated using the API's liveBroadcasts.transition method.", "enum": [ "lifeCycleStatusUnspecified", "created", @@ -8246,18 +8429,18 @@ ], "enumDescriptions": [ "", - "Low priority broadcast: for low view count HoAs or other\nlow priority broadcasts.", + "Low priority broadcast: for low view count HoAs or other low priority broadcasts.", "Normal priority broadcast: for regular HoAs and broadcasts.", "High priority broadcast: for high profile HoAs, like PixelCorp ones." ], "type": "string" }, "madeForKids": { - "description": "Whether the broadcast is made for kids or not, decided by YouTube instead\nof the creator. This field is read only.", + "description": "Whether the broadcast is made for kids or not, decided by YouTube instead of the creator. This field is read only.", "type": "boolean" }, "privacyStatus": { - "description": "The broadcast's privacy status. Note that the broadcast represents\nexactly one YouTube video, so the privacy settings are identical to\nthose supported for videos. In addition, you can set this field by\nmodifying the broadcast resource or by setting the\nprivacyStatus\nfield of the corresponding video resource.", + "description": "The broadcast's privacy status. Note that the broadcast represents exactly one YouTube video, so the privacy settings are identical to those supported for videos. In addition, you can set this field by modifying the broadcast resource or by setting the privacyStatus field of the corresponding video resource.", "enum": [ "public", "unlisted", @@ -8287,7 +8470,7 @@ "type": "string" }, "selfDeclaredMadeForKids": { - "description": "This field will be set to True if the creator declares the broadcast to be\nkids only: go/live-cw-work.", + "description": "This field will be set to True if the creator declares the broadcast to be kids only: go/live-cw-work.", "type": "boolean" } }, @@ -8307,7 +8490,7 @@ }, "kind": { "default": "youtube#liveChatBan", - "description": "Identifies what kind of resource this is. Value: the fixed string\n`\"youtube#liveChatBan\"`.", + "description": "Identifies what kind of resource this is. Value: the fixed string `\"youtube#liveChatBan\"`.", "type": "string" }, "snippet": { @@ -8373,12 +8556,12 @@ "type": "object" }, "LiveChatMessage": { - "description": "A liveChatMessage resource represents a chat\nmessage in a YouTube Live Chat.", + "description": "A *liveChatMessage* resource represents a chat message in a YouTube Live Chat.", "id": "LiveChatMessage", "properties": { "authorDetails": { "$ref": "LiveChatMessageAuthorDetails", - "description": "The authorDetails object contains basic details about the\nuser that posted this message." + "description": "The authorDetails object contains basic details about the user that posted this message." }, "etag": { "description": "Etag of this resource.", @@ -8390,12 +8573,12 @@ }, "kind": { "default": "youtube#liveChatMessage", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#liveChatMessage\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#liveChatMessage\".", "type": "string" }, "snippet": { "$ref": "LiveChatMessageSnippet", - "description": "The snippet object contains basic details about the message." + "description": "The snippet object contains basic details about the message." } }, "type": "object" @@ -8466,14 +8649,14 @@ }, "kind": { "default": "youtube#liveChatMessageListResponse", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#liveChatMessageListResponse\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#liveChatMessageListResponse\".", "type": "string" }, "nextPageToken": { "type": "string" }, "offlineAt": { - "description": "The date and time when the underlying stream went offline. The value is\nspecified in ISO 8601\nformat.", + "description": "The date and time when the underlying stream went offline. The value is specified in ISO 8601 format.", "type": "string" }, "pageInfo": { @@ -8489,7 +8672,7 @@ "$ref": "TokenPagination" }, "visitorId": { - "description": "The visitorId identifies the visitor.", + "description": "The visitorId identifies the visitor.", "type": "string" } }, @@ -8508,16 +8691,16 @@ "id": "LiveChatMessageSnippet", "properties": { "authorChannelId": { - "description": "The ID of the user that authored this message, this field is not always\nfilled.\ntextMessageEvent - the user that wrote the message\nfanFundingEvent - the user that funded the broadcast\nnewSponsorEvent - the user that just became a sponsor\nmessageDeletedEvent - the moderator that took the action\nmessageRetractedEvent - the author that retracted their message\nuserBannedEvent - the moderator that took the action\nsuperChatEvent - the user that made the purchase", + "description": "The ID of the user that authored this message, this field is not always filled. textMessageEvent - the user that wrote the message fanFundingEvent - the user that funded the broadcast newSponsorEvent - the user that just became a sponsor messageDeletedEvent - the moderator that took the action messageRetractedEvent - the author that retracted their message userBannedEvent - the moderator that took the action superChatEvent - the user that made the purchase", "type": "string" }, "displayMessage": { - "description": "Contains a string that can be displayed to the user.\nIf this field is not present the message is silent, at the moment only\nmessages of type TOMBSTONE and CHAT_ENDED_EVENT are silent.", + "description": "Contains a string that can be displayed to the user. If this field is not present the message is silent, at the moment only messages of type TOMBSTONE and CHAT_ENDED_EVENT are silent.", "type": "string" }, "fanFundingEventDetails": { "$ref": "LiveChatFanFundingEventDetails", - "description": "Details about the funding event, this is only set if the type is\n'fanFundingEvent'." + "description": "Details about the funding event, this is only set if the type is 'fanFundingEvent'." }, "hasDisplayContent": { "description": "Whether the message has display content that should be displayed to users.", @@ -8533,23 +8716,23 @@ "$ref": "LiveChatMessageRetractedDetails" }, "publishedAt": { - "description": "The date and time when the message was orignally published. The value is\nspecified in ISO 8601\nformat.", + "description": "The date and time when the message was orignally published. The value is specified in ISO 8601 format.", "type": "string" }, "superChatDetails": { "$ref": "LiveChatSuperChatDetails", - "description": "Details about the Super Chat event, this is only set if the type is\n'superChatEvent'." + "description": "Details about the Super Chat event, this is only set if the type is 'superChatEvent'." }, "superStickerDetails": { "$ref": "LiveChatSuperStickerDetails", - "description": "Details about the Super Sticker event, this is only set if the type is\n'superStickerEvent'." + "description": "Details about the Super Sticker event, this is only set if the type is 'superStickerEvent'." }, "textMessageDetails": { "$ref": "LiveChatTextMessageDetails", - "description": "Details about the text message, this is only set if the type is\n'textMessageEvent'." + "description": "Details about the text message, this is only set if the type is 'textMessageEvent'." }, "type": { - "description": "The type of message, this will always be present, it determines the\ncontents of the message as well as which fields will be present.", + "description": "The type of message, this will always be present, it determines the contents of the message as well as which fields will be present.", "enum": [ "invalidType", "textMessageEvent", @@ -8589,7 +8772,7 @@ "type": "object" }, "LiveChatModerator": { - "description": "A liveChatModerator resource represents a\nmoderator for a YouTube live chat. A chat moderator has the ability to\nban/unban users from a chat, remove message, etc.", + "description": "A *liveChatModerator* resource represents a moderator for a YouTube live chat. A chat moderator has the ability to ban/unban users from a chat, remove message, etc.", "id": "LiveChatModerator", "properties": { "etag": { @@ -8602,12 +8785,12 @@ }, "kind": { "default": "youtube#liveChatModerator", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#liveChatModerator\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#liveChatModerator\".", "type": "string" }, "snippet": { "$ref": "LiveChatModeratorSnippet", - "description": "The snippet object contains basic details about the\nmoderator." + "description": "The snippet object contains basic details about the moderator." } }, "type": "object" @@ -8632,11 +8815,11 @@ }, "kind": { "default": "youtube#liveChatModeratorListResponse", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#liveChatModeratorListResponse\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#liveChatModeratorListResponse\".", "type": "string" }, "nextPageToken": { - "description": "The token that can be used as the value of the pageToken\nparameter to retrieve the next page in the result set.", + "description": "The token that can be used as the value of the pageToken parameter to retrieve the next page in the result set.", "type": "string" }, "pageInfo": { @@ -8644,14 +8827,14 @@ "description": "General pagination information." }, "prevPageToken": { - "description": "The token that can be used as the value of the pageToken\nparameter to retrieve the previous page in the result set.", + "description": "The token that can be used as the value of the pageToken parameter to retrieve the previous page in the result set.", "type": "string" }, "tokenPagination": { "$ref": "TokenPagination" }, "visitorId": { - "description": "The visitorId identifies the visitor.", + "description": "The visitorId identifies the visitor.", "type": "string" } }, @@ -8688,7 +8871,7 @@ "type": "string" }, "tier": { - "description": "The tier in which the amount belongs. Lower amounts belong to lower\ntiers. The lowest tier is 1.", + "description": "The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is 1.", "format": "uint32", "type": "integer" }, @@ -8720,7 +8903,7 @@ "description": "Information about the Super Sticker." }, "tier": { - "description": "The tier in which the amount belongs. Lower amounts belong to lower\ntiers. The lowest tier is 1.", + "description": "The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is 1.", "format": "uint32", "type": "integer" } @@ -8741,7 +8924,7 @@ "id": "LiveChatUserBannedMessageDetails", "properties": { "banDurationSeconds": { - "description": "The duration of the ban. This property is only present if the\nbanType is temporary.", + "description": "The duration of the ban. This property is only present if the banType is temporary.", "format": "uint64", "type": "string" }, @@ -8770,11 +8953,11 @@ "properties": { "cdn": { "$ref": "CdnSettings", - "description": "The cdn object defines the live stream's content delivery\nnetwork (CDN) settings. These settings provide details about the manner\nin which you stream your content to YouTube." + "description": "The cdn object defines the live stream's content delivery network (CDN) settings. These settings provide details about the manner in which you stream your content to YouTube." }, "contentDetails": { "$ref": "LiveStreamContentDetails", - "description": "The content_details object contains information about the\nstream, including the closed captions ingestion URL." + "description": "The content_details object contains information about the stream, including the closed captions ingestion URL." }, "etag": { "description": "Etag of this resource.", @@ -8786,16 +8969,16 @@ }, "kind": { "default": "youtube#liveStream", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#liveStream\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#liveStream\".", "type": "string" }, "snippet": { "$ref": "LiveStreamSnippet", - "description": "The snippet object contains basic details about the\nstream, including its channel, title, and description." + "description": "The snippet object contains basic details about the stream, including its channel, title, and description." }, "status": { "$ref": "LiveStreamStatus", - "description": "The status object contains information about\nlive stream's status." + "description": "The status object contains information about live stream's status." } }, "type": "object" @@ -8913,7 +9096,7 @@ "type": "string" }, "isReusable": { - "description": "Indicates whether the stream is reusable, which means that it\ncan be bound to multiple broadcasts. It is common for\nbroadcasters to reuse the same stream for many different\nbroadcasts if those broadcasts occur at different times.

\nIf you set this value to false, then the stream\nwill not be reusable, which means that it can only be bound to\none broadcast. Non-reusable streams differ from reusable streams in the\nfollowing ways:\n
    \n
  • A non-reusable stream can only be bound to one broadcast.
    • \n
  • A non-reusable stream might be deleted by an automated process\n after the broadcast ends.
    • \n
  • The \n liveStreams.list method does not list non-reusable streams\n if you call the method and set the mine parameter to\n true. The only way to use that method to retrieve the\n resource for a non-reusable stream is to use the id\n parameter to identify the stream.
    • \n
", + "description": "Indicates whether the stream is reusable, which means that it can be bound to multiple broadcasts. It is common for broadcasters to reuse the same stream for many different broadcasts if those broadcasts occur at different times. If you set this value to false, then the stream will not be reusable, which means that it can only be bound to one broadcast. Non-reusable streams differ from reusable streams in the following ways: - A non-reusable stream can only be bound to one broadcast. - A non-reusable stream might be deleted by an automated process after the broadcast ends. - The liveStreams.list method does not list non-reusable streams if you call the method and set the mine parameter to true. The only way to use that method to retrieve the resource for a non-reusable stream is to use the id parameter to identify the stream. ", "type": "boolean" } }, @@ -8975,25 +9158,25 @@ }, "kind": { "default": "youtube#liveStreamListResponse", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#liveStreamListResponse\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#liveStreamListResponse\".", "type": "string" }, "nextPageToken": { - "description": "The token that can be used as the value of the pageToken\nparameter to retrieve the next page in the result set.", + "description": "The token that can be used as the value of the pageToken parameter to retrieve the next page in the result set.", "type": "string" }, "pageInfo": { "$ref": "PageInfo" }, "prevPageToken": { - "description": "The token that can be used as the value of the pageToken\nparameter to retrieve the previous page in the result set.", + "description": "The token that can be used as the value of the pageToken parameter to retrieve the previous page in the result set.", "type": "string" }, "tokenPagination": { "$ref": "TokenPagination" }, "visitorId": { - "description": "The visitorId identifies the visitor.", + "description": "The visitorId identifies the visitor.", "type": "string" } }, @@ -9003,18 +9186,18 @@ "id": "LiveStreamSnippet", "properties": { "channelId": { - "description": "The ID that YouTube uses to uniquely identify the channel that\nis transmitting the stream.", + "description": "The ID that YouTube uses to uniquely identify the channel that is transmitting the stream.", "type": "string" }, "description": { - "description": "The stream's description. The value cannot be longer than 10000\ncharacters.", + "description": "The stream's description. The value cannot be longer than 10000 characters.", "type": "string" }, "isDefaultStream": { "type": "boolean" }, "publishedAt": { - "description": "The date and time that the stream was created. The value is specified in\nISO 8601\nformat.", + "description": "The date and time that the stream was created. The value is specified in ISO 8601 format.", "type": "string" }, "title": { @@ -9084,7 +9267,7 @@ "type": "object" }, "Member": { - "description": "A member resource represents a member for a\nYouTube channel. A member provides recurring monetary support to a creator\nand receives special benefits.", + "description": "A *member* resource represents a member for a YouTube channel. A member provides recurring monetary support to a creator and receives special benefits.", "id": "Member", "properties": { "etag": { @@ -9093,12 +9276,12 @@ }, "kind": { "default": "youtube#member", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#member\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#member\".", "type": "string" }, "snippet": { "$ref": "MemberSnippet", - "description": "The snippet object contains basic details about the member." + "description": "The snippet object contains basic details about the member." } }, "type": "object" @@ -9123,11 +9306,11 @@ }, "kind": { "default": "youtube#memberListResponse", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#memberListResponse\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#memberListResponse\".", "type": "string" }, "nextPageToken": { - "description": "The token that can be used as the value of the pageToken\nparameter to retrieve the next page in the result set.", + "description": "The token that can be used as the value of the pageToken parameter to retrieve the next page in the result set.", "type": "string" }, "pageInfo": { @@ -9137,7 +9320,7 @@ "$ref": "TokenPagination" }, "visitorId": { - "description": "The visitorId identifies the visitor.", + "description": "The visitorId identifies the visitor.", "type": "string" } }, @@ -9165,7 +9348,7 @@ "id": "MembershipsDetails", "properties": { "accessibleLevels": { - "description": "Ids of all levels that the user has access to. This includes the currently\nactive level and all other levels that are included because of a higher\npurchase.", + "description": "Ids of all levels that the user has access to. This includes the currently active level and all other levels that are included because of a higher purchase.", "items": { "type": "string" }, @@ -9176,12 +9359,12 @@ "type": "string" }, "highestAccessibleLevelDisplayName": { - "description": "Display name for the highest level that the user has access to at the\nmoment.", + "description": "Display name for the highest level that the user has access to at the moment.", "type": "string" }, "membershipsDuration": { "$ref": "MembershipsDuration", - "description": "Data about memberships duration without taking into consideration pricing\nlevels." + "description": "Data about memberships duration without taking into consideration pricing levels." }, "membershipsDurationAtLevels": { "description": "Data about memberships duration on particular pricing levels.", @@ -9197,11 +9380,11 @@ "id": "MembershipsDuration", "properties": { "memberSince": { - "description": "The date and time when the user became a continuous member across all\nlevels.", + "description": "The date and time when the user became a continuous member across all levels.", "type": "string" }, "memberTotalDurationMonths": { - "description": "The cumulative time the user has been a member across all levels in\ncomplete months (the time is rounded down to the nearest integer).", + "description": "The cumulative time the user has been a member across all levels in complete months (the time is rounded down to the nearest integer).", "format": "int32", "type": "integer" } @@ -9216,11 +9399,11 @@ "type": "string" }, "memberSince": { - "description": "The date and time when the user became a continuous member for the given\nlevel.", + "description": "The date and time when the user became a continuous member for the given level.", "type": "string" }, "memberTotalDurationMonths": { - "description": "The cumulative time the user has been a member for the given level in\ncomplete months (the time is rounded down to the nearest integer).", + "description": "The cumulative time the user has been a member for the given level in complete months (the time is rounded down to the nearest integer).", "format": "int32", "type": "integer" } @@ -9228,7 +9411,7 @@ "type": "object" }, "MembershipsLevel": { - "description": "A membershipsLevel resource represents an offer\nmade by YouTube creators for their fans. Users can become members of the\nchannel by joining one of the available levels. They will provide recurring\nmonetary support and receives special benefits.", + "description": "A *membershipsLevel* resource represents an offer made by YouTube creators for their fans. Users can become members of the channel by joining one of the available levels. They will provide recurring monetary support and receives special benefits.", "id": "MembershipsLevel", "properties": { "etag": { @@ -9241,12 +9424,12 @@ }, "kind": { "default": "youtube#membershipsLevel", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#membershipsLevelListResponse\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#membershipsLevelListResponse\".", "type": "string" }, "snippet": { "$ref": "MembershipsLevelSnippet", - "description": "The snippet object contains basic details about the level." + "description": "The snippet object contains basic details about the level." } }, "type": "object" @@ -9271,11 +9454,11 @@ }, "kind": { "default": "youtube#membershipsLevelListResponse", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#membershipsLevelListResponse\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#membershipsLevelListResponse\".", "type": "string" }, "visitorId": { - "description": "The visitorId identifies the visitor.", + "description": "The visitorId identifies the visitor.", "type": "string" } }, @@ -9305,7 +9488,7 @@ "youtube.liveBroadcasts.update" ] }, - "description": "If you have set the\nenableMonitorStream\nproperty to true, then this property determines the\nlength of the live broadcast delay.", + "description": "If you have set the enableMonitorStream property to true, then this property determines the length of the live broadcast delay.", "format": "uint32", "type": "integer" }, @@ -9319,14 +9502,14 @@ "youtube.liveBroadcasts.update" ] }, - "description": "This value determines whether the monitor stream is enabled for the\nbroadcast. If the monitor stream is enabled, then YouTube will\nbroadcast the event content on a special stream intended only for\nthe broadcaster's consumption. The broadcaster can use the stream\nto review the event content and also to identify the optimal times\nto insert cuepoints.

\nYou need to set this value to true if you intend to have\na broadcast delay for your event.

\nNote: This property cannot be updated once the\nbroadcast is in the testing or live state.", + "description": "This value determines whether the monitor stream is enabled for the broadcast. If the monitor stream is enabled, then YouTube will broadcast the event content on a special stream intended only for the broadcaster's consumption. The broadcaster can use the stream to review the event content and also to identify the optimal times to insert cuepoints. You need to set this value to true if you intend to have a broadcast delay for your event. *Note:* This property cannot be updated once the broadcast is in the testing or live state.", "type": "boolean" } }, "type": "object" }, "PageInfo": { - "description": "Paging details for lists of resources, including total number of items\navailable and number of resources returned in a single page.", + "description": "Paging details for lists of resources, including total number of items available and number of resources returned in a single page.", "id": "PageInfo", "properties": { "resultsPerPage": { @@ -9343,12 +9526,12 @@ "type": "object" }, "Playlist": { - "description": "A playlist resource represents a YouTube\nplaylist. A playlist is a collection of videos that can be viewed\nsequentially and shared with other users. A playlist can contain up to\n200 videos, and YouTube does not limit the number of playlists that\neach user creates. By default, playlists are publicly visible to other\nusers, but playlists can be public or private.

YouTube\nalso uses playlists to identify special collections of videos for a\nchannel, such as:\n
    \n
  • uploaded videos
    • \n
  • favorite videos
    • \n
  • positively rated (liked) videos
    • \n
  • watch history
    • \n
  • watch later
    • \n
\nTo be more specific, these lists are associated with a channel, which\nis a collection of a person, group, or company's videos, playlists,\nand other YouTube information. You can retrieve the playlist IDs for\neach of these lists from the channel resource for a\ngiven channel.

You can then use the \nplaylistItems.list method to retrieve any of those\nlists. You can also add or remove items from those lists by calling\nthe \nplaylistItems.insert and \nplaylistItems.delete methods.", + "description": "A *playlist* resource represents a YouTube playlist. A playlist is a collection of videos that can be viewed sequentially and shared with other users. A playlist can contain up to 200 videos, and YouTube does not limit the number of playlists that each user creates. By default, playlists are publicly visible to other users, but playlists can be public or private. YouTube also uses playlists to identify special collections of videos for a channel, such as: - uploaded videos - favorite videos - positively rated (liked) videos - watch history - watch later To be more specific, these lists are associated with a channel, which is a collection of a person, group, or company's videos, playlists, and other YouTube information. You can retrieve the playlist IDs for each of these lists from the channel resource for a given channel. You can then use the playlistItems.list method to retrieve any of those lists. You can also add or remove items from those lists by calling the playlistItems.insert and playlistItems.delete methods.", "id": "Playlist", "properties": { "contentDetails": { "$ref": "PlaylistContentDetails", - "description": "The contentDetails object contains information like\nvideo count." + "description": "The contentDetails object contains information like video count." }, "etag": { "description": "Etag of this resource.", @@ -9360,7 +9543,7 @@ }, "kind": { "default": "youtube#playlist", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#playlist\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#playlist\".", "type": "string" }, "localizations": { @@ -9372,15 +9555,15 @@ }, "player": { "$ref": "PlaylistPlayer", - "description": "The player object contains information that you would use\nto play the playlist in an embedded player." + "description": "The player object contains information that you would use to play the playlist in an embedded player." }, "snippet": { "$ref": "PlaylistSnippet", - "description": "The snippet object contains basic details about the\nplaylist, such as its title and description." + "description": "The snippet object contains basic details about the playlist, such as its title and description." }, "status": { "$ref": "PlaylistStatus", - "description": "The status object contains status information for the\nplaylist." + "description": "The status object contains status information for the playlist." } }, "type": "object" @@ -9389,15 +9572,15 @@ "id": "PlaylistCard", "properties": { "customMessage": { - "description": "Each card can have a custom message.\nOptional.", + "description": "Each card can have a custom message. Optional.", "type": "string" }, "playlistId": { - "description": "External playlist ID.\nRequired.", + "description": "External playlist ID. Required.", "type": "string" }, "startVideoId": { - "description": "Starting video, if not the first.\nOptional.", + "description": "Starting video, if not the first. Optional.", "type": "string" } }, @@ -9415,12 +9598,12 @@ "type": "object" }, "PlaylistItem": { - "description": "A playlistItem resource identifies\nanother resource, such as a video, that is included in a playlist. In\naddition, the playlistItem resource contains details\nabout the included resource that pertain specifically to how that\nresource is used in that playlist.

YouTube uses playlists to\nidentify special collections of videos for a channel, such as:\n
    \n
  • uploaded videos
    • \n
  • favorite videos
    • \n
  • positively rated (liked) videos
    • \n
  • watch history
    • \n
  • watch later
    • \n
\n To be more specific, these lists are associated with a channel, which\nis a collection of a person, group, or company's videos, playlists,\nand other YouTube information.\n

\n You can retrieve the playlist IDs for each of these lists from the\n channel resource\n for a given channel. You can then use the \nplaylistItems.list method to retrieve any of those\nlists. You can also add or remove items from those lists by calling\nthe \nplaylistItems.insert and \nplaylistItems.delete methods. For example, if a user gives\na positive rating to a video, you would insert that video into the\nliked videos playlist for that user's channel.", + "description": "A *playlistItem* resource identifies another resource, such as a video, that is included in a playlist. In addition, the playlistItem resource contains details about the included resource that pertain specifically to how that resource is used in that playlist. YouTube uses playlists to identify special collections of videos for a channel, such as: - uploaded videos - favorite videos - positively rated (liked) videos - watch history - watch later To be more specific, these lists are associated with a channel, which is a collection of a person, group, or company's videos, playlists, and other YouTube information. You can retrieve the playlist IDs for each of these lists from the channel resource for a given channel. You can then use the playlistItems.list method to retrieve any of those lists. You can also add or remove items from those lists by calling the playlistItems.insert and playlistItems.delete methods. For example, if a user gives a positive rating to a video, you would insert that video into the liked videos playlist for that user's channel.", "id": "PlaylistItem", "properties": { "contentDetails": { "$ref": "PlaylistItemContentDetails", - "description": "The contentDetails object is included in the resource if\nthe included item is a YouTube video. The object contains additional\ninformation about the video." + "description": "The contentDetails object is included in the resource if the included item is a YouTube video. The object contains additional information about the video." }, "etag": { "description": "Etag of this resource.", @@ -9432,16 +9615,16 @@ }, "kind": { "default": "youtube#playlistItem", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#playlistItem\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#playlistItem\".", "type": "string" }, "snippet": { "$ref": "PlaylistItemSnippet", - "description": "The snippet object contains basic details about the\nplaylist item, such as its title and position in the playlist." + "description": "The snippet object contains basic details about the playlist item, such as its title and position in the playlist." }, "status": { "$ref": "PlaylistItemStatus", - "description": "The status object contains information about the playlist\nitem's privacy status." + "description": "The status object contains information about the playlist item's privacy status." } }, "type": "object" @@ -9450,7 +9633,7 @@ "id": "PlaylistItemContentDetails", "properties": { "endAt": { - "description": "The time, measured in seconds from the start of the video, when the video\nshould stop playing. (The playlist owner can specify the times when the\nvideo should start and stop playing when the video is played in the context\nof the playlist.) By default, assume that the video.endTime is\nthe end of the video.", + "description": "The time, measured in seconds from the start of the video, when the video should stop playing. (The playlist owner can specify the times when the video should start and stop playing when the video is played in the context of the playlist.) By default, assume that the video.endTime is the end of the video.", "type": "string" }, "note": { @@ -9458,15 +9641,15 @@ "type": "string" }, "startAt": { - "description": "The time, measured in seconds from the start of the video, when the video\nshould start playing. (The playlist owner can specify the times when the\nvideo should start and stop playing when the video is played in the context\nof the playlist.) The default value is 0.", + "description": "The time, measured in seconds from the start of the video, when the video should start playing. (The playlist owner can specify the times when the video should start and stop playing when the video is played in the context of the playlist.) The default value is 0.", "type": "string" }, "videoId": { - "description": "The ID that YouTube uses to uniquely identify a video. To retrieve the video\nresource, set the id query parameter to this value in your\nAPI request.", + "description": "The ID that YouTube uses to uniquely identify a video. To retrieve the video resource, set the id query parameter to this value in your API request.", "type": "string" }, "videoPublishedAt": { - "description": "The date and time that the video was published to YouTube. The value is\nspecified in ISO 8601\nformat.", + "description": "The date and time that the video was published to YouTube. The value is specified in ISO 8601 format.", "type": "string" } }, @@ -9491,11 +9674,11 @@ }, "kind": { "default": "youtube#playlistItemListResponse", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#playlistItemListResponse\".\nEtag of this resource.", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#playlistItemListResponse\". Etag of this resource.", "type": "string" }, "nextPageToken": { - "description": "The token that can be used as the value of the pageToken\nparameter to retrieve the next page in the result set.", + "description": "The token that can be used as the value of the pageToken parameter to retrieve the next page in the result set.", "type": "string" }, "pageInfo": { @@ -9503,25 +9686,25 @@ "description": "General pagination information." }, "prevPageToken": { - "description": "The token that can be used as the value of the pageToken\nparameter to retrieve the previous page in the result set.", + "description": "The token that can be used as the value of the pageToken parameter to retrieve the previous page in the result set.", "type": "string" }, "tokenPagination": { "$ref": "TokenPagination" }, "visitorId": { - "description": "The visitorId identifies the visitor.", + "description": "The visitorId identifies the visitor.", "type": "string" } }, "type": "object" }, "PlaylistItemSnippet": { - "description": "Basic details about a playlist, including title, description and thumbnails.\nBasic details of a YouTube Playlist item provided by the author.\nNext ID: 13", + "description": "Basic details about a playlist, including title, description and thumbnails. Basic details of a YouTube Playlist item provided by the author. Next ID: 13", "id": "PlaylistItemSnippet", "properties": { "channelId": { - "description": "The ID that YouTube uses to uniquely identify the user that added\nthe item to the playlist.", + "description": "The ID that YouTube uses to uniquely identify the user that added the item to the playlist.", "type": "string" }, "channelTitle": { @@ -9533,25 +9716,25 @@ "type": "string" }, "playlistId": { - "description": "The ID that YouTube uses to uniquely identify thGe playlist that the\nplaylist item is in.", + "description": "The ID that YouTube uses to uniquely identify thGe playlist that the playlist item is in.", "type": "string" }, "position": { - "description": "The order in which the item appears in the playlist. The value uses a\nzero-based index, so the first item has a position of 0,\nthe second item has a position of 1, and so forth.", + "description": "The order in which the item appears in the playlist. The value uses a zero-based index, so the first item has a position of 0, the second item has a position of 1, and so forth.", "format": "uint32", "type": "integer" }, "publishedAt": { - "description": "The date and time that the item was added to the playlist. The value is\nspecified in ISO 8601\nformat.", + "description": "The date and time that the item was added to the playlist. The value is specified in ISO 8601 format.", "type": "string" }, "resourceId": { "$ref": "ResourceId", - "description": "The id object contains information that can be used to\nuniquely identify the resource that is included in the playlist as\nthe playlist item." + "description": "The id object contains information that can be used to uniquely identify the resource that is included in the playlist as the playlist item." }, "thumbnails": { "$ref": "ThumbnailDetails", - "description": "A map of thumbnail images associated with the playlist item. For each\nobject in the map, the key is the name of the thumbnail image, and the\nvalue is an object that contains other information about the thumbnail." + "description": "A map of thumbnail images associated with the playlist item. For each object in the map, the key is the name of the thumbnail image, and the value is an object that contains other information about the thumbnail." }, "title": { "description": "The item's title.", @@ -9601,11 +9784,11 @@ }, "kind": { "default": "youtube#playlistListResponse", - "description": "Identifies what kind of resource this is. Value: the fixed string\n\"youtube#playlistListResponse\".", + "description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#playlistListResponse\".", "type": "string" }, "nextPageToken": { - "description": "The token that can be used as the value of the pageToken\nparameter to retrieve the next page in the result set.", + "description": "The token that can be used as the value of the pageToken parameter to retrieve the next page in the result set.", "type": "string" }, "pageInfo": { @@ -9613,14 +9796,14 @@ "description": "General pagination information." }, "prevPageToken": { - "description": "The token that can be used as the value of the pageToken\nparameter to retrieve the previous page in the result set.", + "description": "The token that can be used as the value of the pageToken parameter to retrieve the previous page in the result set.", "type": "string" }, "tokenPagination": { "$ref": "TokenPagination" }, "visitorId": { - "description": "The visitorId identifies the visitor.", + "description": "The visitorId identifies the visitor.", "type": "string" } }, @@ -9645,7 +9828,7 @@ "id": "PlaylistPlayer", "properties": { "embedHtml": { - "description": "An <iframe> tag that embeds a player that will\nplay the playlist.", + "description": "An