Aggiunge un'iscrizione al canale dell'utente autenticato.
Impatto della quota: una chiamata a questo metodo ha un costo della quota di 50 unità.
Casi d'uso comuni
Richiesta
Richiesta HTTP
POST https://www.googleapis.com/youtube/v3/subscriptions
Autorizzazione
Questa richiesta richiede l'autorizzazione con almeno uno dei seguenti ambiti (scopri di più su autenticazione e autorizzazione).
Ambito |
---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Parametri
La tabella seguente elenca i parametri supportati da questa query. Tutti i parametri elencati sono parametri di query.
Parametri | ||
---|---|---|
Parametri obbligatori | ||
part |
string Il parametro part ha due scopi in questa operazione. Identifica le proprietà che verranno impostate dall'operazione di scrittura e quelle che saranno incluse nella risposta dell'API.Il seguente elenco contiene i nomi part che puoi includere nel valore parametro:
|
Corpo della richiesta
Fornisci una risorsa di abbonamento nel corpo della richiesta. Per questa risorsa:
-
Devi specificare un valore per queste proprietà:
snippet.resourceId
-
Puoi impostare i valori per le seguenti proprietà:
snippet.resourceId
Risposta
Se l'esito è positivo, questo metodo restituisce una risorsa di abbonamento nel corpo della risposta.
Errori
La tabella seguente identifica i messaggi di errore che l'API potrebbe restituire in risposta a una chiamata a questo metodo. Per ulteriori dettagli, consulta la documentazione relativa ai messaggi di errore.
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
badRequest (400) |
subscriptionDuplicate |
La sottoscrizione che stai cercando di creare esiste già. |
badRequest (400) |
subscriptionForbidden |
Hai raggiunto il numero massimo di iscrizioni. |
badRequest (400) |
subscriptionForbidden |
L'iscrizione al tuo canale non è supportata. |
badRequest (400) |
subscriptionForbidden |
Troppe iscrizioni recenti. Riprova fra qualche ora. |
forbidden (403) |
subscriptionForbidden |
La richiesta non è stata autenticata correttamente o non è supportata per questo canale. |
notFound (404) |
publisherNotFound |
Impossibile trovare la risorsa specificata dalla proprietà snippet.resourceId della richiesta. |
notFound (404) |
subscriberNotFound |
Impossibile trovare l'abbonato identificato con la richiesta. |
required (400) |
publisherRequired |
La risorsa di iscrizione specificata nella richiesta deve utilizzare la proprietà snippet.resourceId per identificare il canale a cui è iscritto. |
Prova.
Usa APIs Explorer per chiamare questa API e visualizzare la richiesta e la risposta dell'API.