Subscriptions: insert

Fügt ein Abo für den Kanal des authentifizierten Nutzers hinzu.

Kontingentauswirkung: Ein Aufruf dieser Methode hat Kontingentkosten von 50 Einheiten.

Gängige Anwendungsfälle

Anfragen

HTTP-Anfrage

POST https://www.googleapis.com/youtube/v3/subscriptions

Autorisierung

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

Bereich
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 dient in diesem Vorgang zwei Zwecken. Er gibt die Attribute an, die vom Schreibvorgang festgelegt werden, sowie die Eigenschaften, die die API-Antwort enthalten soll.

Die folgende Liste enthält die part-Namen, die du in den Parameterwert aufnehmen kannst:
  • contentDetails
  • id
  • snippet
  • subscriberSnippet

Anfragetext

Geben Sie im Anfragetext eine Aboressource an. Für diese Ressource:

  • Sie müssen einen Wert für diese Attribute angeben:

    • snippet.resourceId

  • Sie können Werte für diese Eigenschaften festlegen:

    • snippet.resourceId

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Aboressource im Antworttext zurückgegeben.

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
badRequest (400) subscriptionDuplicate Das Abo, das Sie erstellen möchten, ist bereits vorhanden.
badRequest (400) subscriptionForbidden Du hast die maximale Anzahl an Abos erreicht.
badRequest (400) subscriptionForbidden Dein eigener Kanal kann nicht abonniert werden.
badRequest (400) subscriptionForbidden Zu viele aktuelle Abos. Bitte versuchen Sie es in ein paar Stunden noch einmal.
forbidden (403) subscriptionForbidden Die Anfrage ist nicht ordnungsgemäß authentifiziert oder wird für diesen Kanal nicht unterstützt.
notFound (404) publisherNotFound Die durch das Attribut snippet.resourceId der Anfrage angegebene Ressource wurde nicht gefunden.
notFound (404) subscriberNotFound Der mit der Anfrage angegebene Abonnent wurde nicht gefunden.
required (400) publisherRequired Die in der Anfrage angegebene Aboressource muss das Attribut snippet.resourceId verwenden, um den abonnierten Kanal zu identifizieren.

Jetzt testen

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