Diese Seite wurde von der Cloud Translation API übersetzt.

PlaylistImages: list

Gibt eine Sammlung von Playlist-Bildern zurück, die den API-Anfrageparametern entsprechen. Du kannst das Playlist-Bild einer bestimmten Playlist oder ein oder mehrere Playlist-Bilder anhand ihrer eindeutigen ID abrufen.

Auswirkungen auf das Kontingent:Ein Aufruf dieser Methode hat Kontingentkosten von 1 Einheit.

Anfrage

HTTP-Anfrage

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

Autorisierung

Diese Anfrage benötigt eine Autorisierung mit mindestens einem der folgenden Bereiche (weitere Informationen zu Authentifizierung und Autorisierung).

Umfang
`https://www.googleapis.com/auth/youtubepartner`
`https://www.googleapis.com/auth/youtube`
`https://www.googleapis.com/auth/youtube.force-ssl`

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 eine durch Kommas getrennte Liste mit einer oder mehreren `playlistImage`-Ressourcen die die API-Antwort enthält. Wenn der Parameter bezeichnet eine Property, die untergeordnete Properties enthält, die untergeordneten Properties in der Antwort enthalten sein.
Filter (bitte genau einen der folgenden Parameter angeben)
`id`	`string` Der Parameter `id` gibt eine durch Kommas getrennte Liste einer oder mehrerer eindeutiger IDs von Playlist-Images an.
`playlistId`	`string` Der `playlistId`-Parameter gibt die eindeutige ID der Playlist an, für die du Playlist-Bilder abrufen möchtest. Auch wenn dies ein optionaler Parameter ist, muss bei jeder Anfrage zum Abrufen von Playlist-Bildern ein Wert für den Parameter `id` oder `playlistId` angegeben werden.
Optionale Parameter
`maxResults`	`unsigned integer` Der Parameter `maxResults` gibt die maximale Anzahl von Bildern an, die im Ergebnissatz zurückgegeben werden sollen. Zulässige Werte sind `0` bis `50` (einschließlich). Der Standardwert ist `5`.
`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 die Anmeldedaten für die Autorisierung einen YouTube CMS-Nutzer identifizieren, 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 erhalten Zugriff auf alle ihre Video- und Kanaldaten, ohne dass sie für jeden einzelnen Kanal Anmeldedaten zur Authentifizierung angeben müssen. Das CMS-Konto, mit dem sich der Nutzer authentifiziert, muss mit dem angegebenen YouTube-Rechteinhaber verknüpft sein.
`onBehalfOfContentOwnerChannel`	`string` Dieser Parameter kann nur in einer ordnungsgemäß autorisierten Anfrage verwendet werden. Hinweis: Dieser Parameter ist ausschließlich für YouTube-Inhaltspartner vorgesehen. Die `onBehalfOfContentOwnerChannel`-Parameter gibt die YouTube-Kanal-ID des Kanals an, auf dem ein Video wiedergegeben wird. hinzugefügt. Dieser Parameter ist erforderlich, wenn in einer Anfrage ein Wert für die Methode `onBehalfOfContentOwner`-Parameter und kann nur in in Verbindung mit diesem Parameter. Außerdem muss der Antrag die über ein CMS-Konto autorisiert wurden, das mit dem Rechteinhaber verknüpft ist, wird durch den Parameter `onBehalfOfContentOwner` angegeben. Die Funktion Kanal, den der Wert des Parameters `onBehalfOfContentOwnerChannel` mit dem Rechteinhaber verknüpft sein muss, wird durch den Parameter `onBehalfOfContentOwner` angegeben. Dies ist für YouTube-Content-Partner vorgesehen, die viele verschiedenen YouTube-Kanälen. Rechteinhaber können sich einmalig authentifizieren. und Aktionen für den im Parameter angegebenen Kanal ausführen. ohne Anmeldedaten für die Authentifizierung angeben zu müssen, einen separaten Kanal.
`pageToken`	`string` Der `pageToken`-Parameter gibt eine bestimmte Seite in der Ergebnismenge an, die zurückgegeben werden soll. In einer API-Antwort geben die Eigenschaften `nextPageToken` und `prevPageToken` andere Seiten an, die abgerufen werden können.

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#playlistImageListResponse",
          "nextPageToken": string,
          "prevPageToken": string,
          "pageInfo": {
            "totalResults": integer,
            "resultsPerPage": integer
          },
          "items": [
            playlistImages 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#playlistImageListResponse`.
`nextPageToken`	`string` Das Token, das als Wert des `pageToken`-Parameters verwendet werden kann, um die nächste Seite im Ergebnissatz abzurufen.
`prevPageToken`	`string` Das Token, das als Wert des `pageToken`-Parameters verwendet werden kann, um die vorherige Seite im Ergebnissatz abzurufen.
`pageInfo`	`object` Das Objekt `pageInfo` kapselt Seiteninformationen für die Ergebnismenge.
`pageInfo.totalResults`	`integer` Die Gesamtzahl der Ergebnisse in der Ergebnismenge.
`pageInfo.resultsPerPage`	`integer` Die Anzahl der in der API-Antwort enthaltenen Ergebnisse.
`items[]`	`list` Eine Liste mit Playlist-Bildern, die den Anfragekriterien entsprechen.