Gibt eine Liste von Kategorien zurück, die YouTube-Videos zugeordnet werden können.
Kontingentauswirkung: Ein Aufruf dieser Methode hat Kontingentkosten von 1 Einheit.
Gängige Anwendungsfälle
Anfragen
HTTP-Anfrage
GET https://www.googleapis.com/youtube/v3/videoCategories
Parameter
In der folgenden Tabelle sind die Parameter aufgeführt, die von dieser Abfrage unterstützt werden. Alle aufgeführten Parameter sind Abfrageparameter.
Parameter | ||
---|---|---|
Erforderliche Parameter | ||
part |
string Der Parameter part gibt die Attribute der videoCategory -Ressource an, die die API-Antwort enthalten soll. Legen Sie den Parameterwert auf snippet fest.
|
|
Filter (geben Sie genau einen der folgenden Parameter an) | ||
id |
string Mit dem Parameter id wird eine durch Kommas getrennte Liste von Videokategorie-IDs für die abgerufenen Ressourcen angegeben. |
|
regionCode |
string Mit dem Parameter regionCode wird die API angewiesen, eine Liste der im angegebenen Land verfügbaren Videokategorien zurückzugeben. Der Parameterwert ist ein ISO 3166-1 alpha-2-Ländercode. |
|
Optionale Parameter | ||
hl |
string Der Parameter hl gibt die Sprache an, die für Textwerte in der API-Antwort verwendet werden soll. Der Standardwert ist en_US . |
Anfragetext
Geben Sie beim Aufrufen dieser Methode keinen Anfragetext an.
Antwort
Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:
{ "kind": "youtube#videoCategoryListResponse", "etag": etag, "nextPageToken": string, "prevPageToken": string, "pageInfo": { "totalResults": integer, "resultsPerPage": integer }, "items": [ videoCategory resource ] }
Attribute
In der folgenden Tabelle werden die Attribute definiert, die in dieser Ressource angezeigt werden:
Attribute | |
---|---|
kind |
string Identifiziert den Typ der API-Ressource. Der Wert ist youtube#videoCategoryListResponse . |
etag |
etag Das ETag dieser Ressource. |
nextPageToken |
string Das Token, das als Wert des Parameters pageToken verwendet werden kann, um die nächste Seite in der Ergebnismenge abzurufen. |
prevPageToken |
string Das Token, das als Wert des Parameters pageToken verwendet werden kann, um die vorherige Seite in der Ergebnismenge abzurufen. |
pageInfo |
object Das Objekt pageInfo enthält Seiteninformationen für den Ergebnissatz. |
pageInfo.totalResults |
integer Die Gesamtzahl der Ergebnisse im Ergebnissatz. |
pageInfo.resultsPerPage |
integer Die Anzahl der Ergebnisse, die in der API-Antwort enthalten sind. |
items[] |
list Eine Liste von Videokategorien, die mit YouTube-Videos verknüpft werden können. In dieser Zuordnung ist die Videokategorie-ID der Zuordnungsschlüssel und ihr Wert ist die entsprechende videoCategory -Ressource. |
Fehler
In der folgenden Tabelle finden Sie Fehlermeldungen, die die API als Antwort auf einen Aufruf dieser Methode zurückgeben könnte. Weitere Informationen finden Sie in der Dokumentation zu Fehlermeldungen.
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
notFound (404) |
videoCategoryNotFound |
Die durch den Parameter id angegebene Videokategorie wurde nicht gefunden. Verwenden Sie die Methode videoCategories.list, um eine Liste gültiger Werte abzurufen. |
Jetzt testen
Verwenden Sie APIs Explorer, um diese API aufzurufen und die API-Anfrage und -Antwort anzusehen.