Subscriptions: insert

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

Auswirkungen auf das Kontingent:Ein Aufruf dieser Methode kostet 50 Kontingenteinheiten.

Gängige Anwendungsfälle

Anfrage

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 hat bei dieser Operation zwei Funktionen. Er gibt die Attribute an, die durch die Schreiboperation festgelegt werden, sowie die Attribute, die in der API-Antwort enthalten sein sollen.

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 Abo-Ressource an. Für diese Ressource gilt:

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

    • snippet.resourceId

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

    • snippet.resourceId

Antwort

Bei Erfolg gibt diese Methode im Antworttext eine Abo-Ressource zurück.

Fehler

In der folgenden Tabelle sind die Fehlermeldungen aufgeführt, die die API als Antwort auf einen Aufruf dieser Methode zurückgeben kann. 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 Sie haben die maximale Anzahl an Abos erreicht.
badRequest (400) subscriptionForbidden Das Abonnieren Ihres eigenen Kanals wird nicht unterstützt.
badRequest (400) subscriptionForbidden Zu viele kürzliche Abos. 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 identifizierte Abonnent wurde nicht gefunden.
required (400) publisherRequired Die in der Anfrage angegebene Abo-Ressource muss das Attribut snippet.resourceId verwenden, um den Kanal zu identifizieren, der abonniert wird.

Testen!

Mit dem APIs Explorer können Sie diese API aufrufen und die API-Anfrage und -Antwort ansehen.