Channels

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

list
Restituisce una raccolta di zero o più risorse channel che corrispondono ai criteri della richiesta. Prova subito.
Aggiorna
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,
      "moderateComments": boolean,
      "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à che vengono 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 dettagli di base sul canale, ad esempio 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. Il Centro assistenza YouTube spiega i requisiti di idoneità per ottenere un URL personalizzato e come configurarlo.
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 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 visualizzi le miniature nella tua applicazione, assicurati che il codice utilizzi esattamente gli URL dell'immagine così come vengono restituiti nelle risposte dell'API. Ad esempio, la tua applicazione non dovrebbe utilizzare il dominio http invece del dominio https in un URL restituito in una risposta API.

Gli URL delle miniature dei canali sono disponibili solo nel dominio https, ossia come vengono visualizzati gli URL nelle risposte API. Potresti visualizzare immagini non funzionanti nella tua applicazione se tenta di caricare immagini di YouTube dal dominio http. Le immagini in miniatura potrebbero essere vuote per i nuovi canali creati e il completamento dell'operazione potrebbe richiedere fino a un giorno.
snippet.thumbnails.(key) object
Le coppie chiave-valore valide sono:
  • default: l'immagine in miniatura predefinita. La miniatura predefinita di un video, o una risorsa che fa riferimento a un video, ad esempio 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 con una risoluzione più alta dell'immagine in miniatura. Per un video (o una risorsa che fa riferimento a un video), questa immagine ha una larghezza di 320 px e un'altezza di 180 px. Per un canale, questa immagine è larga 240 px e alta 240 px.
  • high: una versione ad alta risoluzione dell'immagine in miniatura. Per un video (o una risorsa che fa riferimento a un video), questa immagine ha una larghezza di 480 px e un'altezza di 360 px. Per un canale, questa immagine è larga 800 px e alta 800 px.
snippet.thumbnails.(key).url string
L'URL dell'immagine. Consulta la definizione della proprietà snippet.thumbnails per ulteriori linee guida sull'uso degli 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 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 di 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 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 è stato specificato un valore parametro hl oppure se è stato specificato un valore, ma non sono disponibili metadati localizzati 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 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 include 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 dal canale o i video che ti sono piaciuti. Puoi recuperare una di queste playlist usando il metodo playlists.list.
contentDetails.relatedPlaylists.likes string
L'ID della playlist che contiene i video che ti sono piaciuti 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 che contiene 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à video preferita. 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, di conseguenza, non può essere recuperato.
contentDetails.relatedPlaylists.uploads string
L'ID della playlist che contiene 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 include 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 è arrotondato per difetto a tre cifre significative. Consulta la Cronologia delle revisioni o il Centro assistenza YouTube per ulteriori dettagli su come viene arrotondato il numero di iscritti.
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 rispecchia il numero di 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 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à 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 periodo, YouTube ha iniziato a restituire un piccolo insieme di ID argomento selezionato.
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 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 ha uno di questi link ha già un'identità pubblica di YouTube, che è un prerequisito per diverse azioni, come il caricamento dei video.
status.longUploadsStatus string
Indica se il canale è idoneo al caricamento di 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:
  • allowed: questo canale può caricare video che durano più di 15 minuti.
  • disallowed - Questo canale non è idoneo o idoneo a caricare video con una 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 non ha blocchi di Content ID a livello mondiale per i suoi contenuti.

    Una volta che il proprietario del canale avrà risolto i problemi che impediscono il caricamento dei video più lunghi, lo stato del 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 all'indirizzo https://www.youtube.com/verify. Consulta il Centro assistenza YouTube per informazioni più dettagliate su questa funzionalità.
status.madeForKids boolean
Questo valore indica se il canale è designato come "destinato ai minori" e contiene l'attuale stato "destinato ai bambini". Ad esempio, lo stato potrebbe essere determinato in base al valore della proprietà selfDeclaredMadeForKids. Consulta il Centro assistenza YouTube per ulteriori informazioni su come impostare il pubblico per il tuo canale, i tuoi video o le tue trasmissioni.
status.selfDeclaredMadeForKids boolean
In una richiesta channels.update, questa proprietà consente al proprietario del canale di designare il canale come rivolto ai minori. Il valore della proprietà 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 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 appare nel riquadro delle informazioni del 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. Le parole chiave del canale potrebbero essere troncate se superano la lunghezza massima consentita di 500 caratteri o se contenevano virgolette non precedute da una sequenza di escape ("). Tieni presente che il limite di 500 caratteri non è un limite per parola chiave, ma un limite alla lunghezza totale di tutte le parole chiave.
brandingSettings.channel.trackingAnalyticsAccountId string
L'ID di un account Google Analytics da utilizzare per monitorare e misurare il traffico verso il tuo canale.
brandingSettings.channel.moderateComments boolean
Questa impostazione determina se i commenti inviati dagli utenti e lasciati sulla pagina del canale devono essere approvati dal proprietario del canale perché siano visibili pubblicamente. Il valore predefinito è false.
brandingSettings.channel.unsubscribedTrailer string
Il video che deve essere riprodotto nel modulo Video in primo piano nella visualizzazione Sfoglia della pagina 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 corrispondere all'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 ritirati.

L'oggetto watch include le proprietà di branding delle pagine di visualizzazione per i video del canale.
brandingSettings.watch.textColor string
Nota:questa proprietà è stata ritirata.

Il colore del testo dell'area con brand della pagina di visualizzazione del video.
brandingSettings.watch.backgroundColor string
Nota: questa proprietà è stata ritirata.

Il colore di sfondo dell'area con brand della pagina di visualizzazione del video.
brandingSettings.watch.featuredPlaylistId string
Nota: questa proprietà è stata ritirata. L'API restituisce un errore se cerchi di impostarne il valore.
brandingSettings.image object
Questa proprietà e tutte le relative proprietà secondarie sono state ritirate.

L'oggetto image include informazioni sulle immagini visualizzate 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 è 1060 x 175 px.
brandingSettings.image.bannerMobileImageUrl string
Questa proprietà è stata ritirata.

L'URL dell'immagine del banner mostrata sulla pagina del canale nelle applicazioni per dispositivi mobili. L'immagine è 640px per 175px.
brandingSettings.image.watchIconImageUrl string
Questa proprietà è stata ritirata.

L'URL dell'immagine che appare 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, al posto dell'immagine verrà visualizzato il nome del tuo canale.
brandingSettings.image.trackingImageUrl string
Questa proprietà è stata ritirata.

L'URL di un pixel di monitoraggio di 1 x 1 px utilizzabile per raccogliere statistiche sulle visualizzazioni del canale o delle pagine video.
brandingSettings.image.bannerTabletLowImageUrl string
Questa proprietà è stata ritirata.

L'URL di un'immagine banner a bassa risoluzione che viene visualizzata sulla 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 banner che viene mostrata nella pagina del canale nelle applicazioni per tablet. L'immagine è 1707 x 283 px.
brandingSettings.image.bannerTabletHdImageUrl string
Questa proprietà è stata ritirata.

L'URL di un'immagine banner ad alta risoluzione che viene visualizzata sulla 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 alta risoluzione che viene visualizzata sulla pagina del canale nelle applicazioni per tablet. Le dimensioni massime dell'immagine sono di 2560 x 424 pixel.
brandingSettings.image.bannerMobileLowImageUrl string
Questa proprietà è stata ritirata.

L'URL di un'immagine banner a bassa risoluzione che viene visualizzata sulla pagina del canale nelle applicazioni per dispositivi mobili. Le dimensioni massime dell'immagine sono di 320 x 88 px.
brandingSettings.image.bannerMobileMediumHdImageUrl string
Questa proprietà è stata ritirata.

L'URL di un'immagine banner a media risoluzione che viene visualizzata sulla pagina del canale nelle applicazioni per dispositivi mobili. 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 sulla pagina del canale nelle applicazioni per dispositivi mobili. Le dimensioni massime dell'immagine sono 1280 x 360 px.
brandingSettings.image.bannerMobileExtraHdImageUrl string
Questa proprietà è stata ritirata.

L'URL di un'immagine banner ad alta risoluzione che viene visualizzata sulla pagina del canale nelle applicazioni per dispositivi mobili. 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 alta 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 che viene 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 dell'immagine del banner per un canale.
brandingSettings.hints[] list
Questa proprietà e tutte le relative proprietà secondarie sono state ritirate.

L'oggetto hints include 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 include i dati del canale che una rete multicanale valuterebbe 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 quell'ambito deve essere revocato quando la rete multicanale 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. Attualmente, questo campo rappresenta il risultato dell'operazione logica AND nelle proprietà communityGuidelinesGoodStanding, copyrightStrikesGoodStanding e contentIdClaimsGoodStanding, il che significa che questa proprietà ha un valore true se anche tutte le altre proprietà hanno un valore true. Tuttavia, questa proprietà avrà un valore pari a false se una di queste proprietà ha un valore pari a false. Tuttavia, tieni presente 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 o meno.
auditDetails.contentIdClaimsGoodStanding boolean
Indica se il canale ha rivendicazioni irrisolte.
contentOwnerDetails object
L'oggetto contentOwnerDetails include i dati del canale pertinenti per i partner di YouTube collegati al canale.
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 include le traduzioni dei metadati del canale.
localizations.(key) object
La lingua dei metadati localizzati associati alla coppia chiave-valore. Il valore è una stringa che contiene un codice lingua BCP-47.
localizations.(key).title string
Il titolo del canale localizzato.
localizations.(key).description string
La descrizione localizzata del canale.