VideoCategories: list

Gibt eine Liste der Kategorien zurück, die mit YouTube-Videos verknüpft werden können.

Auswirkungen auf Kontingente: Bei einem Aufruf dieser Methode fallen Kontingentkosten von 1 Einheit an.

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 videoCategory-Ressourcenattribute an, die die API-Antwort enthalten soll. Legen Sie den Parameterwert auf snippet fest.
Filter (genau einen der folgenden Parameter angeben)
id string
Der Parameter id gibt eine durch Kommas getrennte Liste von Videokategorie-IDs für die Ressourcen an, die Sie abrufen.
regionCode string
Der Parameter regionCode weist die API an, die 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 im Ergebnissatz abzurufen.
prevPageToken string
Das Token, das als Wert des Parameters pageToken verwendet werden kann, um die vorherige Seite im Ergebnissatz abzurufen.
pageInfo object
Das pageInfo-Objekt enthält Seiteninformationen für die Ergebnismenge.
pageInfo.totalResults integer
Die Gesamtzahl der Ergebnisse in der Ergebnismenge.
pageInfo.resultsPerPage integer
Die Anzahl der Ergebnisse, die in der API-Antwort enthalten sind.
items[] list
Eine Liste der Videokategorien, die mit YouTube-Videos verknüpft werden können. In dieser Karte ist die Videokategorie-ID der Kartenschlüssel und ihr Wert die entsprechende videoCategory-Ressource.

Fehler

In der folgenden Tabelle sind Fehlermeldungen aufgeführt, die von der API möglicherweise als Antwort auf einen Aufruf dieser Methode zurückgegeben werden. Weitere Informationen finden Sie in der Dokumentation zu Fehlermeldungen.

Fehlertyp Fehlerdetails Beschreibung
notFound (404) videoCategoryNotFound Die durch den Parameter id identifizierte Videokategorie wurde nicht gefunden. Verwenden Sie die Methode videoCategories.list, um eine Liste gültiger Werte abzurufen.

Testen!

Verwenden Sie APIs Explorer, um diese API aufzurufen und die API-Anfrage und -Antwort anzusehen.