Subscriptions: insert

Aggiunge un abbonamento al canale dell'utente autenticato.

Impatto sulla 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 l'operazione di scrittura imposterà, nonché le proprietà che la risposta dell'API includerà.

Il seguente elenco contiene i nomi part che puoi includere nel valore del parametro:
  • contentDetails
  • id
  • snippet
  • subscriberSnippet

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 queste proprietà:

    • snippet.resourceId

Risposta

Se l'operazione ha 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 maggiori dettagli, consulta la documentazione dei messaggi di errore.

Tipo di errore Dettagli errore Descrizione
badRequest (400) subscriptionDuplicate L'abbonamento che stai tentando di creare esiste già.
badRequest (400) subscriptionForbidden Hai raggiunto il numero massimo di abbonamenti.
badRequest (400) subscriptionForbidden L'abbonamento al tuo canale non è supportato.
badRequest (400) subscriptionForbidden Troppi abbonamenti recenti. Riprova tra qualche ora.
forbidden (403) subscriptionForbidden La richiesta non è autenticata correttamente o non è supportata per questo canale.
notFound (404) publisherNotFound Non è possibile trovare la risorsa specificata dalla proprietà snippet.resourceId della richiesta.
notFound (404) subscriberNotFound Non è possibile trovare l'abbonato identificato con la richiesta.
required (400) publisherRequired La risorsa di abbonamento specificata nella richiesta deve utilizzare la proprietà snippet.resourceId per identificare il canale a cui si sta effettuando l'abbonamento.

Prova

Utilizza APIs Explorer per chiamare questa API e visualizzare la richiesta API e la risposta.