Activities: insert

YouTube ha ritirato la funzionalità dei bollettini del canale e questo metodo non è più supportato.

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 come la valutazione di un video o la sua aggiunta ai preferiti da parte di un utente, devi utilizzare altri metodi API per generare queste risorse activity. Ad esempio, utilizzeresti il metodo videos.rate() dell'API per valutare un video e il metodo playlistItems.insert() per contrassegnare un video come preferito.

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

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

Corpo della richiesta

Fornisci una risorsa attività nel corpo della richiesta. Per quella risorsa:

  • Devi specificare un valore per queste proprietà:

    • snippet.description

  • Puoi impostare i valori per queste proprietà:

    • snippet.description
    • contentDetails.bulletin.resourceId

Risposta

In caso di esito positivo, questo metodo restituisce una risorsa attività nel corpo della risposta.

Errori

La seguente tabella 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 al messaggio di errore.

Tipo di errore Dettaglio errore Descrizione
badRequest (400) bulletinTextRequired La richiesta deve utilizzare la proprietà description dell'oggetto snippet per fornire il testo del post del 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 post del 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 post del bollettino. Controlla il valore della proprietà contentDetails.bulletinPosted.videoId.
userRateLimitExceeded (403) rateLimitExceeded La richiesta non può essere completata perché hai superato la quota.