Restituisce un elenco di categorie che è possibile associare ai video di YouTube.
Impatto della quota: una chiamata a questo metodo ha un costo della quota di 1 unità.
Casi d'uso comuni
Richiesta
Richiesta HTTP
GET https://www.googleapis.com/youtube/v3/videoCategories
Parametri
La tabella seguente elenca i parametri supportati da questa query. Tutti i parametri elencati sono parametri di query.
Parametri | ||
---|---|---|
Parametri obbligatori | ||
part |
string Il parametro part specifica le proprietà della risorsa videoCategory che saranno incluse nella risposta dell'API. Imposta il valore del parametro su snippet .
|
|
Filtri (specificare esattamente uno dei seguenti parametri) | ||
id |
string Il parametro id specifica un elenco separato da virgole di ID categoria video per le risorse che stai recuperando. |
|
regionCode |
string Il parametro regionCode indica all'API di restituire l'elenco delle categorie di video disponibili nel paese specificato. Il valore del parametro è un codice paese ISO 3166-1 alpha-2. |
|
Parametri facoltativi | ||
hl |
string Il parametro hl specifica la lingua da utilizzare per i valori di testo nella risposta dell'API. Il valore predefinito è en_US . |
Corpo della richiesta
Non fornire il corpo della richiesta quando chiami questo metodo.
Risposta
Se l'esito è positivo, questo metodo restituisce un corpo della risposta con la seguente struttura:
{ "kind": "youtube#videoCategoryListResponse", "etag": etag, "nextPageToken": string, "prevPageToken": string, "pageInfo": { "totalResults": integer, "resultsPerPage": integer }, "items": [ videoCategory resource ] }
Proprietà
La tabella seguente definisce le proprietà visualizzate in questa risorsa:
Proprietà | |
---|---|
kind |
string Identifica il tipo di risorsa API. Il valore sarà youtube#videoCategoryListResponse . |
etag |
etag L'Etag di questa risorsa. |
nextPageToken |
string Il token che può essere utilizzato come valore del parametro pageToken per recuperare la pagina successiva nel set di risultati. |
prevPageToken |
string Il token che può essere utilizzato come valore del parametro pageToken per recuperare la pagina precedente nel set di risultati. |
pageInfo |
object L'oggetto pageInfo incapsula le informazioni sul paging per il set di risultati. |
pageInfo.totalResults |
integer Il numero totale di risultati nel set di risultati. |
pageInfo.resultsPerPage |
integer Il numero di risultati inclusi nella risposta dell'API. |
items[] |
list Un elenco di categorie di video che è possibile associare ai video di YouTube. In questa mappa, l'ID della categoria del video è la chiave della mappa e il suo valore è la risorsa videoCategory corrispondente. |
Errori
La tabella seguente identifica i messaggi di errore che l'API potrebbe restituire in risposta a una chiamata a questo metodo. Per ulteriori dettagli, consulta la documentazione relativa ai messaggi di errore.
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
notFound (404) |
videoCategoryNotFound |
Impossibile trovare la categoria del video identificata dal parametro id . Utilizza il metodo videoCategories.list per recuperare un elenco di valori validi. |
Prova.
Usa APIs Explorer per chiamare questa API e visualizzare la richiesta e la risposta dell'API.