Per maggiori dettagli, visita il Centro assistenza YouTube.
Pubblica un bollettino per un canale specifico. (l'utente che invia la richiesta deve essere autorizzato ad agire per conto del canale).
Nota: anche se una risorsa activity
può contenere informazioni su azioni come la valutazione di un utente o la scelta di un video come preferito, per generare tali risorse devi utilizzare altri metodi API. Ad esempio, useresti il metodo videos.rate()
dell'API per classificare un video e il metodo playlistItems.insert()
per contrassegnarlo come preferito.
Impatto della quota: una chiamata a questo metodo ha un costo della quota di 50 unità.
Risorse richieste:
Richiesta HTTP
POST https://www.googleapis.com/youtube/v3/activities
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/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 attività nel corpo della richiesta. Per la risorsa:
-
Devi specificare un valore per queste proprietà:
snippet.description
-
Puoi impostare i valori delle seguenti proprietà:
snippet.description
contentDetails.bulletin.resourceId
Risposta
Se l'operazione ha esito positivo, questo metodo restituisce una risorsa attività 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) |
bulletinTextRequired |
La richiesta deve utilizzare la proprietà description dell'oggetto snippet per fornire il testo per il bollettino. |
badRequest (400) |
invalidMetadata |
La proprietà kind non corrisponde al tipo di ID fornito. |
forbidden (403) |
forbidden |
La richiesta non è autorizzata correttamente. |
notFound (404) |
playlistNotFound |
YouTube non riesce a trovare il video che stai cercando di associare al bollettino. Controlla il valore della proprietà contentDetails.bulletinPosted.playlistId . |
notFound (404) |
videoNotFound |
YouTube non riesce a trovare il video che stai cercando di associare al bollettino. Controlla il valore della proprietà contentDetails.bulletinPosted.videoId . |
userRateLimitExceeded (403) |
rateLimitExceeded |
La richiesta non può essere completata perché hai superato la quota. |