Actualizar panel

Versión 4.0.23.6 (más reciente)

Actualizar un panel

Puedes usar esta función para cambiar las propiedades de string y número entero de un panel. Esta función no puede modificar objetos anidados, como filtros, elementos de panel o componentes de diseño de este. Usa las funciones de actualización para los respectivos tipos de objetos anidados (como update_dashboard_filter() a fin de cambiar un filtro) a fin de modificar los objetos anidados a los que hace referencia un panel.

Si recibes una respuesta de error 422 cuando actualizas un panel, asegúrate de mirar el cuerpo de la respuesta para obtener información sobre exactamente qué campos faltan o que contienen datos no válidos.

Solicitud

PATCH /dashboards/{dashboard_id}
Tipo de datos
Descripción
Solicitud
HTTPRequest
ruta
Ruta de HTTP
Expandir la definición HTTPPath...
id_panel
string
ID del panel
body
Cuerpo HTTP
Expandir la definición HTTPBody...
body
Panel
Expandir la definición del panel...
que pueden
objeto
Operaciones que el usuario actual puede realizar en este objeto
id_favorito_contenido
string
ID de favoritos de contenido
id_metadatos_contenido
string
ID de los metadatos del contenido
description
string
Descripción
de pesos
booleano
Está oculto
id
string
ID único
model
Modelo
zona horaria de consulta
string
Zona horaria en la que el Panel se ejecutará de forma predeterminada.
solo lectura
booleano
Es de solo lectura
intervalo_de_actualización
string
Intervalo de actualización, como una frase de duración como "2 horas y 30 minutos". Un número sin unidades de tiempo se interpretará como segundos enteros.
actualizar_interval_to_i
integer
Intervalo de actualización en milisegundos
carpeta
Carpeta
title
string
Título del panel
user_id
string
ID del usuario
babosa
string
Babosa de metadatos de contenido
visor_preferido
string
La ruta preferida para ver este panel (p. ej., paneles o paneles)
alert_sync_with_dashboard_filter_enabled
booleano
Permite que las alertas se mantengan sincronizadas con los cambios en los filtros de paneles
color_de_fondo
string
Color de fondo
creado_en
string
Hora en la que se creó el Panel de control
crossfilter_enabled
booleano
Habilita el filtrado cruzado en los paneles; solo está disponible en el siguiente panel (versión beta).
elementos_del_panel
filtros_panel
diseño_panel
borrado
booleano
Indica si se borró o no un panel de control.
borrado_en
string
Hora en la que se borró el Panel de control
borrar_id
string
ID del usuario que "soft" borró el panel.
editar_uri
string
Ruta relativa del URI del archivo LookML para editar el panel (solo el panel de LookML).
habilitar_viz_full_screen
booleano
Permitir que las visualizaciones se vean en el modo de pantalla completa
conteo_favorito
integer
Cantidad de veces que se marcó como favorito
filtros_barras_contraídas
booleano
Establece el estado predeterminado de la barra de filtros en contraído o abierto.
filtros_ubicación_superior
booleano
Establece el estado predeterminado de los filtros en la ubicación como top(true) o right(false).
último_acceso_en
string
Hora de la última vez que se accedió al panel
último_vista_en
string
Hora de última visualización en la IU web de Looker
actualizado_a
string
Hora en la que se actualizó el panel por última vez
id_último_actualizador
string
ID del usuario que actualizó más recientemente el panel.
apellido_actual
string
Nombre del usuario que actualizó más recientemente el panel.
nombre_de_usuario
string
El nombre del usuario que creó el panel.
load_configuration
string
configuración que controla cómo se realizará la carga del panel.
look_link_id
string
Vincula este panel a un panel de LookML en particular, de modo que llamar a una operación de **sincronización** en ese panel de LookML actualizará este panel para que coincida.
barra_de_filtros_de_programa
booleano
Mostrar la barra de filtros. **Nota de seguridad:** Esta propiedad solo afecta la apariencia *cosmética* del panel, no la capacidad del usuario para acceder a los datos. Ocultar la barra de filtros **NO** impide que los usuarios cambien los filtros por otros medios. Para obtener información sobre cómo configurar políticas de control de acceso seguras a los datos, consulta [Control del acceso del usuario a los datos](https://cloud.google.com/looker/docs/r/api/control-access)
título_programa
booleano
Mostrar título
ID de la carpeta
string
ID de la carpeta
texto_mosaico_color
string
Color del texto en mosaicos de texto
mosaico_color_fondo
string
Color de fondo de la tarjeta
mosaico_color
string
Color del texto de la tarjeta
título_color
string
Color del título
recuento de vistas
integer
Cantidad de veces que se vio en la IU web de Looker
apariencia
La configuración visual del panel solo se aplica a los paneles siguientes (beta)
url
string
URL relativa del panel

Respuesta

200: Panel de control

Tipo de datos
Descripción
(objeto)
que pueden
objeto
Operaciones que el usuario actual puede realizar en este objeto
id_favorito_contenido
string
ID de favoritos de contenido
id_metadatos_contenido
string
ID de los metadatos del contenido
description
string
Descripción
de pesos
booleano
Está oculto
id
string
ID único
model
Modelo
Expandir la definición de LookModel...
id
string
ID del modelo
label
string
Etiqueta del modelo
zona horaria de consulta
string
Zona horaria en la que el Panel se ejecutará de forma predeterminada.
solo lectura
booleano
Es de solo lectura
intervalo_de_actualización
string
Intervalo de actualización, como una frase de duración como "2 horas y 30 minutos". Un número sin unidades de tiempo se interpretará como segundos enteros.
actualizar_interval_to_i
integer
Intervalo de actualización en milisegundos
carpeta
Carpeta
Expandir la definición de FolderBase...
del espacio
string
Nombre único
ID del padre
string
ID del publicador superior. Si el ID superior es nulo, es una entrada de nivel raíz.
id
string
ID único
id_metadatos_contenido
string
ID de los metadatos del contenido
creado_en
string
Hora en que se creó la carpeta
ID del creador
string
ID del usuario del creador
cantidad_de_niños
integer
Cantidad de niños
id_externo
string
ID de la incorporación, si la carpeta se generó automáticamente como una carpeta compartida de incorporación a través de "external_group_id" en un acceso de incorporación de SSO
está_incorporado
booleano
La carpeta es una carpeta incorporada
is_embed_shared_root
booleano
La carpeta es la carpeta raíz incorporada para compartir.
is_embed_users_root
booleano
La carpeta es la carpeta raíz de los usuarios incorporados
es_personal
booleano
La carpeta es la carpeta personal del usuario
es_descendente_personal
booleano
La carpeta es descendiente de la carpeta personal del usuario.
is_shared_root
booleano
La carpeta es la carpeta compartida raíz
is_users_root
booleano
La carpeta es la carpeta de usuario raíz
que pueden
objeto
Operaciones que el usuario actual puede realizar en este objeto
title
string
Título del panel
user_id
string
ID del usuario
babosa
string
Babosa de metadatos de contenido
visor_preferido
string
La ruta preferida para ver este panel (p. ej., paneles o paneles)
alert_sync_with_dashboard_filter_enabled
booleano
Permite que las alertas se mantengan sincronizadas con los cambios en los filtros de paneles
color_de_fondo
string
Color de fondo
creado_en
string
Hora en la que se creó el Panel de control
crossfilter_enabled
booleano
Habilita el filtrado cruzado en los paneles; solo está disponible en el siguiente panel (versión beta).
elementos_del_panel
Expandir la definición de DashboardElement...
que pueden
objeto
Operaciones que el usuario actual puede realizar en este objeto
cuerpo_texto
string
Texto del cuerpo del mosaico de texto
cuerpo_texto_como_html
string
Texto de cuerpo del mosaico de texto en formato HTML
id_panel
string
ID del panel
editar_uri
string
Ruta relativa del URI del archivo LookML para editar el elemento del panel (solo el panel de LookML).
id
string
ID único
estilo
Vista
Expandir la definición de LookWithQuery...
que pueden
objeto
Operaciones que el usuario actual puede realizar en este objeto
id_metadatos_contenido
string
ID de los metadatos del contenido
id
string
ID único
title
string
Título del estilo
user_id
string
ID de usuario
id_favorito_contenido
string
ID de favoritos de contenido
creado_en
string
Hora en la que se creó el estilo
borrado
booleano
Si se borra o no un estilo
borrado_en
string
Hora en que se borró el estilo.
borrar_id
string
Es el ID del usuario que borró el estilo.
description
string
Descripción
URL_incorporada
string
Incorporar URL
URL_excelente
string
URL del archivo de Excel
conteo_favorito
integer
Cantidad de veces que se marcó como favorito
fórmula_hoja_cálculo_google
string
Fórmula de la hoja de cálculo de Google
URL de imagen_incorporada
string
URL de incorporación de imagen
is_run_on_load
booleano
consulta ejecutada automáticamente cuando Look Look
último_acceso_en
string
Hora a la que cualquier usuario accedió por última vez a Look
id_último_actualizador
string
ID del usuario que actualizó el estilo por última vez.
último_vista_en
string
Hora de última visualización en la IU web de Looker
model
Modelo
public
booleano
Es público
babosa pública
string
Babosa pública
URL_pública
string
URL pública
ID de la consulta
string
ID de la consulta
URL_corto
string
URL corta
carpeta
Carpeta de este estilo
ID de la carpeta
string
ID de la carpeta
actualizado_a
string
Hora de actualización del estilo.
recuento de vistas
integer
Cantidad de veces que se vio en la IU web de Looker
verá la consulta cuando se guarde
Consulta
url
string
URL
look_id
string
ID de estilo
look_link_id
string
ID de vinculación de LookML
id_resultado_fusión
string
ID del resultado de la fusión
pantalla_notas
string
Visualización de notas
estado_de_la_nota
string
Estado de la nota
texto_de_la_nota
string
Texto de la nota
nota_texto_como_html
string
Texto de la nota como HTML
verá la consulta cuando se guarde
Consulta
Expandir definición de consulta...
que pueden
objeto
Operaciones que el usuario actual puede realizar en este objeto
id
string
ID único
model
string
Modelo
vista
string
Nombre de la exploración
campos
string[]
reorientación
string[]
campo_relleno
string[]
filters
objeto
Filtros
expresión_filtrada
string
Filtrar expresión
ordena
string[]
límite
string
Límite
Límite_columna
string
Límite de columnas
total
booleano
Total
fila_total
string
Total sin procesar
subtotales
string[]
vis_config
objeto
Propiedades de configuración de la visualización Por lo general, estas propiedades son opacas y difieren según el tipo de visualización que se use. No hay un conjunto especificado de claves permitidas. Los valores pueden ser de cualquier tipo compatible con JSON. Una clave de "tipo" con un valor de string suele estar presente y Looker la usa para determinar qué visualización presentar. Las visualizaciones ignoran las propiedades vis_config desconocidas.
filtro_configuración
objeto
filter_config representa el estado de la IU del filtro en la página de exploración para una búsqueda determinada. Cuando se ejecuta una consulta a través de la IU de Looker, este parámetro tiene prioridad sobre los "filtros". Cuando se crea una consulta o se modifica una existente, se debe establecer “filter_config” como nulo. Si se establece en cualquier otro valor, se puede generar un comportamiento de filtrado inesperado. El formato debe considerarse opaco.
secciones_de_IU visibles
string
Secciones visibles de la IU
babosa
string
Slug
campos_dinámicos
string
Campos dinámicos
client_id
string
ID de cliente: Se usa para generar URL de exploración abreviadas. Si lo establece el cliente, debe ser una string alfanumérica única de 22 caracteres. De lo contrario, se generará uno.
URL_compartir
string
Compartir URL
URL_compartida_expandida
string
URL para compartir expandida
url
string
URL expandida
zona horaria de consulta
string
Zona horaria de la consulta
tiene_tablas_cálculas
booleano
Tiene cálculos de tabla
ID de la consulta
string
ID de la consulta
intervalo_de_actualización
string
Intervalo de actualización
actualizar_interval_to_i
integer
Intervalo de actualización como número entero
creador_de_resultados
Datos sobre el creador de resultados
Expandir la definición ResultMakerWithIdVisConfigAndDynamicFields...
id
string
ID único
campos_dinámicos
string
String de JSON de información de campo dinámico.
ordena
string[]
id_resultado_fusión
string
ID del resultado de la fusión si es un merge_result.
total
booleano
Total de consultas de combinación de aspecto, consulta o combinación
ID de la consulta
string
ID de la consulta si es una consulta.
sql_query_id.
string
ID de la consulta de SQL si se trata de una consulta de ejecutor de SQL
verá la consulta cuando se guarde
Consulta
vis_config
objeto
Por la configuración de la consulta constituyente o la consulta de combinación
id_creador_de_resultados
string
ID de la entrada ResultMakerLookup.
texto_subtítulo
string
Texto del subtítulo del mosaico de texto
title
string
Título del elemento del panel
título_oculto
booleano
Si el título está oculto
título_texto
string
Título del mosaico de texto
tipo
string
Tipo
cantidad_de_alertas
integer
Recuento de alertas asociadas con un elemento de panel
JSON_contenido_json
string
JSON con todas las propiedades requeridas para el editor enriquecido y elementos de botones
título_texto_como_html
string
Texto de título de la tarjeta como texto HTML
subtitle_text_as_html
string
Texto de subtítulos en formato HTML
id_extensión
string
ID de extensión
filtros_panel
Expandir la definición de DashboardFilter...
que pueden
objeto
Operaciones que el usuario actual puede realizar en este objeto
id
string
ID único
id_panel
string
ID del panel
del espacio
string
Nombre del filtro
title
string
Título del filtro
tipo
string
Tipo de filtro: uno de fecha, número, string o campo
default_value
string
Valor predeterminado del filtro
model
string
Modelo de filtro (obligatorio si el tipo es igual al campo)
exploración
string
Exploración del filtro (obligatorio si el tipo es igual al campo)
dimensión
string
Dimensión del filtro (obligatorio si el tipo es igual al campo)
campo
objeto
Información del campo
fila
integer
Mostrar el orden de este filtro en relación con otros filtros
escucha_filtros
string[]
allow_multiple_values
booleano
Si el filtro permite varios valores de filtro (obsoleto en la versión más reciente de los paneles)
obligatorio
booleano
Si el filtro requiere un valor para ejecutar el panel
ui_config
objeto
La configuración visual para este filtro. Se usa para configurar cómo debe aparecer la IU de este filtro.
diseño_panel
Expandir la definición de DashboardLayout...
que pueden
objeto
Operaciones que el usuario actual puede realizar en este objeto
id
string
ID único
id_panel
string
ID del panel
tipo
string
Tipo
activo
booleano
Está activo
ancho_columna
integer
Ancho de columna
ancho
integer
Ancho
borrado
booleano
Indica si se borró o no el diseño del panel.
panel_título
string
Título extraído del panel que representa este diseño
panel_layout_components
Expandir la definición de DashboardLayoutComponent...
que pueden
objeto
Operaciones que el usuario actual puede realizar en este objeto
id
string
ID único
id_de_diseño_del_panel
string
ID del diseño del panel
panel_element_id
string
ID del elemento del panel
fila
integer
Fila
column
integer
Columna
ancho
integer
Ancho
alto
integer
Altura
borrado
booleano
Si se borra o no el componente de diseño del panel
elemento_título
string
Título del elemento del panel, extraído del elemento de panel
elemento_título_oculto
booleano
Indica si se muestra o no el título del elemento del panel.
vis_type
string
Tipo de visualización, extraída de la vis_config de una consulta
borrado
booleano
Indica si se borró o no un panel de control.
borrado_en
string
Hora en la que se borró el Panel de control
borrar_id
string
ID del usuario que "soft" borró el panel.
editar_uri
string
Ruta relativa del URI del archivo LookML para editar el panel (solo el panel de LookML).
habilitar_viz_full_screen
booleano
Permitir que las visualizaciones se vean en el modo de pantalla completa
conteo_favorito
integer
Cantidad de veces que se marcó como favorito
filtros_barras_contraídas
booleano
Establece el estado predeterminado de la barra de filtros en contraído o abierto.
filtros_ubicación_superior
booleano
Establece el estado predeterminado de los filtros en la ubicación como top(true) o right(false).
último_acceso_en
string
Hora de la última vez que se accedió al panel
último_vista_en
string
Hora de última visualización en la IU web de Looker
actualizado_a
string
Hora en la que se actualizó el panel por última vez
id_último_actualizador
string
ID del usuario que actualizó más recientemente el panel.
apellido_actual
string
Nombre del usuario que actualizó más recientemente el panel.
nombre_de_usuario
string
El nombre del usuario que creó el panel.
load_configuration
string
configuración que controla cómo se realizará la carga del panel.
look_link_id
string
Vincula este panel a un panel de LookML en particular, de modo que llamar a una operación de **sincronización** en ese panel de LookML actualizará este panel para que coincida.
barra_de_filtros_de_programa
booleano
Mostrar la barra de filtros. **Nota de seguridad:** Esta propiedad solo afecta la apariencia *cosmética* del panel, no la capacidad del usuario para acceder a los datos. Ocultar la barra de filtros **NO** impide que los usuarios cambien los filtros por otros medios. Para obtener información sobre cómo configurar políticas de control de acceso seguras a los datos, consulta [Control del acceso del usuario a los datos](https://cloud.google.com/looker/docs/r/api/control-access)
título_programa
booleano
Mostrar título
ID de la carpeta
string
ID de la carpeta
texto_mosaico_color
string
Color del texto en mosaicos de texto
mosaico_color_fondo
string
Color de fondo de la tarjeta
mosaico_color
string
Color del texto de la tarjeta
título_color
string
Color del título
recuento de vistas
integer
Cantidad de veces que se vio en la IU web de Looker
apariencia
La configuración visual del panel solo se aplica a los paneles siguientes (beta)
Expandir la definición del panel de control...
márgenes_de_página
integer
Ancho del margen de la página (lateral)
color de fondo de página
string
Color de fondo para el panel
alineación_título_mosaico
string
Alineación del título en los mosaicos del panel
mosaico_espacio_entre
integer
Espacio entre mosaicos
mosaico_color_fondo
string
Color de fondo para tarjetas
sombra_azulejo
booleano
Sombra de mosaico activada/desactivada
color_clave
string
Color de la clave
url
string
URL relativa del panel

400: Bad Request

Tipo de datos
Descripción
(objeto)
mensaje,
string
Detalles del error
url_documentación
string
Vínculo a la documentación

404: No encontrado

Tipo de datos
Descripción
(objeto)
mensaje,
string
Detalles del error
url_documentación
string
Vínculo a la documentación

405: No se puede modificar el recurso

Tipo de datos
Descripción
(objeto)
mensaje,
string
Detalles del error
url_documentación
string
Vínculo a la documentación

422: Error de validación

Tipo de datos
Descripción
(objeto)
mensaje,
string
Detalles del error
Expandir la definición de ValidationErrorDetail...
campo
string
Campo con error
código
string
Código de error
mensaje,
string
Mensaje de información de error
url_documentación
string
Vínculo a la documentación
url_documentación
string
Vínculo a la documentación

429: Demasiadas solicitudes

Tipo de datos
Descripción
(objeto)
mensaje,
string
Detalles del error
url_documentación
string
Vínculo a la documentación

Ejemplos