For example, valid parameter values include 1500m, 5km, 10000ft, and 0.75mi. Valid measurement units are m, km, ft, and mi.
The parameter value must be a floating point number followed by a measurement unit. The locationRadius parameter, in conjunction with the location parameter, defines a circular geographic area. Note: If you specify a value for this parameter, you must also set the type parameter's value to video. The API returns an error if your request specifies a value for the location parameter but does not also specify a value for the locationRadius parameter. The locationRadius parameter specifies the maximum distance that the location associated with a video can be from that point for the video to still be included in the search results.The location parameter value identifies the point at the center of the area.The parameter value is a string that specifies latitude/longitude coordinates e.g. The location parameter, in conjunction with the locationRadius parameter, defines a circular geographic area and also restricts a search to videos that specify, in their metadata, a geographic location that falls within that area. upcoming – Only include upcoming broadcasts.completed – Only include completed broadcasts.If you specify a value for this parameter, you must also set the type parameter's value to video. The eventType parameter restricts a search to broadcast events. The channelType parameter lets you restrict a search to a particular type of channel. Note: Search results are constrained to a maximum of 500 videos if your request specifies a value for the channelId parameter and sets the type parameter value to video, but it does not also set one of the forContentOwner, forDeveloper, or forMine filters. The channelId parameter indicates that the API response should only contain resources created by the channel. In addition, none of the following other parameters can be set in the same request: videoDefinition, videoDimension, videoDuration, videoEmbeddable, videoLicense, videoPaidProductPlacement, videoSyndicated, videoType. If you set this parameter to true, then the type parameter's value must also be set to video. The forMine parameter restricts the search to only retrieve videos owned by the authenticated user. This parameter can only be used in a properly authorized request. Therefore, a developer can restrict results to videos uploaded through the developer's own app or website but not to videos uploaded through other apps or sites. When a search request subsequently sets the forDeveloper parameter to true, the API server uses the request's authorization credentials to identify the developer. The forDeveloper parameter can be used in conjunction with optional search parameters like the q parameter.įor this feature, each uploaded video is automatically tagged with the project number that is associated with the developer's application in the Google Developers Console. The API server uses the request's authorization credentials to identify the developer. The forDeveloper parameter restricts the search to only retrieve videos uploaded via the developer's application or website. None of the following other parameters can be set: videoDefinition, videoDimension, videoDuration, videoEmbeddable, videoLicense, videoPaidProductPlacement, videoSyndicated, videoType.The type parameter value must be set to video.The user authorizing the request must be using an account linked to the specified content owner.The onBehalfOfContentOwner parameter is required.
If forContentOwner is set to true, the request must also meet these requirements: The forContentOwner parameter restricts the search to only retrieve videos owned by the content owner identified by the onBehalfOfContentOwner parameter. This parameter can only be used in a properly authorized request, and it is intended exclusively for YouTube content partners. Set the parameter value to snippet.įilters (specify 0 or 1 of the following parameters) The part parameter specifies a comma-separated list of one or more search resource properties that the API response will include. All of the parameters listed are query parameters. The following table lists the parameters that this query supports. Common use cases Request HTTP request GET Parameters Quota impact: A call to this method has a quota cost of 100 units. By default, a search result set identifies matching video, channel, and playlist resources, but you can also configure queries to only retrieve a specific type of resource. Returns a collection of search results that match the query parameters specified in the API request.
0 kommentar(er)
