Modifiche ai commenti nella versione precedente della YouTube Data API

Jeremy Walker, team dell'API di YouTube
settembre 2013 (aggiornato il 02/12/2013)

Introduzione

Il nuovo sistema di commenti di YouTube, lanciato a novembre 2013 e con tecnologia Google+, consente agli utenti di YouTube di recuperare molti più commenti per video rispetto a prima. Il nuovo sistema semplifica anche la ricerca di conversazioni significative, in quanto i commenti vengono ordinati in base alla pertinenza per i singoli utenti.

Sebbene i nuovi commenti non siano attualmente supportati in YouTube Data API v3, puoi continuare a utilizzare la versione precedente dell'API (v2) tenendo in considerazione alcune precisazioni descritte di seguito (e i vantaggi illustrati in precedenza).

Ti consigliamo di confermare che la tua integrazione continua a funzionare ora che siamo passati al nuovo sistema di commenti e di avvisarti se si verificano bug (problemi relativi ai file all'indirizzo youtube.com/dev). Grazie.

Domande frequenti

Che cosa è successo ai commenti pubblicati prima della transizione?

È stata eseguita la migrazione dei commenti pubblicati prima della transizione al nuovo sistema basato su Google+.

Il feed dei commenti è ancora disponibile?

Sì, ad esempio, se utilizzi l'API per recuperare i commenti per un video, ricevi un feed di commenti ordinati in base alla pertinenza, come indicato nell'annuncio.* Dal passaggio al nuovo sistema di commenti, i commenti non sono più in ordine cronologico per impostazione predefinita. Tuttavia, puoi comunque ordinare i commenti in ordine cronologico impostando il valore del parametro orderby su published nella richiesta API, come illustrato nell'esempio seguente:

https://gdata.youtube.com/feeds/api/videos/VIDEO_ID/comments?orderby=published

Ti consigliamo di seguire la best practice standard per l'utilizzo dei link next e previous nel feed dei commenti per sfogliare i commenti. In questo modo, avrai l'ulteriore vantaggio di poter sfogliare molti più commenti di prima.

Se imposti esplicitamente un valore per start-index per sfogliare le pagine del feed dei commenti (opzione non consigliata), il comportamento potrebbe essere incoerente e riceverai solo un numero limitato di commenti restituiti.

Aggiornamento (10/11/2013):

* Per impostazione predefinita, i feed dei commenti vengono ordinati in base alla pertinenza generale, non in base alla pertinenza personale. In altre parole, una richiesta di feed di commenti autenticata e una non autenticata restituirà gli stessi risultati. L'API supporta un feed dei commenti personalizzato che include post non pubblici. Per ottenere questo feed, basta eseguire una richiesta autenticata e impostare il valore del parametro relevant-to-me su true nella richiesta API, come illustrato nell'esempio seguente: 

https://gdata.youtube.com/feeds/api/videos/VIDEO_ID/comments?relevant-to-me=true

Esiste un feed che illustra il formato del nuovo feed?

Ora tutti i feed dei commenti supportano il nuovo formato. Di seguito sono riportati alcuni esempi.

  • Feed basato sulla pertinenza: 
    http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true
  • Feed basato sulla cronologia: 
    http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true&orderby=published

Posso comunque creare un commento tramite l'API?

Sì, ma per scrivere nuovi commenti con l'API v2 sono previsti diversi requisiti:

  1. L'utente autenticato deve avere un canale YouTube collegato a un account Google+ (dettagli API)
  2. La richiesta deve essere inviata tramite HTTPS (le versioni attuali delle librerie client legacy supportano questa opzione per impostazione predefinita).

Se uno di questi requisiti non è soddisfatto, l'API restituisce un errore.

I commenti forniti da Google+ offrono thread. Che cosa implica per le risposte ai commenti su YouTube?

Le risposte ai commenti precedenti alla transizione ora vengono visualizzate come commenti normali. Inoltre, le risposte dirette ai commenti tramite l'API di YouTube non sono più supportate. Al momento, non è possibile rispondere a un nuovo commento tramite l'API di YouTube.

Le risposte ai nuovi commenti di YouTube tramite le app e i siti YouTube e Google+ non vengono restituiti con il feed dei commenti dell'API precedente. Tuttavia, puoi ottenere risposte effettive tramite le API di Google+.

Se una voce del feed dei commenti di YouTube rappresenta un commento di nuovo stile, la voce contiene un tag <yt:googlePlusUserId>. Se il tag è presente e il commento ha risposte (controlla l'elemento <yt:replyCount>), puoi analizzare l'ID attività di Google+ dal tag <id> della voce. Puoi utilizzare questo ID per chiamare il metodo comments:list dell'API Google+ e recuperare un elenco di risposte recenti al commento.

L'estratto di seguito mostra come appare un ID attività Google+, in grassetto, nella voce di un feed di commenti:

<entry>
  <id>tag:youtube,2008:video:xpI6VNvRTII:comment:z13rtnibotmidjggs04cdvzgvurngv3pwnw0k</id>
  <yt:googlePlusUserId>123456789</yt:googlePlusUserId>
  <yt:replyCount>4</yt:replyCount>
  <yt:channelId>UCxxxx_xxxxx</yt:channelId>
  ...
</entry>

Che cosa succede su Google+ quando pubblico un commento tramite l'API di YouTube?

La possibilità di commentare l'API di YouTube non genera un post nel tuo stream Google+ né genera una notifica Google+.

I commenti continuano a essere visualizzati nel feed attività dopo il passaggio al nuovo sistema di commenti?

No, non adesso.

SUP nell'API precedente continua a funzionare per i commenti?

No, non per i commenti. SUP si basa sul feed attività degli utenti. Poiché i commenti non sono più nel feed attività, non vengono mostrati in SUP.