Per maggiori dettagli, consulta 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 quali la valutazione di un video o l'aggiunta di un video ai preferiti, devi utilizzare altri metodi dell'API per generare queste risorse activity
. Ad esempio, puoi utilizzare il metodo videos.rate()
dell'API per valutare un video e il metodo playlistItems.insert()
per contrassegnare un video come preferito.
Impatto della quota: una chiamata a questo metodo ha un costo della quota di 50 unità.
Richiesta
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
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
Specifica una risorsa attività nel corpo della richiesta. Per questa risorsa:
-
Devi specificare un valore per queste proprietà:
snippet.description
-
Puoi impostare i valori per le seguenti proprietà:
snippet.description
contentDetails.bulletin.resourceId
Risposta
Se l'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 ulteriori dettagli, consulta la documentazione relativa ai 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 del bollettino. |
badRequest (400) |
invalidMetadata |
La proprietà kind non corrisponde al tipo di ID fornito. |
forbidden (403) |
forbidden |
La richiesta non è autorizzata in modo adeguato. |
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 tua quota. |