Pode criar uma consulta de pesquisa completamente personalizada utilizando o campo de entrada de pesquisa personalizada e os parâmetros apresentados abaixo.
Como formatar uma pesquisa personalizada
Para cada parâmetro que adicionar, comece com um "&" e depois com a chave do parâmetro (ex: "ordem"), depois um sinal de igual "=" e depois um valor aceite (ex: "data"). Não adicione nenhuma codificação de URL, pois o plug-in codificará corretamente a consulta de pesquisa final.
Exemplos
&q=Funny Cat Videos&order=viewCount
&channelId=UClwg08ECyHnm_RzY1wnZC1A&publishedAfter=2019-06-30T00:00:00Z&publishedBefore=2020-01-30T00:00:00Z
&q=Gooseberry Falls&videoDuration=short
Parâmetro Chave | Valores aceites | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
relatedToVideoId |
string O relatedToVideoId recupera uma lista de vídeos que estão relacionados com o vídeo que o valor do parâmetro identifica. O valor do parâmetro deve ser definido como um ID de vídeo do YouTube.
Nota: Se o parâmetro relatedToVideoId for definido, os únicos outros parâmetros suportados são |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
channelId |
string O channelId indica que a resposta da API só deve conter recursos criados pelo canal. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
eventType |
string O eventType restringe uma pesquisa a eventos de difusão.Os valores aceitáveis são:
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
location |
string O location em conjunto com o parâmetro locationRadius define uma área geográfica circular e também restringe uma pesquisa a vídeos que especificam, nos seus metadados, uma localização geográfica que se insere nessa área. O valor do parâmetro é uma cadeia de caracteres que especifica as coordenadas de latitude/longitude, por exemplo, (37. ).
A API devolve um erro se o pedido especificar um valor para o parâmetro |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
locationRadius |
string O locationRadius em conjunto com o parâmetro location define uma área geográfica circular.
O valor do parâmetro deve ser um número de vírgula flutuante seguido de uma unidade de medida. As unidades de medida válidas são Nota: Ver a definição de |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
order |
string O order especifica o método que será utilizado para ordenar os recursos na resposta da API. O valor predefinido é relevance .
Os valores aceitáveis são:
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
publishedAfter |
datetime O publishedAfter indica que a resposta da API só deve conter recursos criados no momento ou após o momento especificado. O valor é um valor de data e hora formatado em RFC 3339 (1970-01-01T00:00:00Z). |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
publishedBefore |
datetime O publishedBefore indica que a resposta da API só deve conter recursos criados antes ou no momento especificado. O valor é um valor de data e hora formatado em RFC 3339 (1970-01-01T00:00:00Z). |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
q |
string O q especifica o termo de consulta a pesquisar.
O seu pedido também pode utilizar a expressão booleana NOT ( |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
regionCode |
string O regionCode instrui a API a devolver resultados de pesquisa para vídeos que podem ser visualizados no país especificado. O valor do parâmetro é um ISO 3166-1 alfa-2 código do país. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
relevanceLanguage |
string O relevanceLanguage dá instruções à API para devolver os resultados da pesquisa que são mais relevantes para a língua especificada. O valor do parâmetro é tipicamente um Código linguístico de duas letras ISO 639-1. No entanto, deve utilizar os valores zh-Hans para chinês simplificado e zh-Hant para chinês tradicional. Tenha em atenção que os resultados noutras línguas continuarão a ser apresentados se forem altamente relevantes para o termo de pesquisa. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
safeSearch |
string O safeSearch indica se os resultados da pesquisa devem incluir conteúdo restrito, bem como conteúdo padrão.
Os valores aceitáveis são:
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
topicId |
string O topicId indica que a resposta da API deve conter apenas recursos associados ao tópico especificado. O valor identifica um ID de tópico do Freebase.
Importante: Devido à descontinuidade do Freebase e da API do Freebase, o Ver IDs de tópicos suportados a partir de 15 de fevereiro de 2017
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
videoCaption |
string O videoCaption indica se a API deve filtrar os resultados da pesquisa de vídeo com base no facto de terem ou não legendas.
Os valores aceitáveis são:
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
videoCategoryId |
string O videoCategoryId filtra os resultados da pesquisa de vídeo com base nos seus categoria. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
videoDefinition |
string O videoDefinition permite-lhe restringir uma pesquisa para incluir apenas vídeos de alta definição (HD) ou de definição padrão (SD). Os vídeos HD estão disponíveis para reprodução em, pelo menos, 720p, embora resoluções mais elevadas, como 1080p, também possam estar disponíveis.
Os valores aceitáveis são:
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
videoDimension |
string O videoDimension permite-lhe restringir uma pesquisa para obter apenas vídeos 2D ou 3D.
Os valores aceitáveis são:
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
videoDuration |
string O videoDuration filtra os resultados da pesquisa de vídeo com base na sua duração.
Os valores aceitáveis são:
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
videoEmbeddable |
string O videoEmbeddable permite-lhe restringir uma pesquisa apenas a vídeos que podem ser incorporados numa página Web.
Os valores aceitáveis são:
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
videoLicense |
string O videoLicense filtra os resultados da pesquisa para incluir apenas vídeos com uma determinada licença. O YouTube permite que os carregadores de vídeos optem por anexar a licença Creative Commons ou a licença padrão do YouTube a cada um dos seus vídeos.
Os valores aceitáveis são:
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
videoSyndicated |
string O videoSyndicated permite-lhe restringir uma pesquisa apenas a vídeos que podem ser reproduzidos fora do youtube.com.
Os valores aceitáveis são:
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
videoType |
string O videoType permite-lhe restringir uma pesquisa a um determinado tipo de vídeos.
Os valores aceitáveis são:
|