Aggiorna dashboard

Versione 3.1.23.6

Aggiorna una dashboard

Puoi utilizzare questa funzione per modificare le proprietà stringa e intero di una dashboard. Gli oggetti nidificati come filtri, elementi della dashboard o componenti del layout della dashboard non possono essere modificati da questa funzione. Utilizza le funzioni di aggiornamento per i rispettivi tipi di oggetti nidificati (ad esempio update_dashboard_filter() per modificare un filtro) per modificare gli oggetti nidificati a cui fa riferimento una dashboard.

Se ricevi una risposta di errore 422 durante l'aggiornamento di una dashboard, assicurati di controllare il corpo della risposta per informazioni su quali campi mancano o contengono dati non validi.

Richiesta

PATCH /dashboards/{dashboard_id}
Tipo di dati
Descrizione
Richiesta
HTTPRequest
percorso
Percorso HTTP
Espandi definizione HTTPPath...
ID_dashboard
string
ID della dashboard
body
HTTPBody
Espandi definizione HTTPBody...
body
Dashboard
Espandi definizione dashboard...
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
id_preferito_contenuti
integer
ID contenuti preferiti
id_metadati_contenuti
integer
ID dei metadati dei contenuti
description
string
Descrizione
nascosto
boolean
È nascosta
id
string
ID univoco
modello
Modello
fuso orario query
string
Fuso orario in cui verrà eseguita la dashboard per impostazione predefinita.
sola lettura
boolean
Sola lettura
aggiornamento_intervallo
string
Aggiorna intervallo, come frase relativa alla durata, come "2 ore e 30 minuti". Un numero senza unità di tempo verrà interpretato come secondi interi.
aggiornamento_intervallo_a_i
integer
Intervallo di aggiornamento in millisecondi
cartella
Cartella
title
string
Titolo dashboard
ID_utente
integer
ID dell'utente
lumaca
string
Lumaca metadati contenuti
visualizzatore_preferito
string
Il percorso preferito per visualizzare questa dashboard (ad es. dashboard o dashboard successive)
spazio
Spazio
avvisi_sincronizzazione_con_filtro_dashboard
boolean
Consente agli avvisi di rimanere sincronizzati con le modifiche ai filtri della dashboard
colore_sfondo
string
Colore sfondo
creata_alle
string
L'ora in cui è stata creata la dashboard.
crossfilter_enabled
boolean
Attiva il filtro incrociato nelle dashboard (disponibile solo nelle dashboard successive) (beta)
elementi_dashboard
filtri_dashboard
layout_dashboard
ha eliminato
boolean
Indica se una dashboard è stata eliminata o meno.
eliminato_in
string
L'ora in cui la dashboard è stata sottoposta a soft
id_eliminatore
integer
ID dell'utente che ha impostato "soft" la dashboard.
uri_modifica
string
Percorso relativo dell'URI del file LookML per modificare la dashboard (solo dashboard LookML).
abilita_schermo_intero_viz
boolean
Consenti la visualizzazione delle visualizzazioni in modalità a schermo intero
numero_preferiti
integer
Numero di preferiti
filtri_bar_compresso
boolean
Consente di impostare lo stato predefinito della barra dei filtri su compressa o aperta
filtri_località_top
boolean
Imposta lo stato predefinito della posizione dei filtri su top(true) o Right(false)
ultimo_accesso
string
Ora dell'ultimo accesso alla dashboard
ultimo_visualizzato_a
string
Ultima visualizzazione nell'interfaccia utente web di Looker
aggiornato_in
string
Ora dell'ultimo aggiornamento della dashboard.
ultimo_aggiornamento_id
integer
ID dell'utente che ha aggiornato la dashboard più di recente.
ultimo_aggiornamento_nome
string
Nome dell'utente che ha aggiornato la dashboard più di recente.
nome_utente
string
Nome dell'utente che ha creato la dashboard.
configurazione_del_carico
string
un'opzione di configurazione che regola il modo in cui viene eseguito il caricamento della dashboard.
look_link_id
string
Collega questa dashboard a una dashboard LookML specifica, in modo che le chiamate a un'operazione di **sincronizzazione** su quella dashboard LookML aggiornano questa dashboard in modo che corrisponda.
barra_filtri_mostra
boolean
Mostra barra dei filtri. **Nota di sicurezza:** questa proprietà influisce solo sull'aspetto *cosmetico* della dashboard, non sulla capacità di un utente di accedere ai dati. Nascondere la barra dei filtri **NON** impedisce agli utenti di modificare i filtri con altri mezzi. Per informazioni su come configurare i criteri di controllo sicuri dell'accesso ai dati, vedi [Controllare l'accesso degli utenti ai dati](https://cloud.google.com/looker/docs/r/api/control-access)
titolo_programma
boolean
Mostra titolo
spazio_id
string
ID dello spazio
cartella_id
string
ID della cartella
testo_piastrella_testo
string
Colore del testo nei riquadri di testo
colore_sfondo_piastrelle
string
Colore sfondo riquadro
colore_testo_piastrella
string
Colore testo riquadro
colore_titolo
string
Colore titolo
numero_visualizzazioni
integer
Numero di visualizzazioni nell'interfaccia utente web di Looker
aspetto
Impostazioni visive della dashboard applicabili solo alle dashboard successive (beta)

Risposta

200: Pannello

Tipo di dati
Descrizione
(oggetto)
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
id_preferito_contenuti
integer
ID contenuti preferiti
id_metadati_contenuti
integer
ID dei metadati dei contenuti
description
string
Descrizione
nascosto
boolean
È nascosta
id
string
ID univoco
modello
Modello
Espandi definizione LookModel...
id
string
ID modello
etichetta
string
Etichetta del modello
fuso orario query
string
Fuso orario in cui verrà eseguita la dashboard per impostazione predefinita.
sola lettura
boolean
Sola lettura
aggiornamento_intervallo
string
Aggiorna intervallo, come frase relativa alla durata, come "2 ore e 30 minuti". Un numero senza unità di tempo verrà interpretato come secondi interi.
aggiornamento_intervallo_a_i
integer
Intervallo di aggiornamento in millisecondi
cartella
Cartella
Espandi definizione FolderBase...
name
string
Nome univoco
ID_genitore
string
ID del publisher principale. Se l'ID principale è null, si tratta di una voce a livello di directory principale
id
string
ID univoco
id_metadati_contenuti
integer
ID dei metadati dei contenuti
creata_alle
string
Ora di creazione della cartella
ID_creator
integer
ID utente del creator
numero_secondari
integer
Numero di bambini
ID_esterno
string
ID dell'incorporamento se questa cartella è stata generata automaticamente come cartella condivisa di incorporamento tramite "external_group_id" in un accesso all'incorporamento SSO
is_embed
boolean
La cartella è una cartella di incorporamento
radice_incorporata_è
boolean
La cartella è la cartella condivisa di incorporamento principale
radice_utenti_incorporati
boolean
La cartella è la cartella degli utenti di incorporamento principale
è_personale
boolean
La cartella è la cartella personale di un utente
è_discendente_personale
boolean
La cartella è discendente della cartella personale di un utente
radice_condivisa
boolean
La cartella è la cartella condivisa principale
radice_utenti_is
boolean
La cartella è la cartella utente root
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
title
string
Titolo dashboard
ID_utente
integer
ID dell'utente
lumaca
string
Lumaca metadati contenuti
visualizzatore_preferito
string
Il percorso preferito per visualizzare questa dashboard (ad es. dashboard o dashboard successive)
spazio
Spazio
Espandi definizione SpaceBase...
name
string
Nome univoco
ID_genitore
string
ID del publisher principale. Se l'ID principale è null, si tratta di una voce a livello di directory principale
id
string
ID univoco
id_metadati_contenuti
integer
ID dei metadati dei contenuti
creata_alle
string
Ora di creazione dello spazio.
ID_creator
integer
ID utente del creator
numero_secondari
integer
Numero di bambini
ID_esterno
string
ID incorporamento se questo spazio è stato generato automaticamente come spazio condiviso di incorporamento tramite "external_group_id" in un accesso all'incorporamento SSO
is_embed
boolean
Lo spazio è uno spazio di incorporamento
radice_incorporata_è
boolean
Lo spazio è lo spazio condiviso di incorporamento principale
radice_utenti_incorporati
boolean
Lo spazio è lo spazio degli utenti di incorporamento radice
è_personale
boolean
Lo spazio è lo spazio personale di un utente
è_discendente_personale
boolean
Lo spazio è discendente dello spazio personale di un utente
radice_condivisa
boolean
Lo spazio è lo spazio condiviso principale
radice_utenti_is
boolean
Lo spazio è lo spazio utente root
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
avvisi_sincronizzazione_con_filtro_dashboard
boolean
Consente agli avvisi di rimanere sincronizzati con le modifiche ai filtri della dashboard
colore_sfondo
string
Colore sfondo
creata_alle
string
L'ora in cui è stata creata la dashboard.
crossfilter_enabled
boolean
Attiva il filtro incrociato nelle dashboard (disponibile solo nelle dashboard successive) (beta)
elementi_dashboard
Espandi definizione DashboardElement...
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
corpo_testo
string
Corpo del testo nel riquadro del testo
corpo_testo_come_html
string
Corpo del testo del riquadro di testo come HTML
ID_dashboard
string
ID della dashboard
uri_modifica
string
Percorso relativo dell'URI del file LookML per modificare l'elemento della dashboard (solo dashboard LookML).
id
string
ID univoco
look
Look
Espandi definizione LookWithQuery in corso...
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
id_metadati_contenuti
integer
ID dei metadati dei contenuti
id
integer
ID univoco
title
string
Titolo titolo
id_preferito_contenuti
integer
ID contenuti preferiti
creata_alle
string
Ora di creazione del look.
ha eliminato
boolean
Indica se un look è "soft" o meno.
eliminato_in
string
Ora dell'eliminazione del look.
id_eliminatore
integer
ID dell'utente che ha eliminato l'aspetto.
description
string
Descrizione
url_incorporamento
string
URL per l'incorporamento
url_file_excel
string
URL del file Excel
numero_preferiti
integer
Numero di preferiti
formula_foglio_di_google
string
Formula fogli di lavoro Google
url_immagine_incorporamento
string
URL di incorporamento immagine
è_in_esecuzione_in_carico
boolean
esecuzione automatica quando viene visualizzato il look
ultimo_accesso
string
Data/ora in cui un utente ha eseguito l'ultimo accesso al look
ultimo_aggiornamento_id
integer
ID dell'utente che ha aggiornato l'ultimo look.
ultimo_visualizzato_a
string
Ultima visualizzazione nell'interfaccia utente web di Looker
modello
Modello
pubblica
boolean
È pubblico
lumaca_pubblica
string
Lumaca pubblica
url_pubblico
string
URL pubblico
id_query
integer
ID query
url_breve
string
URL breve
cartella
Cartella di questo look
cartella_id
string
ID cartella
aggiornato_in
string
Ora dell'aggiornamento del look.
ID_utente
integer
ID utente
numero_visualizzazioni
integer
Numero di visualizzazioni nell'interfaccia utente web di Looker
user
(DEPRECATO) Utente
spazio_id
string
ID spazio
spazio
Spazio di questo look
della query
Query
url
string
URL
look_id
string
ID look
look_link_id
string
ID collegamento LookML
id_risultato_unione
string
ID del risultato dell'unione
display_nota
string
Visualizzazione note
stato_nota
string
Stato nota
testo_nota
string
Testo della nota
testo_nota_come_html
string
Testo nota come HTML
della query
Query
Espandi definizione query...
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
id
integer
ID univoco
modello
string
Modello
vista
string
Nome esplorazione
campi
stringa[]
colonne pivot
stringa[]
campi_riempimento
stringa[]
filters
oggetto
Filtri
espressione_filtro
string
Espressione di filtro
ordina
stringa[]
limite
string
Limite
limite_colonna
string
Limite di colonne
totale
boolean
Total (Totale)
riga_totale
string
Totale non elaborato
subtotali
stringa[]
configurazione_vis
oggetto
Proprietà di configurazione della visualizzazione. Queste proprietà sono in genere opache e variano in base al tipo di visualizzazione usato. Non esiste un insieme specificato di chiavi consentite. I valori possono essere di qualsiasi tipo supportati dal formato JSON. È spesso presente una chiave "type" con valore stringa e utilizzata da Looker per determinare quale visualizzazione presentare. Le visualizzazioni ignorano le proprietà vis_config sconosciute.
configurazione_filtro
oggetto
Il filtro_config rappresenta lo stato dell'interfaccia utente del filtro nella pagina di esplorazione per una determinata query. Quando esegui una query tramite l'interfaccia utente di Looker, questo parametro ha la precedenza sui "filtri". Quando crei una query o ne modifichi una esistente, il filtro "filter_config" deve essere impostato su null. L'impostazione di qualsiasi altro valore potrebbe causare comportamenti di filtro imprevisti. Il formato deve essere considerato opaco.
sezioni_UI_visibili
string
Sezioni dell'interfaccia utente visibili
lumaca
string
Slug
campi_dinamici
string
Campi dinamici
client_id
string
ID client: utilizzato per generare URL di esplorazione abbreviati. Se impostato dal client, deve essere una stringa alfanumerica di 22 caratteri univoca. In caso contrario, ne verrà generato uno.
url_condivisione
string
Condividi URL
URL_condivisione_espanso
string
URL di condivisione espanso
url
string
URL espanso
fuso orario query
string
Fuso orario query
Has_table_calculations
boolean
Con calcoli tabulari
runtime
number
(DEPRECATO) Runtime (deprecato)
id_query
integer
ID query
aggiornamento_intervallo
string
Intervallo di aggiornamento
aggiornamento_intervallo_a_i
integer
Aggiorna intervallo come numero intero
creatore_dei_risultati
Dati sull'autore del risultato.
Espandi la definizione di ResultMakerWithIdVisConfigAndDynamicFields...
id
integer
ID univoco.
campi_dinamici
string
Stringa JSON con informazioni sui campi dinamici.
filtrabile
ordina
stringa[]
id_risultato_unione
string
ID del risultato dell'unione se questo è un join_result.
totale
boolean
Totale delle query costituenti, query o di unione
id_query
integer
ID della query, se si tratta di una query.
id_query_sql
string
ID di query SQL se si tratta di una query SQL Runner
della query
Query
configurazione_vis
oggetto
Vis config della costituente Query, o Merge Query.
id_produttore_risultato
integer
ID della voce ResultMakerSearch.
testo_sottotitolo
string
Testo sottotitolo riquadro testo
title
string
Titolo dell'elemento della dashboard
titolo_nascosto
boolean
Se il titolo è nascosto
testo_titolo
string
Titolo del riquadro di testo
tipo
string
Tipo
numero_avvisi
integer
Numero di avvisi associati a un elemento della dashboard
JSON_contenuti_rich
string
JSON con tutte le proprietà richieste per gli elementi di editor e pulsanti avanzati.
testo_titolo_come_html
string
Testo del titolo del riquadro di testo come HTML
testo_sottotitolo_come_html
string
Testo del sottotitolo del riquadro di testo come HTML
filtri_dashboard
Espandi definizione DashboardDashboard...
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
id
string
ID univoco
ID_dashboard
string
ID della dashboard
name
string
Nome del filtro
title
string
Titolo del filtro
tipo
string
Tipo di filtro: data, numero, stringa o campo
valore_predefinito
string
Valore predefinito del filtro
modello
string
Modello di filtro (obbligatorio se tipo = campo)
esplorazione
string
Esplorazione del filtro (obbligatorio se il tipo = campo)
dimensione
string
Dimensione del filtro (obbligatorio se il tipo = campo)
campo
oggetto
Informazioni sul campo
riga
integer
Ordine di visualizzazione di questo filtro rispetto ad altri filtri
ascolta_per_filtri
stringa[]
consenti_più_valori
boolean
Indica se il filtro consente più valori di filtro (deprecato nell'ultima versione delle dashboard).
obbligatorio
boolean
Indica se il filtro richiede un valore per eseguire la dashboard.
configurazione_ui
oggetto
La configurazione visiva di questo filtro. Utilizzato per configurare l'aspetto dell'interfaccia utente di questo filtro.
layout_dashboard
Espandi definizione DashboardLayout...
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
id
string
ID univoco
ID_dashboard
string
ID della dashboard
tipo
string
Tipo
attivo
boolean
È attivo
larghezza_colonna
integer
Larghezza colonna
width
integer
Larghezza
ha eliminato
boolean
Indica se il layout della dashboard è stato eliminato.
titolo_dashboard
string
Titolo estratto dalla dashboard rappresentata da questo layout.
componente_layout_dashboard
Espandi definizione DashboardLayoutComponent...
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
id
string
ID univoco
id_layout_dashboard
string
ID del layout della dashboard
id_elemento_dashboard
string
ID dell'elemento della dashboard
riga
integer
Riga
colonna
integer
Colonna
width
integer
Larghezza
height
integer
Altezza
ha eliminato
boolean
Indica se il componente del layout della dashboard è stato eliminato
titolo_elemento
string
Titolo dell'elemento della dashboard, estratto dall'elemento della dashboard.
elemento_titolo_nascosto
boolean
Indica se viene visualizzato o meno il titolo dell'elemento della dashboard.
tipo_vis
string
Tipo di visualizzazione, estratto dal file vis_config di una query
ha eliminato
boolean
Indica se una dashboard è stata eliminata o meno.
eliminato_in
string
L'ora in cui la dashboard è stata sottoposta a soft
id_eliminatore
integer
ID dell'utente che ha impostato "soft" la dashboard.
uri_modifica
string
Percorso relativo dell'URI del file LookML per modificare la dashboard (solo dashboard LookML).
abilita_schermo_intero_viz
boolean
Consenti la visualizzazione delle visualizzazioni in modalità a schermo intero
numero_preferiti
integer
Numero di preferiti
filtri_bar_compresso
boolean
Consente di impostare lo stato predefinito della barra dei filtri su compressa o aperta
filtri_località_top
boolean
Imposta lo stato predefinito della posizione dei filtri su top(true) o Right(false)
ultimo_accesso
string
Ora dell'ultimo accesso alla dashboard
ultimo_visualizzato_a
string
Ultima visualizzazione nell'interfaccia utente web di Looker
aggiornato_in
string
Ora dell'ultimo aggiornamento della dashboard.
ultimo_aggiornamento_id
integer
ID dell'utente che ha aggiornato la dashboard più di recente.
ultimo_aggiornamento_nome
string
Nome dell'utente che ha aggiornato la dashboard più di recente.
nome_utente
string
Nome dell'utente che ha creato la dashboard.
configurazione_del_carico
string
un'opzione di configurazione che regola il modo in cui viene eseguito il caricamento della dashboard.
look_link_id
string
Collega questa dashboard a una dashboard LookML specifica, in modo che le chiamate a un'operazione di **sincronizzazione** su quella dashboard LookML aggiornano questa dashboard in modo che corrisponda.
barra_filtri_mostra
boolean
Mostra barra dei filtri. **Nota di sicurezza:** questa proprietà influisce solo sull'aspetto *cosmetico* della dashboard, non sulla capacità di un utente di accedere ai dati. Nascondere la barra dei filtri **NON** impedisce agli utenti di modificare i filtri con altri mezzi. Per informazioni su come configurare i criteri di controllo sicuri dell'accesso ai dati, vedi [Controllare l'accesso degli utenti ai dati](https://cloud.google.com/looker/docs/r/api/control-access)
titolo_programma
boolean
Mostra titolo
spazio_id
string
ID dello spazio
cartella_id
string
ID della cartella
testo_piastrella_testo
string
Colore del testo nei riquadri di testo
colore_sfondo_piastrelle
string
Colore sfondo riquadro
colore_testo_piastrella
string
Colore testo riquadro
colore_titolo
string
Colore titolo
numero_visualizzazioni
integer
Numero di visualizzazioni nell'interfaccia utente web di Looker
aspetto
Impostazioni visive della dashboard applicabili solo alle dashboard successive (beta)
Espandi definizione DashboardAspect...
margini_pagina_lato_pagina
integer
Larghezza della pagina (lato)
colore_sfondo_pagina
string
Colore di sfondo per la dashboard
titolo_allineamento_piastrella
string
Allineamento del titolo sui riquadri della dashboard
riquadro_spazio_tra
integer
Spazio tra i riquadri
colore_sfondo_piastrelle
string
Colore sfondo per i riquadri
riquadro_ombra
boolean
Attiva/Disattiva riquadro riquadro
colore_chiave
string
Colore chiave

400: Richiesta errata

Tipo di dati
Descrizione
(oggetto)
messaggio
string
Error details (Dettagli errore)
documentazione_url
string
Link alla documentazione

404: Non trovata

Tipo di dati
Descrizione
(oggetto)
messaggio
string
Error details (Dettagli errore)
documentazione_url
string
Link alla documentazione

405: Impossibile modificare la risorsa

Tipo di dati
Descrizione
(oggetto)
messaggio
string
Error details (Dettagli errore)
documentazione_url
string
Link alla documentazione

422: Errore di convalida

Tipo di dati
Descrizione
messaggio
string
Error details (Dettagli errore)
Espandi definizione ValidationErrorDetails...
campo
string
Campo con errore
codice
string
Codice di errore
messaggio
string
Messaggio informativo sull'errore
documentazione_url
string
Link alla documentazione
documentazione_url
string
Link alla documentazione

429: Troppe richieste

Tipo di dati
Descrizione
(oggetto)
messaggio
string
Error details (Dettagli errore)
documentazione_url
string
Link alla documentazione

Esempi