ChannelSections: list

Gibt eine Liste von channelSection-Ressourcen zurück, die den API-Anfragekriterien entsprechen.

Kontingentauswirkung: Ein Aufruf dieser Methode hat Kontingentkosten von 1 Einheit.

Gängige Anwendungsfälle

Anfragen

HTTP-Anfrage

GET https://www.googleapis.com/youtube/v3/channelSections

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
Mit dem Parameter part wird eine durch Kommas getrennte Liste mit einem oder mehreren channelSection-Ressourcenattributen angegeben, die in der API-Antwort enthalten sein werden.

Bezeichnet der Parameter eine Property, die untergeordnete Properties enthält, werden die untergeordneten Attribute in die Antwort aufgenommen. Beispielsweise enthält die snippet-Eigenschaft in einer channelSection-Ressource andere Eigenschaften, z. B. einen Anzeigetitel für den Abschnitt. Wenn Sie part=snippet festlegen, enthält die API-Antwort auch alle diese verschachtelten Properties.

Die folgende Liste enthält die part-Namen, die Sie in den Parameterwert aufnehmen können:
  • contentDetails
  • id
  • snippet
Filter (geben Sie genau einen der folgenden Parameter an)
channelId string
Der Parameter channelId gibt die ID eines YouTube-Kanals an. Wenn in einer Anfrage ein Wert für diesen Parameter angegeben wird, gibt die API nur die Abschnitte des angegebenen Kanals zurück.
id string
Der Parameter id gibt eine durch Kommas getrennte Liste von IDs an, die die abzurufenden channelSection-Ressourcen eindeutig identifizieren. In einer channelSection-Ressource gibt das Attribut id die ID des Abschnitts an.
mine boolean
Dieser Parameter kann nur in einer ordnungsgemäß autorisierten Anfrage verwendet werden. Setze den Wert dieses Parameters auf true, um einen Feed der Kanalabschnitte abzurufen, die mit dem YouTube-Kanal des authentifizierten Nutzers verknüpft sind.
Optionale Parameter
hl string
Dieser Parameter wurde eingestellt. Durch den Parameter hl wurde das Abrufen lokalisierter Metadaten für einen Kanalabschnitt unterstützt. Diese Funktion wurde jedoch in YouTube Studio und in der YouTube App eingestellt.
onBehalfOfContentOwner string
Dieser Parameter kann nur in einer ordnungsgemäß autorisierten Anfrage verwendet werden. Hinweis: Dieser Parameter ist ausschließlich für YouTube-Contentpartner vorgesehen.

Der Parameter onBehalfOfContentOwner gibt an, dass durch die Autorisierungsanmeldedaten der Anfrage ein YouTube CMS-Nutzer identifiziert wird, der im Namen des im Parameterwert angegebenen Rechteinhabers handelt. Dieser Parameter ist für YouTube-Content-Partner vorgesehen, die viele verschiedene YouTube-Kanäle besitzen und verwalten. Rechteinhaber können sich nur einmal authentifizieren und auf alle ihre Video- und Kanaldaten zugreifen, ohne für jeden einzelnen Kanal Authentifizierungsdaten angeben zu müssen. Das CMS-Konto, mit dem sich der Nutzer authentifiziert, muss mit dem angegebenen YouTube-Rechteinhaber verknüpft sein.

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#channelSectionListResponse",
  "etag": etag,
  "items": [
    channelSection 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#channelSectionListResponse.
etag etag
Das ETag dieser Ressource.
items[] list
Eine Liste der ChannelSections, die den Anfragekriterien entsprechen.

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
forbidden (403) channelSectionForbidden Der Antragsteller ist nicht berechtigt, auf die angeforderten Kanalabschnitte zuzugreifen.
invalidValue (400) idInvalid Die Anfrage gibt eine ungültige Kanalabschnitts-ID an.
invalidValue (400) invalidCriteria Die Anfrage konnte nicht abgeschlossen werden, da die Filterkriterien ungültig sind.
notFound (404) channelNotFound Der mit der Anfrage verknüpfte Kanal wurde nicht gefunden.
notFound (404) channelSectionNotFound Der mit der Anfrage verknüpfte Kanalabschnitt wurde nicht gefunden.

Jetzt testen

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