Gibt eine Liste von Kategorien zurück, die mit YouTube-Videos verknüpft werden können.
Auswirkungen auf das Kontingent:Ein Aufruf dieser Methode kostet 1 Kontingenteinheit.
Gängige Anwendungsfälle
Anfrage
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 |
stringMit dem Parameter part werden die Eigenschaften der Ressource videoCategory angegeben, die in der API-Antwort enthalten sein sollen. Legen Sie den Parameterwert auf snippet fest.
|
|
| Filter (genau einen der folgenden Parameter angeben) | ||
id |
stringMit dem Parameter id wird eine durch Kommas getrennte Liste von Video-Kategorie-IDs für die abzurufenden Ressourcen angegeben. |
|
regionCode |
stringMit dem Parameter regionCode wird die API angewiesen, die Liste der Videokategorien zurückzugeben, die im angegebenen Land verfügbar sind. Der Parameterwert ist ein ISO 3166-1 Alpha-2 Ländercode. |
|
| Optionale Parameter | ||
hl |
stringMit dem Parameter hl wird die Sprache angegeben, 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 sind die Attribute definiert, die in dieser Ressource enthalten sind:
| Attribute | |
|---|---|
kind |
stringGibt den Typ der API-Ressource an. Der Wert ist youtube#videoCategoryListResponse. |
etag |
etagDas ETag dieser Ressource. |
nextPageToken |
stringDas Token, das als Wert des Parameters pageToken verwendet werden kann, um die nächste Seite in der Ergebnismenge abzurufen. |
prevPageToken |
stringDas Token, das als Wert des Parameters pageToken verwendet werden kann, um die vorherige Seite in der Ergebnismenge abzurufen. |
pageInfo |
objectDas Objekt pageInfo enthält Paging-Informationen für die Ergebnismenge. |
pageInfo.totalResults |
integerDie Gesamtzahl der Ergebnisse in der Ergebnismenge. |
pageInfo.resultsPerPage |
integerDie Anzahl der Ergebnisse, die in der API-Antwort enthalten sind. |
items[] |
listEine Liste von Videokategorien, die mit YouTube-Videos verknüpft werden können. In dieser Zuordnung ist die Video-Kategorie-ID der Zuordnungsschlüssel und der Wert ist die entsprechende Ressource videoCategory. |
Fehler
In der folgenden Tabelle sind die Fehlermeldungen aufgeführt, die die API als Antwort auf einen Aufruf dieser Methode zurückgeben kann. 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. |
Testen!
Mit dem APIs Explorer können Sie diese API aufrufen und die API-Anfrage und -Antwort ansehen.