Channels

L'API ora supporta la possibilità di contrassegnare il tuo canale o i tuoi video come "destinati ai bambini". Inoltre, le risorse channel e video ora contengono anche una proprietà che identifica lo stato "destinato ai bambini" del canale o del video. Il 10 gennaio 2020 sono stati aggiornati anche i Termini di servizio dei servizi API di YouTube e le Norme per gli sviluppatori. Per ulteriori informazioni, consulta le cronologie delle revisioni del servizio API YouTube Data e dei 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

Restituisce una raccolta di zero o più risorse channel che corrispondono ai criteri di richiesta. Prova subito.

update

Aggiorna i metadati di un canale. Tieni presente che al momento questo metodo supporta solo gli aggiornamenti agli oggetti brandingSettings e invideoPromotion della risorsa channel e alle relative proprietà secondarie. Prova subito.

Rappresentazione delle risorse

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 il titolo, la descrizione e le miniature.
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 sono spiegati i requisiti di idoneità per ottenere un URL personalizzato e come configurarlo.
snippet.publishedAt	datetime La data e l'ora di creazione del canale. Il valore è specificato nel formato ISO 8601.
snippet.thumbnails	object Una mappa delle miniature associate al canale. Per ogni oggetto nella mappa, la chiave è il nome dell'immagine in miniatura e il valore è un oggetto che contiene altre informazioni sulla miniatura. Quando mostri le miniature nella tua applicazione, assicurati che il codice utilizzi gli URL delle immagini esattamente come vengono restituiti nelle risposte dell'API. Ad esempio, l'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 è la forma in cui 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 miniature potrebbero essere vuote per i canali appena creati e potrebbe essere necessario fino a un giorno per visualizzarle.
snippet.thumbnails.(key)	object I valori chiave validi sono: default: l'immagine in miniatura predefinita. La miniatura predefinita di un video o di una risorsa che rimanda a un video, ad esempio un elemento di una playlist o un risultato di ricerca, è larga 120 px e alta 90 px. La miniatura predefinita di un canale è larga 88 px e alta 88 px. medium: una versione dell'immagine in miniatura con una risoluzione più elevata. Per un video (o una risorsa che fa riferimento a un video), l'immagine deve avere una larghezza di 320 pixel e un'altezza di 180 pixel. Per un canale, l'immagine deve avere una larghezza di 240 pixel e un'altezza di 240 pixel. high: una versione ad alta risoluzione dell'immagine in miniatura. Per un video (o una risorsa che fa riferimento a un video), l'immagine deve avere una larghezza di 480 pixel e un'altezza di 360 pixel. Per un canale, l'immagine deve avere una larghezza di 800 pixel e un'altezza di 800 pixel.
snippet.thumbnails.(key).url	string L'URL dell'immagine. Per ulteriori linee guida sull'utilizzo degli URL delle miniature nella tua applicazione, consulta la definizione della proprietà snippet.thumbnails.
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 per il canale oppure il titolo e la descrizione del canale nella lingua predefinita per i metadati del canale. Il testo localizzato viene restituito nello snippet della risorsa se la richiesta channels.list ha utilizzato il parametro hl per specificare una lingua per la quale deve essere restituito il testo localizzato, il valore del parametro hl identifica una lingua dell'applicazione YouTube e il testo localizzato è disponibile in quella lingua. I metadati per la lingua predefinita vengono restituiti se non è specificato un valore del parametro hl o se è specificato un valore, ma i metadati localizzati non sono disponibili per la lingua specificata. La proprietà contiene un valore di sola lettura. Utilizza l'oggetto localizations per aggiungere, aggiornare o eliminare i metadati localizzati.
snippet.localized.title	string Il titolo del canale localizzato.
snippet.localized.description	string La descrizione del canale localizzata.
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 le informazioni sui contenuti del canale.
contentDetails.relatedPlaylists	object L'oggetto relatedPlaylists è una mappa che identifica le playlist associate al canale, ad esempio i video caricati o i video a cui è stato aggiunto un Mi piace. Puoi recuperare una di queste playlist utilizzando il metodo playlists.list.
contentDetails.relatedPlaylists.likes	string L'ID della playlist che contiene i video con Mi piace del canale. Utilizza i metodi playlistItems.insert e playlistItems.delete per aggiungere o rimuovere elementi dall'elenco.
contentDetails.relatedPlaylists.favorites	string Questa proprietà è stata ritirata. L'ID della playlist contenente i video preferiti del canale. Utilizza i metodi playlistItems.insert e playlistItems.delete per aggiungere o rimuovere elementi dall'elenco. Tieni presente che YouTube ha ritirato la funzionalità dei video preferiti. Ad esempio, la proprietà statistics.favoriteCount della risorsa video è stata ritirata il 28 agosto 2015. Di conseguenza, per motivi storici, questo valore della proprietà potrebbe contenere un ID playlist che fa riferimento a una playlist vuota e, pertanto, non può essere recuperato.
contentDetails.relatedPlaylists.uploads	string L'ID della playlist contenente i video caricati dal 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 racchiude le statistiche del 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. Per ulteriori dettagli su come vengono arrotondati i numeri di iscritti, consulta la Cronologia delle revisioni o il Centro assistenza YouTube.
statistics.hiddenSubscriberCount	boolean Indica se il numero di iscritti del canale è visibile pubblicamente.
statistics.videoCount	unsigned long Il numero di video pubblici caricati sul canale. Tieni presente che il valore riflette il conteggio solo dei video pubblici del canale, anche per i proprietari. Questo comportamento è coerente con i conteggi mostrati sul sito web di YouTube.
topicDetails	object L'oggetto topicDetails racchiude le informazioni sugli argomenti associati al canale. Importante: per ulteriori dettagli sulle modifiche relative agli ID argomento, consulta la definizione della proprietà topicDetails.topicIds[] e la cronologia delle revisioni.
topicDetails.topicIds[]	list Un elenco di ID argomento associati al canale. Questa proprietà è stata ritirata a partire dal 10 novembre 2016. Sarà supportato 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 momento, YouTube ha iniziato a restituire un piccolo insieme di ID argomento selezionati. Visualizza gli ID argomento supportati a partire dal 15 febbraio 2017 Argomenti Argomenti musicali /m/04rlf Musica (argomento principale) /m/02mscn musica cristiana /m/0ggq0m Musica classica /m/01lyv Paese /m/02lkt Musica elettronica /m/0glt670 Musica hip hop /m/05rwpb Musica indipendente /m/03_d0 Jazz /m/028sqc Musica dell'Asia /m/0g293 Musica latinoamericana /m/064t9 Musica pop /m/06cqb Reggae /m/06j6l Rhythm e Blues /m/06by7 Musica rock /m/0gywn Musica soul Argomenti relativi ai giochi /m/0bzvm2 Giochi (argomento principale) /m/025zzc Gioco d'azione /m/02ntfj Gioco di avventura e azione /m/0b1vjn Casual game /m/02hygl Videogioco musicale /m/04q1x3q Videogioco rompicapo /m/01sjng Videogioco di corse /m/0403l3g Videogioco di ruolo /m/021bp2 Videogioco di simulazione /m/022dc6 Gioco sportivo /m/03hf_rm Videogioco di strategia Argomenti sportivi /m/06ntj Sport (argomento principale) /m/0jm_ Football americano /m/018jz Baseball /m/018w8 Pallacanestro /m/01cgz Pugilato /m/09xp_ Cricket /m/02vx4 Calcio /m/037hz Golf /m/03tmr Hockey su ghiaccio /m/01h7lh Arti marziali miste /m/0410tth Sport motoristici /m/07bs0 Tennis /m/07_53 Pallavolo Argomenti di intrattenimento /m/02jjt Intrattenimento (argomento principale) /m/09kqc Umorismo /m/02vxn Film /m/05qjc Arti performative /m/066wd Wrestling professionistico /m/0f2f9 Programmi TV Argomenti di stile di vita /m/019_rr Stile di vita (argomento principale) /m/032tl Moda /m/027x7n Fitness /m/02wbm Cibo /m/03glg Hobby /m/068hy Animali domestici /m/041xxh Attrattiva fisica [Bellezza] /m/07c1v Tecnologia /m/07bxq Turismo /m/07yv9 Veicoli Argomenti sociali /m/098wr Società (argomento principale) /m/09s1f Attività commerciale /m/0kt51 Salute /m/01h6rj Forze armate /m/05qt0 Politica /m/06bvp Religione Altri argomenti /m/01k8wb Conoscenza
topicDetails.topicCategories[]	list Un elenco di URL di Wikipedia che descrivono i contenuti del canale.
status	object L'oggetto status racchiude le informazioni sullo stato della privacy del canale.
status.privacyStatus	string Stato della privacy del canale. I valori validi per questa proprietà sono: private public unlisted
status.isLinked	boolean Indica se i dati del canale identificano un utente già collegato a un nome utente di YouTube o a un account Google+. Un utente che dispone di uno di questi link ha già un'identità pubblica su YouTube, un prerequisito per diverse azioni, come il caricamento dei 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. Per saperne di più su questa funzionalità, visita il Centro assistenza YouTube. I valori validi per questa proprietà sono: allowed: questo canale può caricare video di durata superiore a 15 minuti. disallowed: questo canale non è in grado o non è idoneo a caricare video di durata superiore a 15 minuti. Un canale è idoneo a caricare video lunghi solo se ha una buona reputazione in base alle Norme della community di YouTube e se non sono presenti blocchi di Content ID a livello mondiale sui suoi contenuti. Una volta che il proprietario del canale avrà risolto i problemi che gli impediscono di caricare video più lunghi, il canale tornerà allo stato allowed o eligible. eligible: questo canale è idoneo a caricare video di durata superiore a 15 minuti. Tuttavia, il proprietario del canale deve prima attivare la possibilità di caricare video più lunghi tramite la verifica telefonica. Per ulteriori dettagli su questa funzionalità, visita il Centro assistenza YouTube.
status.madeForKids	boolean Questo valore indica se il canale è destinato ai bambini e contiene lo stato corrente "destinato ai bambini" del canale. Ad esempio, lo stato potrebbe essere determinato in base al valore della proprietà selfDeclaredMadeForKids. Per ulteriori informazioni sull'impostazione del pubblico per il tuo canale, i tuoi video o le tue trasmissioni, consulta il Centro assistenza YouTube .
status.selfDeclaredMadeForKids	boolean In una richiesta channels.update, questa proprietà consente al proprietario del canale di indicare che il canale è rivolto ai minori. Il valore della proprietà viene restituito solo se il proprietario del canale ha autorizzato la richiesta dell'API.
brandingSettings	object L'oggetto brandingSettings racchiude le informazioni sul branding del canale.
brandingSettings.channel	object L'oggetto channel racchiude le proprietà di branding della pagina del 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, che viene visualizzata nella casella delle informazioni del canale sulla tua pagina del 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. Le parole chiave del canale potrebbero essere troncate se superano la lunghezza massima consentita di 500 caratteri o se contengono virgolette non tra virgolette ("). Tieni presente che il limite di 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 che deve essere riprodotto nel modulo del video in primo piano nella visualizzazione di esplorazione della pagina del canale per gli spettatori non iscritti. Gli spettatori iscritti potrebbero vedere un video diverso che mette in evidenza l'attività più recente del canale. Se specificato, il valore della proprietà deve essere l'ID di un video di YouTube 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 sue proprietà secondarie sono stati ritirati. L'oggetto watch racchiude 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 per l'area con il brand della pagina di visualizzazione del video.
brandingSettings.watch.backgroundColor	string Nota: questa proprietà è stata ritirata. Il colore di sfondo dell'area con il brand della pagina di visualizzazione del video.
brandingSettings.watch.featuredPlaylistId	string Nota: questa proprietà è stata ritirata. L'API restituisce un errore se tenti di impostarne il valore.
brandingSettings.image	object Questa proprietà e tutte le sue proprietà secondarie sono state ritirate. L'oggetto image racchiude le informazioni sulle immagini visualizzate nella pagina del canale o nelle pagine di visualizzazione dei video.
brandingSettings.image.bannerImageUrl	string Questa proprietà è stata ritirata. L'URL dell'immagine del banner mostrata nella pagina del canale sul sito web di YouTube. L'immagine deve avere una dimensione 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 deve avere una dimensione di 640 x 175 px.
brandingSettings.image.watchIconImageUrl	string Questa proprietà è stata ritirata. L'URL dell'immagine visualizzata sopra il video player. Si tratta di un'immagine alta 25 pixel con una larghezza flessibile che non può superare i 170 pixel. Se non fornisci questa immagine, al suo posto verrà visualizzato il nome del canale.
brandingSettings.image.trackingImageUrl	string Questa proprietà è stata ritirata. L'URL di un pixel di monitoraggio di 1 x 1 pixel che può essere utilizzato per raccogliere statistiche sulle visualizzazioni delle pagine del canale o 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. La dimensione massima dell'immagine è 1138 x 188 px.
brandingSettings.image.bannerTabletImageUrl	string Questa proprietà è stata ritirata. L'URL di un'immagine banner visualizzata nella pagina del canale nelle applicazioni per tablet. L'immagine deve avere una dimensione 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. La dimensione massima dell'immagine è 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. La dimensione massima dell'immagine è 2560 x 424 px.
brandingSettings.image.bannerMobileLowImageUrl	string Questa proprietà è stata ritirata. L'URL di un'immagine banner a bassa risoluzione visualizzata nella pagina del canale nelle applicazioni mobile. La dimensione massima dell'immagine è 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 visualizzata nella pagina del canale nelle applicazioni mobile. La dimensione massima dell'immagine è 1280 x 360 px.
brandingSettings.image.bannerMobileExtraHdImageUrl	string Questa proprietà è stata ritirata. L'URL di un'immagine banner ad altissima risoluzione visualizzata nella pagina del canale nelle applicazioni mobile. La dimensione massima dell'immagine è 1440 x 395 px.
brandingSettings.image.bannerTvImageUrl	string Questa proprietà è stata ritirata. L'URL di un'immagine banner ad altissima risoluzione che viene visualizzata nella pagina del canale nelle applicazioni per la TV. La dimensione massima dell'immagine è 2120 x 1192 px.
brandingSettings.image.bannerTvLowImageUrl	string Questa proprietà è stata ritirata. L'URL di un'immagine banner a bassa risoluzione visualizzata nella pagina del canale nelle applicazioni per la TV. La dimensione massima dell'immagine è 854 x 480 px.
brandingSettings.image.bannerTvMediumImageUrl	string Questa proprietà è stata ritirata. L'URL di un'immagine banner a media risoluzione che viene visualizzata nella pagina del canale nelle applicazioni per la TV. La dimensione massima dell'immagine è 1280 x 720 pixel.
brandingSettings.image.bannerTvHighImageUrl	string Questa proprietà è stata ritirata. L'URL di un'immagine del banner ad alta risoluzione che viene visualizzata nella pagina del canale nelle applicazioni per la TV. La dimensione massima dell'immagine è 1920 x 1080 px.
brandingSettings.image.bannerExternalUrl	string Questa proprietà specifica la posizione dell'immagine del banner utilizzata da YouTube per generare le varie dimensioni dell'immagine del banner per un canale.
brandingSettings.hints[]	list Questa proprietà e tutte le sue 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 racchiude i dati del canale che una rete multicanale (MCN) 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, qualsiasi token che utilizza questo ambito deve essere revocato quando la Rete di videogiochi decide di accettare o rifiutare il canale o entro due settimane dalla data di emissione del token.
auditDetails.overallGoodStanding	boolean Questo campo indica se ci sono problemi con il canale. Al momento, questo campo rappresenta il risultato dell'operazione logica AND sulle proprietà communityGuidelinesGoodStanding, copyrightStrikesGoodStanding e contentIdClaimsGoodStanding, il che significa che questa proprietà ha un valore true se tutte le altre proprietà hanno anche un valore true. Tuttavia, questa proprietà avrà un valore false se una di queste proprietà ha un valore 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 in sospeso.
contentOwnerDetails	object L'oggetto contentOwnerDetails racchiude i dati del canale visibili solo al partner di YouTube che ha collegato il canale al proprio Content Manager.
contentOwnerDetails.contentOwner	string L'ID del proprietario di 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 racchiude le traduzioni dei metadati del canale.
localizations.(key)	object La lingua dei metadati localizzati associati al valore della chiave. 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 del canale localizzata.