Guida alla creazione di una ricerca personalizzata
Palloncino Smash

Unisciti agli oltre 1.750.000 che usano Smash Balloon per creare bellissimi feed per i social media

Iniziare Vedi tutte le caratteristiche
Palloncino Smash

Guida alla creazione di una ricerca personalizzata

È possibile creare una query di ricerca completamente personalizzata utilizzando il campo di immissione della ricerca personalizzata e i parametri indicati di seguito.

Come formattare una ricerca personalizzata
Per ogni parametro aggiunto, iniziare con un ampersand "&" e poi con la chiave del parametro (ad esempio, "order"), poi con un segno di uguale "=" e poi con un valore accettato (ad esempio, "date"). Non aggiungere alcuna codifica dell'URL, poiché il plugin codificherà correttamente la query di ricerca finale.

Esempi
&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

Chiave dei parametri Valori accettati
relatedToVideoId string
Il relatedToVideoId recupera un elenco di video correlati al video identificato dal valore del parametro. Il valore del parametro deve essere impostato su un ID video di YouTube.

Nota: Se il parametro relatedToVideoId è impostato, gli unici altri parametri supportati sono regionCode, relevanceLanguage, safeSearch, e fields.
channelId string
Il channelId indica che la risposta dell'API deve contenere solo risorse create dal canale.
eventType string
Il eventType limita la ricerca agli eventi di trasmissione.
I valori accettabili sono:

  • completed - Includere solo le trasmissioni completate.
  • live - Include solo le trasmissioni attive.
  • upcoming - Includere solo le trasmissioni imminenti.
location string
Il location insieme al parametro locationRadius definisce un'area geografica circolare e limita la ricerca ai video che specificano, nei loro metadati, una posizione geografica che rientra in tale area. Il valore del parametro è una stringa che specifica le coordinate di latitudine/longitudine, ad esempio (37.42307,-122.08427).

  • Il location Il valore del parametro identifica il punto al centro dell'area.
  • Il locationRadius specifica la distanza massima che la posizione associata a un video può avere da quel punto affinché il video sia ancora incluso nei risultati della ricerca.

L'API restituisce un errore se la richiesta specifica un valore per il parametro location ma non specifica anche un valore per il parametro locationRadius parametro.
locationRadius string
Il locationRadius insieme al parametro location definisce un'area geografica circolare.

Il valore del parametro deve essere un numero in virgola mobile seguito da un'unità di misura. Le unità di misura valide sono m, km, ft, e mi. Ad esempio, i valori dei parametri validi sono 1500m, 5km, 10000ft, e 0.75mi. L'API non supporta locationRadius valori dei parametri superiori a 1000 chilometri.

Nota: Si veda la definizione di location per ulteriori informazioni.
order string
Il order specifica il metodo che sarà usato per ordinare le risorse nella risposta dell'API. Il valore predefinito è relevance.

I valori accettabili sono:

  • date - Le risorse sono ordinate in ordine cronologico inverso in base alla data di creazione.
  • rating - Le risorse sono ordinate dalla valutazione più alta a quella più bassa.
  • relevance - Le risorse sono ordinate in base alla loro rilevanza rispetto alla query di ricerca. Questo è il valore predefinito per questo parametro.
  • title - Le risorse sono ordinate alfabeticamente per titolo.
  • viewCount - Le risorse sono ordinate dal numero di visualizzazioni più alto a quello più basso. Per le trasmissioni in diretta, i video sono ordinati in base al numero di spettatori contemporanei mentre le trasmissioni sono in corso.
publishedAfter datetime
Il publishedAfter indica che la risposta dell'API deve contenere solo risorse create a partire dall'ora specificata. Il valore è un valore di data e ora formattato RFC 3339 (1970-01-01T00:00:00Z).
publishedBefore datetime
Il publishedBefore indica che la risposta API deve contenere solo risorse create prima o nel momento specificato. Il valore è un valore di data e ora formattato RFC 3339 (1970-01-01T00:00:00Z).
q string
Il q specifica il termine della query da ricercare.

La richiesta può anche utilizzare l'opzione booleana NOT (-) e OR (|) per escludere i video o per trovare i video associati a uno dei termini di ricerca. Ad esempio, per cercare i video che corrispondono a "nautica" o "vela", impostare l'operatore q valore del parametro a boating|sailing. Allo stesso modo, per cercare i video che corrispondono a "nautica" o "vela" ma non a "pesca", impostare il parametro q valore del parametro a boating|sailing -fishing.
regionCode string
Il regionCode indica all'API di restituire i risultati della ricerca dei video che possono essere visualizzati nel paese specificato. Il valore del parametro è un ISO 3166-1 alpha-2 codice paese.
relevanceLanguage string
Il relevanceLanguage indica all'API di restituire i risultati della ricerca più pertinenti alla lingua specificata. Il valore del parametro è tipicamente un Codice linguistico ISO 639-1 a due lettere. Tuttavia, è necessario utilizzare i valori zh-Hans per il cinese semplificato e zh-Hant per il cinese tradizionale. Si noti che i risultati in altre lingue verranno comunque restituiti se sono altamente pertinenti al termine di ricerca.
safeSearch string
Il safeSearch indica se i risultati della ricerca devono includere contenuti limitati e contenuti standard.

I valori accettabili sono:

  • moderate - YouTube filtrerà alcuni contenuti dai risultati di ricerca e, come minimo, filtrerà i contenuti che sono limitati nella vostra zona. In base al loro contenuto, i risultati della ricerca potrebbero essere rimossi dai risultati o retrocessi nei risultati della ricerca. Questo è il valore predefinito del parametro.
  • none - YouTube non filtrerà i risultati della ricerca.
  • strict - YouTube cercherà di escludere tutti i contenuti con restrizioni dall'insieme dei risultati di ricerca. In base al loro contenuto, i risultati della ricerca potrebbero essere rimossi dai risultati o retrocessi nei risultati della ricerca.
topicId string
Il topicId indica che la risposta API deve contenere solo risorse associate all'argomento specificato. Il valore identifica un ID di argomento Freebase.

Importante: A causa della deprecazione di Freebase e dell'API di Freebase, il file topicId ha iniziato a funzionare in modo diverso a partire dal 27 febbraio 2017. A partire da quel momento, YouTube ha iniziato a supportare un piccolo gruppo di ID di argomenti curati ed è possibile utilizzare solo quel piccolo gruppo di ID come valori per questo parametro.

Argomenti
Argomenti musicali
/m/04rlf Musica (argomento principale)
/m/02mscn Musica cristiana
/m/0ggq0m Musica classica
/m/01lyv Paese
/m/02lkt Musica elettronica
/m/0glt670 Musica hip hop
/m/05rwpb Musica indipendente
/m/03_d0 Jazz
/m/028sqc Musica dell'Asia
/m/0g293 Musica dell'America Latina
/m/064t9 Musica pop
/m/06cqb Reggae
/m/06j6l Ritmo e blues
/m/06by7 Musica rock
/m/0gywn Musica soul
Argomenti di gioco
/m/0bzvm2 Gioco (argomento principale)
/m/025zzc Gioco d'azione
/m/02ntfj Gioco di azione e avventura
/m/0b1vjn Gioco casual
/m/02hygl Videogioco musicale
/m/04q1x3q Videogioco puzzle
/m/01sjng Videogioco di corse
/m/0403l3g Videogioco di ruolo
/m/021bp2 Videogioco di simulazione
/m/022dc6 Gioco sportivo
/m/03hf_rm Videogioco di strategia
Argomenti sportivi
/m/06ntj Sport (argomento per i genitori)
/m/0jm_ Calcio americano
/m/018jz Baseball
/m/018w8 Pallacanestro
/m/01cgz Pugilato
/m/09xp_ Il cricket
/m/02vx4 Calcio
/m/037hz Golf
/m/03tmr Hockey su ghiaccio
/m/01h7lh Arti marziali miste
/m/0410tth Motorsport
/m/07bs0 Tennis
/m/07_53 Pallavolo
Argomenti di intrattenimento
/m/02jjt Intrattenimento (argomento principale)
/m/09kqc Umorismo
/m/02vxn Film
/m/05qjc Arti dello spettacolo
/m/066wd Wrestling professionale
/m/0f2f9 Programmi televisivi
Temi dello stile di vita
/m/019_rr Stile di vita (argomento principale)
/m/032tl Moda
/m/027x7n Fitness
/m/02wbm Cibo
/m/03glg Hobby
/m/068hy Animali domestici
/m/041xxh Attrazione fisica [Bellezza]
/m/07c1v Tecnologia
/m/07bxq Turismo
/m/07yv9 Veicoli
Argomenti di società
/m/098wr Società (argomento principale)
/m/09s1f Affari
/m/0kt51 Salute
/m/01h6rj Militare
/m/05qt0 Politica
/m/06bvp La religione
Altri argomenti
/m/01k8wb Conoscenza

 
videoCaption string
Il videoCaption indica se l'API deve filtrare i risultati della ricerca video in base alla presenza di didascalie.

I valori accettabili sono:

  • any - Non filtrare i risultati in base alla disponibilità delle didascalie.
  • closedCaption - Includere solo i video con didascalie.
  • none - Includere solo i video privi di didascalie.
videoCategoryId string
Il videoCategoryId Il parametro filtra i risultati della ricerca video in base alla loro categoria.
videoDefinition string
Il videoDefinition consente di limitare la ricerca ai soli video ad alta definizione (HD) o a definizione standard (SD). I video HD sono disponibili per la riproduzione almeno a 720p, ma potrebbero essere disponibili anche risoluzioni più elevate, come 1080p.

I valori accettabili sono:

  • any - Restituisce tutti i video, indipendentemente dalla loro risoluzione.
  • high - Recupera solo i video HD.
  • standard - Recupera solo i video in definizione standard.
videoDimension string
Il videoDimension consente di limitare la ricerca per recuperare solo video 2D o 3D.

I valori accettabili sono:

  • 2d - Limitare i risultati della ricerca per escludere i video 3D.
  • 3d - Limitare i risultati della ricerca ai soli video 3D.
  • any - Include sia i video 3D che quelli non 3D nei risultati restituiti. Questo è il valore predefinito.
videoDuration string
Il videoDuration filtra i risultati della ricerca video in base alla loro durata.

I valori accettabili sono:

  • any - Non filtrare i risultati della ricerca video in base alla loro durata. Questo è il valore predefinito.
  • long - Includere solo video di durata superiore a 20 minuti.
  • medium - Includere solo video di durata compresa tra 4 e 20 minuti (inclusi).
  • short - Includere solo video di durata inferiore a quattro minuti.
videoEmbeddable string
Il videoEmbeddable consente di limitare la ricerca ai soli video che possono essere incorporati in una pagina web.

I valori accettabili sono:

  • any - Restituisce tutti i video, incorporabili o meno.
  • true - Recupera solo i video incorporabili.
videoLicense string
Il videoLicense filtra i risultati della ricerca per includere solo i video con una particolare licenza. YouTube consente ai caricatori di video di scegliere se allegare la licenza Creative Commons o la licenza standard di YouTube a ciascuno dei loro video.

I valori accettabili sono:

  • any - Restituisce tutti i video, indipendentemente dalla licenza, che corrispondono ai parametri della query.
  • creativeCommon - Restituisce solo i video che hanno una licenza Creative Commons. Gli utenti possono riutilizzare i video con questa licenza in altri video da loro creati. Per saperne di più.
  • youtube - Restituisce solo i video con la licenza standard di YouTube.
videoSyndicated string
Il videoSyndicated Il parametro consente di limitare la ricerca ai soli video riproducibili al di fuori di youtube.com.

I valori accettabili sono:

  • any - Restituisce tutti i video, sindacati o meno.
  • true - Recupera solo i video in syndication.
videoType string
Il videoType consente di limitare la ricerca a un particolare tipo di video.

I valori accettabili sono:

  • any - Restituire tutti i video.
  • episode - Recupera solo gli episodi degli spettacoli.
  • movie - Recupera solo i film.