Diese Seite wurde von der Cloud Translation API übersetzt.

Implementierung: Abos

Die folgenden Beispiele zeigen, wie du mit der YouTube Data API (v3) Abofunktionen ausführst.

Abos eines Kanals abrufen

Mit der Methode subscriptions.list kannst du Abos für einen bestimmten Kanal abrufen. Es gibt zwei Möglichkeiten, den Kanal zu identifizieren:

Wenn Sie die Abos des aktuell authentifizierten Nutzers abrufen möchten, setzen Sie den Wert des Parameters mine auf true. Anfragen mit dem Parameter mine müssen mit OAuth 2.0 autorisiert werden.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
        part=snippet,contentDetails
        &mine=true
```
Um Abos für einen anderen Kanal abzurufen, setze den Parameter channelId auf die eindeutige YouTube-Kanal-ID dieses Kanals. Im folgenden Beispiel wird eine Liste der Kanäle abgerufen, die der TED-Kanal auf YouTube abonniert hat.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
        part=snippet,contentDetails
        &channelId=UCAuUUnT6oDeKwE6v1NGQxug
```
Hinweis: Die API gibt den HTTP-Antwortcode 403 (Forbidden) zurück, wenn der angegebene Kanal seine Abos nicht öffentlich verfügbar macht und die Anfrage nicht vom Inhaber des Kanals autorisiert wurde.

Codebeispiele finden Sie in der Dokumentation zur Methode subscriptions.list.

Abo hinzufügen

Rufe die Methode subscriptions.insert auf, um ein Kanalabo hinzuzufügen. Diese Anfrage muss mit OAuth 2.0 autorisiert werden. Der Anfragetext ist eine subscription-Ressource, die die folgenden Werte festlegt:

snippet.resourceId.kind enthält den Wert youtube#channel.
Die Property snippet.resourceId.channelId gibt den Kanal an, der abonniert wird. Der Property-Wert ist eine eindeutige YouTube-Kanal-ID. Die Kanal-ID kann auf verschiedene Arten abgerufen werden, beispielsweise durch Aufrufen der Methode channels.list oder des Abrufens der Suchergebnisse für Kanäle.

Durch die folgende API-Anfrage wird der TED-Kanal auf YouTube abonniert:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.insert?
        part=snippet

Der Anfragetext lautet:

{
  "snippet": {
    "resourceId": {
      "kind": "youtube#channel",
      "videoId": "UCAuUUnT6oDeKwE6v1NGQxug"
    }
  }
}

Codebeispiele finden Sie in der Dokumentation zur Methode subscriptions.insert.

Abos löschen

In diesem Beispiel wird ein Abo gelöscht. Diese Anfrage muss mit OAuth 2.0 autorisiert werden. Dieses Beispiel besteht aus zwei Schritten:

Schritt 1: Abos für den Kanal des authentifizierten Nutzers abrufen

Rufen Sie die Methode subscriptions.list auf, um die Liste der Abos abzurufen. Im Beispiel oben zum Abrufen der Abos eines Kanals wird erläutert, wie du diese Anfrage stellst.

Die App, die die API aufruft, könnte die API-Antwort verarbeiten, um eine Liste von Abos anzuzeigen, wobei die ID jedes Abos als Schlüssel verwendet wird. In der Antwort gibt die Eigenschaft id jedes Elements die Abo-ID an, die das entsprechende Abo eindeutig identifiziert. Damit wird im nächsten Schritt ein Element aus der Liste entfernt.
Schritt 2: Abo löschen

Rufen Sie die Methode subscriptions.delete auf, um ein Abo zu löschen. Legen Sie den Parameter id der Anfrage auf die Abo-ID des Abos fest, das Sie entfernen möchten. Diese Anfrage muss mit OAuth 2.0 autorisiert werden.

Zum Abschließen der Anfrage im APIs Explorer müssen Sie den Wert der Property id festlegen.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.delete?
        id=SUBSCRIPTION_ID
```

Codebeispiele finden Sie in der Dokumentation zur Methode subscriptions.delete.

Eine Liste von Abonnenten des Kanals des autorisierten Nutzers abrufen

Um eine Liste der Kanäle abzurufen, die den Kanal des aktuell authentifizierten Nutzers abonnieren, rufen Sie die Methode subscriptions.list auf und setzen Sie den Wert des Parameters mySubscribers auf true. Die Anfrage muss mit OAuth 2.0 autorisiert werden.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
        part=snippet,contentDetails
        &mySubscribers=true