Implementierung: Abos

In den folgenden Beispielen wird gezeigt, wie du mit der YouTube Data API (Version 3) Funktionen im Zusammenhang mit Abos ausführen kannst.

Abos eines Kanals abrufen

Rufe die Methode subscriptions.list auf, um Abos für einen bestimmten Kanal abzurufen. Es gibt zwei Möglichkeiten, den Kanal zu identifizieren:

• Wenn du die Abos des aktuell authentifizierten Nutzers abrufen möchtest, setze den Wert des Parameters mine auf true. Eine Anfrage, die den Parameter mine verwendet, muss mit OAuth 2.0 autorisiert werden.

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

• Wenn du Abos für einen anderen Kanal abrufen möchtest, setze den Wert des Parameters 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 zugänglich macht und die Anfrage nicht vom Inhaber des Kanals autorisiert wurde.

Codebeispiele finden Sie in der Dokumentation der 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, für die die folgenden Werte festgelegt werden:

• 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, z. B. durch Aufrufen der Methode channels.list oder Abrufen von Suchergebnissen für Kanäle.

Mit der folgenden API-Anfrage kannst du den TED-Kanal auf YouTube abonnieren:

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 der 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 umfasst zwei Schritte:

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

  Rufe die Methode subscriptions.list auf, um die Liste der Abos abzurufen. Im Beispiel oben zum Abrufen der Abos eines Kanals wird erklärt, wie du eine solche Anfrage stellst.

  Die Anwendung, die die API aufruft, kann die API-Antwort verarbeiten, um eine Liste der Abos anzuzeigen, wobei die ID jedes Abos als Schlüssel verwendet wird. In der Antwort wird in der id-Eigenschaft jedes Elements die Abo-ID angegeben, mit der das entsprechende Abo eindeutig identifiziert wird. Mit diesem Wert entfernen Sie im nächsten Schritt ein Element aus der Liste.

• 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.

  Um die Anfrage im APIs Explorer abzuschließen, 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 der Methode subscriptions.delete.

Liste der Abonnenten des Kanals des autorisierten Nutzers abrufen

Wenn du eine Liste der Kanäle abrufen möchtest, die den Kanal des aktuell authentifizierten Nutzers abonniert haben, ruf die Methode subscriptions.list auf und setze den Wert des Parameters mySubscribers auf true. Die Anfrage muss mit OAuth 2.0 autorisiert sein.

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