VideoCategories: list

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.