Activities: insert

YouTube ha ritirato la funzionalità del bollettino 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 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:
  • contentDetails
  • id
  • snippet

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.