List
|
|||||
|
|
||||
Returns a list of categories that can be associated with YouTube videos
Authorization
To use this building block you will have to grant access to at least one of the following scopes:
- Manage your YouTube account
- See, edit, and permanently delete your YouTube videos, ratings, comments and captions
- View your YouTube account
- View and manage your assets and associated content on YouTube
Input
This building block consumes 4 input parameters
| Name | Format | Description |
|---|---|---|
part Required |
STRING |
The part parameter specifies the videoCategory resource properties that the API response will include. Set the parameter value to snippet |
hl |
STRING |
The hl parameter specifies the language that should be used for text values in the API response |
id |
STRING |
The id parameter specifies a comma-separated list of video category IDs for the resources that you are retrieving |
regionCode |
STRING |
The regionCode parameter instructs the API to return the list of video categories available in the specified country. The parameter value is an ISO 3166-1 alpha-2 country code |
= Parameter name
= Format
|
part STRING Required The part parameter specifies the videoCategory resource properties that the API response will include. Set the parameter value to snippet |
|
hl STRING The hl parameter specifies the language that should be used for text values in the API response |
|
id STRING The id parameter specifies a comma-separated list of video category IDs for the resources that you are retrieving |
|
regionCode STRING The regionCode parameter instructs the API to return the list of video categories available in the specified country. The parameter value is an ISO 3166-1 alpha-2 country code |
Output
This building block provides 18 output parameters
| Name | Format | Description |
|---|---|---|
etag |
STRING |
Etag of this resource |
eventId |
STRING |
Serialized EventId of the request which produced this response |
items[] |
OBJECT |
A videoCategory resource identifies a category that has been or could be associated with uploaded videos |
items[].etag |
STRING |
Etag of this resource |
items[].id |
STRING |
The ID that YouTube uses to uniquely identify the video category |
items[].kind |
STRING |
Identifies what kind of resource this is. Value: the fixed string "youtube#videoCategory" |
items[].snippet |
OBJECT |
Basic details about a video category, such as its localized title |
items[].snippet.assignable |
BOOLEAN |
|
items[].snippet.channelId |
STRING |
The YouTube channel that created the video category |
items[].snippet.title |
STRING |
The video category's title |
kind |
STRING |
Identifies what kind of resource this is. Value: the fixed string "youtube#videoCategoryListResponse" |
nextPageToken |
STRING |
The token that can be used as the value of the pageToken parameter to retrieve the next page in the result set |
pageInfo |
OBJECT |
Paging details for lists of resources, including total number of items available and number of resources returned in a single page |
pageInfo.resultsPerPage |
INTEGER |
The number of results included in the API response |
pageInfo.totalResults |
INTEGER |
The total number of results in the result set |
prevPageToken |
STRING |
The token that can be used as the value of the pageToken parameter to retrieve the previous page in the result set |
tokenPagination |
OBJECT |
Stub token pagination template to suppress results |
visitorId |
STRING |
The visitorId identifies the visitor |
= Parameter name
= Format
|
etag STRING Etag of this resource |
|
eventId STRING Serialized EventId of the request which produced this response |
|
items[] OBJECT A videoCategory resource identifies a category that has been or could be associated with uploaded videos |
|
items[].etag STRING Etag of this resource |
|
items[].id STRING The ID that YouTube uses to uniquely identify the video category |
|
items[].kind STRING Identifies what kind of resource this is. Value: the fixed string "youtube#videoCategory" |
|
items[].snippet OBJECT Basic details about a video category, such as its localized title |
|
items[].snippet.assignable BOOLEAN |
|
items[].snippet.channelId STRING The YouTube channel that created the video category |
|
items[].snippet.title STRING The video category's title |
|
kind STRING Identifies what kind of resource this is. Value: the fixed string "youtube#videoCategoryListResponse" |
|
nextPageToken STRING The token that can be used as the value of the pageToken parameter to retrieve the next page in the result set |
|
pageInfo OBJECT Paging details for lists of resources, including total number of items available and number of resources returned in a single page |
|
pageInfo.resultsPerPage INTEGER The number of results included in the API response |
|
pageInfo.totalResults INTEGER The total number of results in the result set |
|
prevPageToken STRING The token that can be used as the value of the pageToken parameter to retrieve the previous page in the result set |
|
tokenPagination OBJECT Stub token pagination template to suppress results |
|
visitorId STRING The visitorId identifies the visitor |