L'API ora supporta la possibilità di contrassegnare il tuo canale o
video contrassegnati come "destinati ai bambini". Inoltre,
channel
e le risorse video
ora contengono anche una proprietà che identifica i contenuti "destinati ai bambini"
lo stato di quel canale o video. I Termini di servizio dei servizi API di YouTube e le Norme per gli sviluppatori
sono stati aggiornati anche il 10 gennaio 2020. Per ulteriori informazioni, consulta le cronologie delle revisioni per
il servizio API di dati di YouTube e
Termini di servizio dei servizi API di YouTube.
Una risorsa channel
contiene informazioni su un canale YouTube.
Metodi
L'API supporta i seguenti metodi per le risorse channels
:
- list
- Restituisci una raccolta di zero o più risorse
channel
che soddisfano i criteri della richiesta. Prova subito. - aggiorna
- Aggiorna i metadati di un canale. Tieni presente che questo metodo al momento supporta solo gli aggiornamenti agli oggetti
brandingSettings
einvideoPromotion
della risorsachannel
e alle relative proprietà figlio. Prova subito.
Rappresentazione della risorsa
La seguente struttura JSON mostra il formato di una risorsa channels
:
{ "kind": "youtube#channel", "etag": etag, "id": string, "snippet": { "title": string, "description": string, "customUrl": string, "publishedAt": datetime, "thumbnails": { (key): { "url": string, "width": unsigned integer, "height": unsigned integer } }, "defaultLanguage": string, "localized": { "title": string, "description": string }, "country": string }, "contentDetails": { "relatedPlaylists": { "likes": string, "favorites": string, "uploads": string } }, "statistics": { "viewCount": unsigned long, "subscriberCount": unsigned long, // this value is rounded to three significant figures "hiddenSubscriberCount": boolean, "videoCount": unsigned long }, "topicDetails": { "topicIds": [ string ], "topicCategories": [ string ] }, "status": { "privacyStatus": string, "isLinked": boolean, "longUploadsStatus": string, "madeForKids": boolean, "selfDeclaredMadeForKids": boolean }, "brandingSettings": { "channel": { "title": string, "description": string, "keywords": string, "trackingAnalyticsAccountId": string, "unsubscribedTrailer": string, "defaultLanguage": string, "country": string }, "watch": { "textColor": string, "backgroundColor": string, "featuredPlaylistId": string } }, "auditDetails": { "overallGoodStanding": boolean, "communityGuidelinesGoodStanding": boolean, "copyrightStrikesGoodStanding": boolean, "contentIdClaimsGoodStanding": boolean }, "contentOwnerDetails": { "contentOwner": string, "timeLinked": datetime }, "localizations": { (key): { "title": string, "description": string } } }
Proprietà
La tabella seguente definisce le proprietà visualizzate in questa risorsa:
Proprietà | |
---|---|
kind |
string Identifica il tipo di risorsa API. Il valore sarà youtube#channel . |
etag |
etag L'Etag di questa risorsa. |
id |
string L'ID utilizzato da YouTube per identificare in modo univoco il canale. |
snippet |
object L'oggetto snippet contiene i dettagli di base del canale, come titolo, descrizione e immagini in miniatura. |
snippet.title |
string Il titolo del canale. |
snippet.description |
string La descrizione del canale. Il valore della proprietà ha una lunghezza massima di 1000 caratteri. |
snippet.customUrl |
string L'URL personalizzato del canale. Nel Centro assistenza YouTube vengono illustrati i requisiti di idoneità necessari per ottenere un URL personalizzato e le modalità di configurazione dell'URL. |
snippet.publishedAt |
datetime La data e l'ora in cui è stato creato il canale. Il valore è specificato nel formato ISO 8601. |
snippet.thumbnails |
object Una mappa di immagini in miniatura associate al canale. Per ogni oggetto della mappa, la chiave è il nome dell'immagine in miniatura, mentre il valore è un oggetto che contiene altre informazioni sulla miniatura. Quando visualizzi le miniature nella tua applicazione, assicurati che il codice utilizzi gli URL immagine esattamente come vengono restituiti nelle risposte dell'API. Ad esempio, la tua applicazione non deve utilizzare il dominio http anziché il dominio https in un URL restituito in una risposta dell'API.Gli URL delle miniature del canale sono disponibili solo nel dominio https , che è il modo in cui gli URL vengono visualizzati nelle risposte dell'API. Potresti visualizzare immagini non valide nella tua applicazione se questa tenta di caricare le immagini di YouTube dal dominio http . Le immagini in miniatura potrebbero essere vuote per i nuovi canali e la loro compilazione potrebbe richiedere fino a un giorno. |
snippet.thumbnails.(key) |
object Le coppie chiave-valore valide sono:
|
snippet.thumbnails.(key).url |
string L'URL dell'immagine. Consulta la definizione della proprietà snippet.thumbnails per ulteriori linee guida sull'utilizzo di URL miniatura nella tua applicazione. |
snippet.thumbnails.(key).width |
unsigned integer La larghezza dell'immagine. |
snippet.thumbnails.(key).height |
unsigned integer L'altezza dell'immagine. |
snippet.defaultLanguage |
string La lingua del testo nelle proprietà snippet.title e snippet.description della risorsa channel . |
snippet.localized |
object L'oggetto snippet.localized contiene un titolo e una descrizione localizzati del canale oppure il titolo e la descrizione del canale nella lingua predefinita dei metadati del canale.
localizations per aggiungere, aggiornare o eliminare i metadati localizzati. |
snippet.localized.title |
string Il titolo del canale localizzato. |
snippet.localized.description |
string La descrizione localizzata del canale. |
snippet.country |
string Il paese a cui è associato il canale. Per impostare il valore di questa proprietà, aggiorna il valore della proprietà brandingSettings.channel.country . |
contentDetails |
object L'oggetto contentDetails racchiude informazioni sui contenuti del canale. |
contentDetails.relatedPlaylists |
object L'oggetto relatedPlaylists è una mappa che identifica le playlist associate al canale, come i video caricati sul canale o i video piaciuti. Puoi recuperare una qualsiasi di queste playlist utilizzando il metodo playlists.list . |
contentDetails.relatedPlaylists.likes |
string L'ID della playlist che contiene i video piaciuti del canale. Utilizza i metodi playlistItems.insert e playlistItems.delete per aggiungere o rimuovere articoli dall'elenco. |
contentDetails.relatedPlaylists.favorites |
string Questa proprietà è stata ritirata. L'ID della playlist che contiene i video preferiti del canale. Utilizza i metodi playlistItems.insert e playlistItems.delete per aggiungere o rimuovere articoli dall'elenco.Tieni presente che YouTube ha ritirato le funzionalità video preferite. Ad esempio, la proprietà statistics.favoriteCount della risorsa video è stata deprecata il 28 agosto 2015. Di conseguenza, per motivi storici, questo valore di proprietà potrebbe contenere un ID playlist che si riferisce a una playlist vuota e, di conseguenza, non può essere recuperato. |
contentDetails.relatedPlaylists.uploads |
string L'ID della playlist che contiene i video caricati sul canale. Utilizza il metodo videos.insert per caricare nuovi video e il metodo videos.delete per eliminare i video caricati in precedenza. |
statistics |
object L'oggetto statistics incapsula le statistiche per il canale. |
statistics.viewCount |
unsigned long Il numero di volte in cui il canale è stato visualizzato. |
statistics.commentCount |
unsigned long Questa proprietà è stata ritirata. Il numero di commenti per il canale. |
statistics.subscriberCount |
unsigned long Il numero di iscritti del canale. Questo valore viene arrotondato per difetto a tre cifre significative. Consulta le Cronologia delle revisioni o Scopri di più nel Centro assistenza YouTube i dettagli sull'arrotondamento del numero di iscritti. |
statistics.videoCount |
unsigned long Il numero di video pubblici caricati sul canale. Tieni presente che il valore riflette il conteggio solo ai video pubblici del canale, anche ai proprietari. Questo comportamento è coerente con i conteggi mostrati sul sito web di YouTube. |
topicDetails |
object L'oggetto topicDetails include informazioni sugli argomenti associati al canale.Importante:consulta la definizione della proprietà topicDetails.topicIds[] e la cronologia delle revisioni per ulteriori dettagli sulle modifiche relative agli ID argomento. |
topicDetails.topicIds[] |
list Un elenco di ID argomento associati al canale. Questa proprietà è stata ritirata il 10 novembre 2016. Sarà supportata fino al 10 novembre 2017. Importante: a causa del ritiro di Freebase e dell'API Freebase, gli ID argomento hanno iniziato a funzionare in modo diverso a partire dal 27 febbraio 2017. In quel periodo, YouTube ha iniziato a restituire un piccolo insieme di ID argomento selezionati. |
topicDetails.topicCategories[] |
list Un elenco di URL di Wikipedia che descrivono i contenuti del canale. |
status |
object L'oggetto status include informazioni sullo stato della privacy del canale. |
status.privacyStatus |
string Stato di privacy del canale. I valori validi per questa proprietà sono:
|
status.isLinked |
boolean Indica se i dati del canale identificano un utente già collegato a un nome utente YouTube o a un account Google+. Un utente che possiede uno di questi link dispone già di un'identità pubblica su YouTube, che è un prerequisito per diverse azioni, come il caricamento di video. |
status.longUploadsStatus |
string Indica se il canale è idoneo a caricare video di durata superiore a 15 minuti. Questa proprietà viene restituita solo se il proprietario del canale ha autorizzato la richiesta API. Consulta il Centro assistenza YouTube per ulteriori informazioni su questa funzionalità. I valori validi per questa proprietà sono:
|
status.madeForKids |
boolean Questo valore indica se il canale è destinato ai minori e contiene gli attuali contenuti "destinati ai bambini" stato del canale. Ad esempio, lo stato potrebbe essere determinato in base al valore della proprietà selfDeclaredMadeForKids . Consulta le
Scopri di più nel Centro assistenza YouTube
Informazioni sull'impostazione del pubblico del tuo canale, dei tuoi video o delle tue trasmissioni.
|
status.selfDeclaredMadeForKids |
boolean In una richiesta channels.update ,
questa proprietà consente al proprietario del canale di classificare il canale come destinato ai minori. La
viene restituito solo se il proprietario del canale ha autorizzato la richiesta API.
|
brandingSettings |
object L'oggetto brandingSettings include informazioni sul branding del canale. |
brandingSettings.channel |
object L'oggetto channel include le proprietà di branding della pagina canale. |
brandingSettings.channel.title |
string Il titolo del canale. Il titolo ha una lunghezza massima di 30 caratteri. |
brandingSettings.channel.description |
string La descrizione del canale, visibile nel riquadro delle informazioni sul canale sulla tua pagina canale. Il valore della proprietà ha una lunghezza massima di 1000 caratteri. |
brandingSettings.channel.keywords |
string Parole chiave associate al tuo canale. Il valore è un elenco di stringhe separate da spazi. Canale le parole chiave potrebbero essere troncate se superano la lunghezza massima consentita di 500 caratteri oppure se contengono virgolette non di escape ( " ). Tieni presente che i 500 caratteri
non è un limite per parola chiave ma piuttosto un limite alla lunghezza totale di tutte le parole chiave. |
brandingSettings.channel.trackingAnalyticsAccountId |
string L'ID di un account Google Analytics che vuoi utilizzare per monitorare e misurare il traffico verso il tuo canale. |
brandingSettings.channel.unsubscribedTrailer |
string Il video da riprodurre nel modulo Video in primo piano nella visualizzazione Sfoglia della pagina del canale per gli spettatori non iscritti. Gli spettatori iscritti potrebbero visualizzare un video diverso che mette in evidenza le attività più recenti del canale. Se specificato, il valore della proprietà deve essere l'ID video di YouTube di un video pubblico o non in elenco di proprietà del proprietario del canale. |
brandingSettings.channel.defaultLanguage |
string La lingua del testo nelle proprietà snippet.title e snippet.description della risorsa channel . |
brandingSettings.channel.country |
string Il paese a cui è associato il canale. Aggiorna questa proprietà per impostare il valore della proprietà snippet.country . |
brandingSettings.watch |
object Nota:questo oggetto e tutte le relative proprietà secondarie sono stati deprecati. L'oggetto watch include le proprietà di branding delle pagine di visualizzazione dei video del canale. |
brandingSettings.watch.textColor |
string Nota: questa proprietà è stata ritirata. Il colore del testo dell'area correlata al brand della pagina di visualizzazione del video. |
brandingSettings.watch.backgroundColor |
string Nota: questa proprietà è stata ritirata. Il colore di sfondo dell'area brandizzata della pagina di visualizzazione del video. |
brandingSettings.watch.featuredPlaylistId |
string Nota: questa proprietà è stata ritirata. L'API restituisce un errore se cerchi di impostare il relativo valore. |
brandingSettings.image |
object Questa proprietà e tutte le relative proprietà secondarie sono state ritirate. L'oggetto image racchiude informazioni sulle immagini mostrate nella pagina del canale o nelle pagine di visualizzazione dei video del canale. |
brandingSettings.image.bannerImageUrl |
string Questa proprietà è stata ritirata. L'URL dell'immagine del banner mostrata sulla pagina del canale sul sito web di YouTube. L'immagine è di 1060 x 175 px. |
brandingSettings.image.bannerMobileImageUrl |
string Questa proprietà è stata ritirata. L'URL dell'immagine del banner mostrata nella pagina del canale nelle applicazioni mobile. L'immagine è di 640 x 175 px. |
brandingSettings.image.watchIconImageUrl |
string Questa proprietà è stata ritirata. L'URL dell'immagine visualizzata sopra il video player. Questa è un'immagine alta 25 pixel con una larghezza flessibile che non può superare i 170 pixel. Se non fornisci questa immagine, verrà visualizzato il nome del tuo canale al posto dell'immagine. |
brandingSettings.image.trackingImageUrl |
string Questa proprietà è stata ritirata. L'URL di un pixel di monitoraggio di 1 x 1 px che può essere utilizzato per raccogliere statistiche sulle visualizzazioni del canale o delle pagine dei video. |
brandingSettings.image.bannerTabletLowImageUrl |
string Questa proprietà è stata ritirata. L'URL di un'immagine del banner a bassa risoluzione che viene visualizzata nella pagina del canale nelle applicazioni per tablet. Le dimensioni massime dell'immagine sono 1138 x 188 px. |
brandingSettings.image.bannerTabletImageUrl |
string Questa proprietà è stata ritirata. L'URL di un'immagine del banner visualizzata nella pagina del canale nelle applicazioni per tablet. L'immagine è di 1707 x 283 px. |
brandingSettings.image.bannerTabletHdImageUrl |
string Questa proprietà è stata ritirata. L'URL di un'immagine banner ad alta risoluzione che viene visualizzata nella pagina del canale nelle applicazioni per tablet. Le dimensioni massime dell'immagine sono 2276 x 377 px. |
brandingSettings.image.bannerTabletExtraHdImageUrl |
string Questa proprietà è stata ritirata. L'URL di un'immagine banner ad altissima risoluzione che viene visualizzata nella pagina del canale nelle applicazioni per tablet. Le dimensioni massime dell'immagine sono 2560 x 424 px. |
brandingSettings.image.bannerMobileLowImageUrl |
string Questa proprietà è stata ritirata. L'URL di un'immagine del banner a bassa risoluzione che viene visualizzata nella pagina del canale nelle applicazioni mobile. Le dimensioni massime dell'immagine sono 320 x 88 px. |
brandingSettings.image.bannerMobileMediumHdImageUrl |
string Questa proprietà è stata ritirata. L'URL di un'immagine banner a media risoluzione che viene visualizzata nella pagina del canale nelle applicazioni mobile. Le dimensioni massime dell'immagine sono 960 x 263 px. |
brandingSettings.image.bannerMobileHdImageUrl |
string Questa proprietà è stata ritirata. L'URL di un'immagine banner ad alta risoluzione che viene visualizzata nella pagina del canale nelle applicazioni mobile. Le dimensioni massime dell'immagine sono 1280 x 360 px. |
brandingSettings.image.bannerMobileExtraHdImageUrl |
string Questa proprietà è stata ritirata. L'URL di un'immagine del banner ad altissima risoluzione che viene visualizzata nella pagina del canale nelle applicazioni mobile. Le dimensioni massime dell'immagine sono 1440 x 395 px. |
brandingSettings.image.bannerTvImageUrl |
string Questa proprietà è stata ritirata. L'URL di un'immagine banner ad altissima risoluzione che viene visualizzata sulla pagina del canale nelle applicazioni televisive. Le dimensioni massime dell'immagine sono 2120 x 1192 px. |
brandingSettings.image.bannerTvLowImageUrl |
string Questa proprietà è stata ritirata. L'URL di un'immagine banner a bassa risoluzione che viene visualizzata sulla pagina del canale nelle applicazioni televisive. Le dimensioni massime dell'immagine sono 854 x 480 px. |
brandingSettings.image.bannerTvMediumImageUrl |
string Questa proprietà è stata ritirata. L'URL di un'immagine banner a media risoluzione visualizzata sulla pagina del canale nelle applicazioni televisive. Le dimensioni massime dell'immagine sono 1280 x 720 px. |
brandingSettings.image.bannerTvHighImageUrl |
string Questa proprietà è stata ritirata. L'URL di un'immagine banner ad alta risoluzione che viene visualizzata sulla pagina del canale nelle applicazioni televisive. Le dimensioni massime dell'immagine sono 1920 x 1080 px. |
brandingSettings.image.bannerExternalUrl |
string Questa proprietà specifica la posizione dell'immagine del banner che YouTube utilizza per generare le varie dimensioni delle immagini banner di un canale. |
brandingSettings.hints[] |
list Questa proprietà e tutte le relative proprietà secondarie sono state ritirate. L'oggetto hints incapsula proprietà di branding aggiuntive. |
brandingSettings.hints[].property |
string Questa proprietà è stata ritirata. Una proprietà. |
brandingSettings.hints[].value |
string Questa proprietà è stata ritirata. Il valore della proprietà. |
auditDetails |
object L'oggetto auditDetails incapsula i dati di un canale che una rete multicanale valuta per determinare se accettare o rifiutare un determinato canale. Tieni presente che qualsiasi richiesta API che recupera questa parte della risorsa deve fornire un token di autorizzazione contenente l'ambito https://www.googleapis.com/auth/youtubepartner-channel-audit . Inoltre, i token che utilizzano questo ambito devono essere revocati quando la rete multicanale decide di accettare o rifiutare il canale oppure entro due settimane dalla data di emissione. |
auditDetails.overallGoodStanding |
boolean Questo campo indica se ci sono problemi con il canale. Attualmente, questo campo rappresenta il risultato dell'operazione logica AND sulle proprietà communityGuidelinesGoodStanding , copyrightStrikesGoodStanding e contentIdClaimsGoodStanding , il che significa che questa proprietà ha il valore true se anche tutte le altre proprietà hanno il valore true . Tuttavia, questa proprietà avrà il valore false se una di queste proprietà ha un valore pari a false . Tieni presente, tuttavia, che la metodologia utilizzata per impostare il valore di questa proprietà è soggetta a modifiche. |
auditDetails.communityGuidelinesGoodStanding |
boolean Indica se il canale rispetta le Norme della community di YouTube. |
auditDetails.copyrightStrikesGoodStanding |
boolean Indica se il canale ha ricevuto avvertimenti sul copyright. |
auditDetails.contentIdClaimsGoodStanding |
boolean Indica se il canale ha rivendicazioni irrisolte. |
contentOwnerDetails |
object L'oggetto contentOwnerDetails racchiude i dati del canale che sono visibili solo al partner di YouTube che ha collegato il canale al suo Content Manager. |
contentOwnerDetails.contentOwner |
string L'ID del proprietario dei contenuti collegato al canale. |
contentOwnerDetails.timeLinked |
datetime La data e l'ora in cui il canale è stato collegato al proprietario dei contenuti. Il valore è specificato nel formato ISO 8601. |
localizations |
object L'oggetto localizations incapsula le traduzioni dei metadati del canale. |
localizations.(key) |
object La lingua dei metadati localizzati associati alla coppia chiave-valore. Il valore è una stringa contenente un codice lingua BCP-47. |
localizations.(key).title |
string Il titolo del canale localizzato. |
localizations.(key).description |
string La descrizione localizzata del canale. |