--- title: "Item types documentation (advanced)" description: "Ogni voce restituita dall'API Content di GoodBarber è formattata secondo un tipo generico di dizionario denominato \"Item\". Le voci di tipo \"Item\" presentano c" canonical_url: "https://it.goodbarber.com/help/creare-feed-di-contenuti-personalizzati-r111/item-types-documentation-advanced-a284/" lang: it --- # Item types documentation (advanced) Source: https://it.goodbarber.com/help/creare-feed-di-contenuti-personalizzati-r111/item-types-documentation-advanced-a284/ Ogni voce restituita dall'API Content di GoodBarber è formattata secondo un tipo generico di dizionario denominato "Item". Le voci di tipo "Item" presentano chiavi comuni e chiavi aggiuntive specifiche a seconda del loro tipo e sottotipo. Nell'elenco riportato di seguito, per i tipi specifici (articoli, video, ecc.) che ereditano da "Item", vengono descritte solo le chiavi aggiuntive. ## 1. Item (comune) Tipo generico “Item”; tutti gli altri tipi ereditano da “Item”. Nome Tipo Descrizione id String Identificatore univoco dell'elemento nella sua fonte type String Tipo di elemento title String Titolo dell'elemento url String URL dell'elemento nella sua fonte categories Array of Strings Categorie associate all'elemento nella fonte date String (date) Data di pubblicazione dell'elemento author String Autore dell'elemento subtype String Sottotipo dell'elemento (descrive in genere il tipo di servizio della fonte) ## 2. Articolo Ereditato da "**Item**", può essere visualizzato nelle sezioni "**Articolo**". ***type** = article **subtype** = wordpress, typepad, wmaker, rss, etc.* Name Type Description nbComments Integer Number of comments associated with the item on its source commentsEnabled Bool Describes if the comments have to be enabled or not for this item commentsUrl String URL to access the JSON feed of comments for this item commentsPostUrl String URL that allows to post comments on this item summary String Summary of the article (no HTML, text only) content String Article content smallThumbnail String Miniatura dell'articolo (formato piccolo) thumbnail String Miniatura dell'articolo (formato medio) largeThumbnail String Miniatura dell'articolo (formato grande) images Array of Dict Elenco delle immagini contenute nell'articolo images/[]/id String Valore dell'attributo "id" dei tag nel contenuto dell'articolo images/[]/url String URL dell'immagine ## 3. Foto *Ereditato da **Item**, può essere visualizzato nelle sezioni Foto.* ***type** = foto **subtype** = flickr, facebook, wmaker, picasa, etc.* Nome Tipo Descrizione content String Descrizione della foto (solo testo, senza HTML) nbLikes Integer Numero di "Mi piace" della foto (solo se sottotipo = facebook) nbComments Integer Numero di commenti commentsEnabled Bool Indica se i commenti devono essere abilitati o meno per questo elemento commentsUrl String URL per accedere al feed JSON dei commenti relativi a questo elemento commentsPostUrl String URL che consente di pubblicare commenti su questo elemento images Dict Elenco delle diverse dimensioni disponibili per la foto images/{SIZE}/height Integer Altezza della foto images/{SIZE}/width Integer Larghezza della foto images/{SIZE}/url String URL della foto **Valori indicativi di​ {SIZE}** Valore Descrizione Valori indicativi square Formato piccolo (quadrato) 75x75 largesquare Formato medio (quadrato) 150x150 small Formato ridotto (proporzioni originali) 240x180 medium Formato medio (proporzioni originali) 320x240 large Formato grande (proporzioni originali) 640x480 ## 4. Video *Ereditato da Item, può essere visualizzato nelle sezioni Video.* ***type** = video **subtype** = youtube, dailymotion, vimeo, wmaker, facebook, etc.* Nome Tipo Descrizione nbComments Integer Numero di commenti commentsEnabled Bool Indica se i commenti devono essere abilitati o meno per questo elemento commentsUrl String URL per accedere al feed JSON dei commenti relativi a questo elemento commentsPostUrl String URL che consente di pubblicare commenti su questo articolo content String Descrizione del video summary String Sintesi del video (senza HTML, solo testo) smallThumbnail String Miniatura del video (formato piccolo) thumbnail String Miniatura del video (formato medio) largeThumbnail String Miniatura del video (formato grande) nbViews Integer Numero di visualizzazioni del video length Integer Durata del video (secondi) rating Float Valutazione media del video nbRatings Integer Numero di valutazioni del video videoUrls Dict Dizionario contenente i diversi formati della sorgente video videoUrls/{VIDEO_TYPE} String URL della risorsa video corrispondente a {VIDEO_TYPE} videoUrl String URL per guardare il video (solo se subtype = facebook) nbLikes Integer Numero di "Mi piace" del video (solo se subtype = facebook) image String URL della miniatura originale del video (solo se subtype = facebook) **Possibili chiavi per​ {VIDEO_TYPE}** Valore Descrizione Formato m3u8 URL del feed di streaming HTTP Apple HTTP Streaming mp4 URL del file MP4 MP4 embed URL che potrebbe essere indicato come fonte di un codice HTML incorporato per guardare il video HTML embed embedHTML Codice HTML completo per l'incorporamento del video HTML embed ## 5. Evento Ereditato da "Item", può essere visualizzato nelle sezioni "Evento". ***type** = evento **subtype** = facebook, google, wmaker, etc.* Nome Tipo Descrizione address String Address of the event allDay Bool Describes if the event is an "all day" event content String Event description endDate String (date) End date of the event latitude String Latitude of the event (GPS coordinates) longitude String Longitude of the event (GPS coordinates) thumbnail String Thumbnail of the event ## 6. Audio Ereditato da **Item**, può essere visualizzato nelle sezioni **Audio**. ***type** = audio **subtype** = podcast, soundcloud, etc.* Name Type Description nbComments Integer Number of comments commentsEnabled Bool Describes if the comments have to be enabled or not for this item commentsUrl String URL to access the JSON feed of comments for this item commentsPostUrl String URL that allows to post comments on this item length Integer Duration of the podcast (seconds) nbFavorites Integer Number of "favorites" by user for this song (only if subtype = soundcloud) purchaseUrl String URL to buy the song streamUrl String Stream URL for this podcast summary String Description of this podcast thumbnail String Thumbnail URL ## 7. Commento Ereditato da **Item,** può essere visualizzato nelle pagine dei **commenti**. ***type** = commento **subtype** = wordpress, wmaker, etc.* Name Type Description content String Content of the comment