channel e video ora contengono anche una proprietà che identifica lo stato "destinato ai bambini" del canale o del video. Anche i Termini di servizio dei servizi API di YouTube e le Norme per gli sviluppatori sono stati aggiornati il 10 gennaio 2020. 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
channelche corrispondono ai criteri della richiesta. Provalo subito. - update
- Aggiorna i metadati di un canale. Tieni presente che questo metodo attualmente supporta solo gli aggiornamenti agli oggetti
brandingSettingseinvideoPromotiondella risorsachannele alle relative proprietà secondarie. Provalo 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 |
stringIdentifica il tipo di risorsa API. Il valore sarà youtube#channel. |
etag |
etagL'ETag di questa risorsa. |
id |
stringL'ID utilizzato da YouTube per identificare in modo univoco il canale. |
snippet |
objectL'oggetto snippet contiene i dettagli di base del canale, come il titolo, la descrizione e le immagini in miniatura. |
snippet.title |
stringIl titolo del canale. |
snippet.description |
stringLa descrizione del canale. Il valore della proprietà ha una lunghezza massima di 1000 caratteri. |
snippet.customUrl |
stringL'URL personalizzato del canale. Il Centro assistenza YouTube spiega i requisiti di idoneità per ottenere un URL personalizzato e come configurarlo. |
snippet.publishedAt |
datetimeLa data e l'ora di creazione del canale. Il valore è specificato nel formato ISO 8601. |
snippet.thumbnails |
objectUna mappa di immagini in miniatura 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, 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 dei canali sono disponibili solo nel dominio https, che è il modo in cui gli URL vengono visualizzati nelle risposte dell'API. Se la tua applicazione tenta di caricare immagini di YouTube dal dominio http, potresti visualizzare immagini danneggiate. Le immagini in miniatura potrebbero essere vuote per i canali appena creati e potrebbero essere necessarie fino a 24 ore per la compilazione. |
snippet.thumbnails.(key) |
objectI valori chiave validi sono:
|
snippet.thumbnails.(key).url |
stringL'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 integerLa larghezza dell'immagine. |
snippet.thumbnails.(key).height |
unsigned integerL'altezza dell'immagine. |
snippet.defaultLanguage |
stringLa lingua del testo nelle proprietà snippet.title e snippet.description della risorsa channel. |
snippet.localized |
objectL'oggetto snippet.localized contiene un titolo e una descrizione localizzati per il canale oppure contiene il titolo e la descrizione del canale nella lingua predefinita per i metadati del canale.
localizations per aggiungere, aggiornare o eliminare i metadati localizzati. |
snippet.localized.title |
stringIl titolo del canale localizzato. |
snippet.localized.description |
stringLa descrizione localizzata del canale. |
snippet.country |
stringIl paese a cui è associato il canale. Per impostare il valore di questa proprietà, aggiorna il valore della proprietà brandingSettings.channel.country. |
contentDetails |
objectL'oggetto contentDetails contiene informazioni sui contenuti del canale. |
contentDetails.relatedPlaylists |
objectL'oggetto relatedPlaylists è una mappa che identifica le playlist associate al canale, ad esempio i video caricati o i video piaciuti del canale. Puoi recuperare una qualsiasi di queste playlist utilizzando il metodo playlists.list. |
contentDetails.relatedPlaylists.likes |
stringL'ID della playlist che contiene i video piaciuti del canale. Utilizza i metodi playlistItems.insert e playlistItems.delete per aggiungere o rimuovere elementi dall'elenco. |
contentDetails.relatedPlaylists.favorites |
stringQuesta 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 da quell'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 |
stringL'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 |
objectL'oggetto statistics incapsula le statistiche del canale. |
statistics.viewCount |
unsigned longLa somma del numero di volte in cui tutti i video in tutti i formati sono stati visualizzati per un canale. Per tutti i formati video (nel formato lungo, live e Short) di un canale, Per tutti i formati video (nel formato lungo, live e Short) di un canale, |
statistics.commentCount |
unsigned longQuesta proprietà è stata ritirata. Il numero di commenti per il canale. |
statistics.subscriberCount |
unsigned longIl numero di iscritti al canale. Questo valore viene arrotondato per difetto a tre cifre significative. Per maggiori dettagli su come vengono arrotondati i numeri di iscritti, consulta la cronologia delle revisioni o il Centro assistenza YouTube. |
statistics.videoCount |
unsigned longIl numero di video pubblici caricati sul canale. Tieni presente che il valore riflette solo il conteggio dei video pubblici del canale, anche per i proprietari. Questo comportamento è coerente con i conteggi mostrati sul sito web di YouTube. |
topicDetails |
objectL'oggetto topicDetails incapsula le informazioni sugli argomenti associati al canale.Importante: per maggiori dettagli sulle modifiche relative agli ID argomento, consulta la definizione della proprietà topicDetails.topicIds[] e la cronologia delle revisioni. |
topicDetails.topicIds[] |
listUn 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 momento, YouTube ha iniziato a restituire un piccolo insieme di ID argomento selezionati. |
topicDetails.topicCategories[] |
listUn elenco di URL di Wikipedia che descrivono i contenuti del canale. |
status |
objectL'oggetto status contiene informazioni sullo stato della privacy del canale. |
status.privacyStatus |
stringStato della privacy del canale. I valori validi per questa proprietà sono:
|
status.isLinked |
booleanIndica 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 di YouTube, che è un prerequisito per diverse azioni, come il caricamento di video. |
status.longUploadsStatus |
stringIndica 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à, consulta il Centro assistenza YouTube. I valori validi per questa proprietà sono:
|
status.madeForKids |
booleanQuesto valore indica se il canale è classificato come destinato ai bambini e contiene lo stato attuale "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 |
booleanIn una richiesta channels.update,
questa proprietà consente al proprietario del canale di designare il canale come destinato ai minori. Il valore della proprietà viene restituito solo se il proprietario del canale ha autorizzato la richiesta API.
|
brandingSettings |
objectL'oggetto brandingSettings contiene informazioni sul branding del canale. |
brandingSettings.channel |
objectL'oggetto channel incapsula le proprietà di branding della pagina del canale. |
brandingSettings.channel.title |
stringIl titolo del canale. Il titolo ha una lunghezza massima di 30 caratteri. |
brandingSettings.channel.description |
stringLa descrizione del canale, che viene visualizzata nella casella delle informazioni del canale sulla pagina del canale. Il valore della proprietà ha una lunghezza massima di 1000 caratteri. |
brandingSettings.channel.keywords |
stringParole 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 senza 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 |
stringL'ID di un account Google Analytics che vuoi utilizzare per monitorare e misurare il traffico verso il tuo canale. |
brandingSettings.channel.unsubscribedTrailer |
stringIl video che deve essere riprodotto nel modulo dei video in primo piano nella visualizzazione di navigazione 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 video di YouTube di un video pubblico o non in elenco di proprietà del proprietario del canale. |
brandingSettings.channel.defaultLanguage |
stringLa lingua del testo nelle proprietà snippet.title e snippet.description della risorsa channel. |
brandingSettings.channel.country |
stringIl paese a cui è associato il canale. Aggiorna questa proprietà per impostare il valore della proprietà snippet.country. |
brandingSettings.watch |
objectNota: questo oggetto e tutte le relative proprietà secondarie sono stati ritirati. L'oggetto watch incapsula le proprietà di branding delle pagine di visualizzazione dei video del canale. |
brandingSettings.watch.textColor |
stringNota: questa proprietà è stata ritirata. Il colore del testo per l'area con branding della pagina di visualizzazione del video. |
brandingSettings.watch.backgroundColor |
stringNota: questa proprietà è stata ritirata. Il colore di sfondo dell'area con branding della pagina di visualizzazione del video. |
brandingSettings.watch.featuredPlaylistId |
stringNota: questa proprietà è stata ritirata. L'API restituisce un errore se tenti di impostarne il valore. |
brandingSettings.image |
objectQuesta proprietà e tutte le relative proprietà secondarie sono state ritirate. L'oggetto image incapsula le informazioni sulle immagini visualizzate nella pagina del canale o nelle pagine di visualizzazione dei video del canale. |
brandingSettings.image.bannerImageUrl |
stringQuesta proprietà è stata ritirata. L'URL dell'immagine del banner mostrata nella pagina del canale sul sito web di YouTube. L'immagine è di 1060 x 175 px. |
brandingSettings.image.bannerMobileImageUrl |
stringQuesta 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 |
stringQuesta 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 tuo canale. |
brandingSettings.image.trackingImageUrl |
stringQuesta proprietà è stata ritirata. L'URL di un pixel di monitoraggio 1 x 1 che può essere utilizzato per raccogliere statistiche sulle visualizzazioni delle pagine del canale o del video. |
brandingSettings.image.bannerTabletLowImageUrl |
stringQuesta proprietà è stata ritirata. L'URL di un'immagine del banner a bassa risoluzione visualizzata nella pagina del canale nelle applicazioni per tablet. La dimensione massima dell'immagine è 1138 x 188 px. |
brandingSettings.image.bannerTabletImageUrl |
stringQuesta 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 |
stringQuesta proprietà è stata ritirata. L'URL di un'immagine del banner ad alta risoluzione visualizzata nella pagina del canale nelle applicazioni per tablet. La dimensione massima dell'immagine è 2276 x 377 px. |
brandingSettings.image.bannerTabletExtraHdImageUrl |
stringQuesta proprietà è stata ritirata. L'URL di un'immagine del banner ad altissima risoluzione visualizzata nella pagina del canale nelle applicazioni per tablet. La dimensione massima dell'immagine è 2560 x 424 px. |
brandingSettings.image.bannerMobileLowImageUrl |
stringQuesta proprietà è stata ritirata. L'URL di un'immagine del banner a bassa risoluzione visualizzata nella pagina del canale nelle applicazioni mobile. Le dimensioni massime dell'immagine sono 320 x 88 px. |
brandingSettings.image.bannerMobileMediumHdImageUrl |
stringQuesta proprietà è stata ritirata. L'URL di un'immagine del banner a risoluzione media visualizzata nella pagina del canale nelle applicazioni mobile. Le dimensioni massime dell'immagine sono 960 x 263 px. |
brandingSettings.image.bannerMobileHdImageUrl |
stringQuesta proprietà è stata ritirata. L'URL di un'immagine del banner ad alta risoluzione visualizzata nella pagina del canale nelle applicazioni mobile. Le dimensioni massime dell'immagine sono 1280 x 360 px. |
brandingSettings.image.bannerMobileExtraHdImageUrl |
stringQuesta proprietà è stata ritirata. L'URL di un'immagine del banner ad altissima risoluzione visualizzata nella pagina del canale nelle applicazioni mobile. Le dimensioni massime dell'immagine sono 1440 x 395 px. |
brandingSettings.image.bannerTvImageUrl |
stringQuesta proprietà è stata ritirata. L'URL di un'immagine del banner ad altissima risoluzione visualizzata nella pagina del canale nelle applicazioni TV. Le dimensioni massime dell'immagine sono 2120 x 1192 px. |
brandingSettings.image.bannerTvLowImageUrl |
stringQuesta proprietà è stata ritirata. L'URL di un'immagine del banner a bassa risoluzione visualizzata nella pagina del canale nelle applicazioni TV. La dimensione massima dell'immagine è 854 x 480 px. |
brandingSettings.image.bannerTvMediumImageUrl |
stringQuesta proprietà è stata ritirata. L'URL di un'immagine del banner a risoluzione media visualizzata nella pagina del canale nelle applicazioni TV. Le dimensioni massime dell'immagine sono 1280 x 720 px. |
brandingSettings.image.bannerTvHighImageUrl |
stringQuesta proprietà è stata ritirata. L'URL di un'immagine del banner ad alta risoluzione visualizzata nella pagina del canale nelle applicazioni per la TV. Le dimensioni massime dell'immagine sono 1920 x 1080 px. |
brandingSettings.image.bannerExternalUrl |
stringQuesta 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[] |
listQuesta proprietà e tutte le relative proprietà secondarie sono state ritirate. L'oggetto hints incapsula proprietà di branding aggiuntive. |
brandingSettings.hints[].property |
stringQuesta proprietà è stata ritirata. Una proprietà. |
brandingSettings.hints[].value |
stringQuesta proprietà è stata ritirata. Il valore della proprietà. |
auditDetails |
objectL'oggetto auditDetails incapsula i dati del canale che una rete multicanale (MCN) valuta per decidere 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 multicanale decide di accettare o rifiutare il canale o entro due settimane dalla data di emissione del token. |
auditDetails.overallGoodStanding |
booleanQuesto campo indica se sono presenti 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 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. Tieni presente, tuttavia, che la metodologia utilizzata per impostare il valore di questa proprietà è soggetta a modifiche. |
auditDetails.communityGuidelinesGoodStanding |
booleanIndica se il canale rispetta le Norme della community di YouTube. |
auditDetails.copyrightStrikesGoodStanding |
booleanIndica se il canale ha ricevuto avvertimenti sul copyright. |
auditDetails.contentIdClaimsGoodStanding |
booleanIndica se il canale ha rivendicazioni non risolte. |
contentOwnerDetails |
objectL'oggetto contentOwnerDetails incapsula i dati del canale visibili solo al partner di YouTube che ha collegato il canale al proprio Content Manager. |
contentOwnerDetails.contentOwner |
stringL'ID del proprietario dei contenuti collegato al canale. |
contentOwnerDetails.timeLinked |
datetimeLa data e l'ora in cui il canale è stato collegato al proprietario dei contenuti. Il valore è specificato nel formato ISO 8601. |
localizations |
objectL'oggetto localizations incapsula le traduzioni dei metadati del canale. |
localizations.(key) |
objectLa lingua dei metadati localizzati associati al valore della chiave. Il valore è una stringa che contiene un codice lingua BCP-47. |
localizations.(key).title |
stringIl titolo del canale localizzato. |
localizations.(key).description |
stringLa descrizione localizzata del canale. |