Subscriptions: insert

Fügt dem Kanal des authentifizierten Nutzers ein Abo hinzu.

Auswirkungen auf Kontingente: Bei einem Aufruf dieser Methode fallen Kontingentkosten von 50 Einheiten an.

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

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 dient in diesem Vorgang zwei Zwecken. Damit werden die Attribute festgelegt, die der Schreibvorgang festlegt, sowie die Attribute, die in der API-Antwort enthalten sind.

Die folgende Liste enthält die part-Namen, die Sie in den Parameterwert aufnehmen können:
  • contentDetails
  • id
  • snippet
  • subscriberSnippet

Anfragetext

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

  • Für diese Eigenschaften müssen Sie einen Wert angeben:

    • snippet.resourceId

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

    • snippet.resourceId

Antwort

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

Fehler

In der folgenden Tabelle sind Fehlermeldungen aufgeführt, die von der API möglicherweise als Antwort auf einen Aufruf dieser Methode zurückgegeben werden. 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 von Abos erreicht.
badRequest (400) subscriptionForbidden Das Abonnieren deines eigenen Kanals wird nicht unterstützt.
badRequest (400) subscriptionForbidden Zu viele aktuelle Abos. Bitte versuchen Sie es in ein paar Stunden noch einmal.
forbidden (403) subscriptionForbidden Die Anfrage ist für diesen Kanal nicht richtig authentifiziert oder wird nicht unterstützt.
notFound (404) publisherNotFound Die von der Eigenschaft snippet.resourceId der Anfrage angegebene Ressource wurde nicht gefunden.
notFound (404) subscriberNotFound Der in der Anfrage angegebene Abonnent wurde nicht gefunden.
required (400) publisherRequired Die in der Anfrage angegebene Aboressource muss die Property snippet.resourceId verwenden, um den abonnierten Kanal zu identifizieren.

Testen!

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