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
Risorse richieste:
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
Nella tabella seguente sono elencati i parametri supportati dalla query. Tutti i parametri elencati sono parametri di ricerca.
Parametri | ||
---|---|---|
Parametri obbligatori | ||
part |
string In questa operazione il parametro part ha due scopi. Identifica le proprietà che verranno impostate dall'operazione di scrittura e le proprietà che la risposta dell'API includerà.Il seguente elenco contiene i nomi part che puoi includere nel valore del parametro:
|
Corpo della richiesta
Fornisci una risorsa in abbonamento nel corpo della richiesta. Per la risorsa:
-
Devi specificare un valore per queste proprietà:
snippet.resourceId
-
Puoi impostare i valori delle seguenti proprietà:
snippet.resourceId
Risposta
In caso di esito positivo, questo metodo restituisce una risorsa in 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 maggiori dettagli, consulta la documentazione sui messaggi di errore.
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
badRequest (400) |
subscriptionDuplicate |
L'abbonamento che stai cercando di creare esiste già. |
badRequest (400) |
subscriptionForbidden |
Hai raggiunto il numero massimo di abbonamenti. |
badRequest (400) |
subscriptionForbidden |
L'iscrizione al tuo canale non è supportata. |
badRequest (400) |
subscriptionForbidden |
Troppi abbonamenti recenti. Riprova fra qualche ora. |
forbidden (403) |
subscriptionForbidden |
La richiesta non è stata autenticata 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 è stata effettuata l'iscrizione. |
Prova.
Usa APIs Explorer per chiamare questa API e visualizzare la richiesta e la risposta dell'API.