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