Atualizar aparência

Versão 3.1.23.2

Modificar uma aparência

Use essa função para modificar partes de uma aparência. Os valores de propriedade fornecidos em uma chamada para update_look são aplicados à aparência existente. Portanto, não é necessário incluir propriedades com valores que não mudem. É melhor especificar apenas as propriedades que você quer mudar e deixar todo o resto fora da chamada update_look. As propriedades de aparência marcadas como "somente leitura" serão ignoradas.

Quando um usuário exclui uma aparência na IU do Looker, os dados dela permanecem no banco de dados, mas são marcados com uma sinalização excluída ("soft-deleted"). A exclusão reversível pode ser desfeita (por um administrador) se a exclusão foi um erro.

Para fazer uma exclusão reversível por meio de uma API, use update_look() para alterar a propriedade deleted da aparência para true. Você pode cancelar a exclusão de uma aparência chamando update_look para mudar a propriedade deleted dela para false.

As aparências excluídas de maneira reversível são excluídas dos resultados de all_looks() e search_looks(). Portanto, elas essencialmente desaparecem da visualização, mesmo que permaneçam no banco de dados. Na API 3.1 e versões mais recentes, é possível transmitir deleted: true como um parâmetro para search_looks() para listar aparências excluídas de modo reversível.

OBSERVAÇÃO: delete_look() realiza uma "exclusão irreversível". Os dados da aparência são removidos do banco de dados do Looker e destruídos. Não há "desfazer" para delete_look().

Solicitação

PATCH /looks/{look_id}
Tipo de dados
Descrição
Solicitação
HTTPRequest
path
HTTPPath
Expandir definição HTTPPath...
look_id
integer
ID da aparência
body
Corpo HTTP
Expandir definição HTTPBody...
body
LookWithQuery (link em inglês)
Look
Expandir a definição de LookWithQuery...
pode
objeto
Operações que o usuário atual pode realizar neste objeto
Content_metadata_id
integer
ID dos metadados de conteúdo
id
integer
ID exclusivo
title
string
Título do visual
content_favorite_id [código_de_conteúdo]
integer
ID do conteúdo favorito
criado_em
string
Hora em que a aparência foi criada.
excluído
booleano
Indica se um visual foi excluído de maneira reversível.
excluído_em
string
Hora em que a aparência foi excluída.
código_de_exclusão
integer
ID do usuário que excluiu a aparência.
Descrição
string
Descrição
URL_incorporado
string
Incorporar URL
excel_file_url
string
URL do arquivo do Excel
contagem_favorita
integer
Número de vezes favorito
Planilha_de_planilhas
string
Fórmula da planilha do Google
imagem_incorporada_url
string
URL de incorporação de imagem
is_run_on_load
booleano
executar consulta automaticamente quando a visualização tiver sido visualizada
last_accessed_at
string
Hora em que o acesso foi acessado pela última vez por qualquer usuário
ID_do_último_atualizado
integer
ID do usuário que atualizou a aparência pela última vez.
last_viewed_at
string
Hora da última visualização na IU da Web do Looker
modelo
Modelo
público
booleano
É público
lesma_pública
string
Lesma pública
URL_público
string
URL público
ID da consulta
integer
ID da consulta
URL_curto
string
URL curto
pasta
Pasta desta aparência
ID da pasta
string
ID da pasta
atualizado em
string
Hora em que a aparência foi atualizada.
user_id
integer
ID do usuário
contagem_de_visualizações
integer
Número de visualizações na IU da Web do Looker
user
UserIdOnly (em inglês)
(USO SUSPENSO) Usuário
ID do espaço
string
ID do espaço
espaço
Espaço deste visual
consulta
Consulta
url
string
URL
consulta
Consulta HTTP
Expandir a definição de HTTPQuery...
campos
string
Campos solicitados.

Resposta

200: aparência

Tipo de dados
Descrição
(objeto)
LookWithQuery (link em inglês)
pode
objeto
Operações que o usuário atual pode realizar neste objeto
Content_metadata_id
integer
ID dos metadados de conteúdo
id
integer
ID exclusivo
title
string
Título do visual
content_favorite_id [código_de_conteúdo]
integer
ID do conteúdo favorito
criado_em
string
Hora em que a aparência foi criada.
excluído
booleano
Indica se um visual foi excluído de maneira reversível.
excluído_em
string
Hora em que a aparência foi excluída.
código_de_exclusão
integer
ID do usuário que excluiu a aparência.
Descrição
string
Descrição
URL_incorporado
string
Incorporar URL
excel_file_url
string
URL do arquivo do Excel
contagem_favorita
integer
Número de vezes favorito
Planilha_de_planilhas
string
Fórmula da planilha do Google
imagem_incorporada_url
string
URL de incorporação de imagem
is_run_on_load
booleano
executar consulta automaticamente quando a visualização tiver sido visualizada
last_accessed_at
string
Hora em que o acesso foi acessado pela última vez por qualquer usuário
ID_do_último_atualizado
integer
ID do usuário que atualizou a aparência pela última vez.
last_viewed_at
string
Hora da última visualização na IU da Web do Looker
modelo
Modelo
Expandir a definição do LookModel...
id
string
ID do modelo
Rótulo
string
Rótulo do modelo
público
booleano
É público
lesma_pública
string
Lesma pública
URL_público
string
URL público
ID da consulta
integer
ID da consulta
URL_curto
string
URL curto
pasta
Pasta desta aparência
Expandir a definição de FolderBase...
nome
string
Nome exclusivo
parent_id
string
ID do pai. Se o ID pai for nulo, é uma entrada de nível raiz
id
string
ID exclusivo
Content_metadata_id
integer
ID dos metadados de conteúdo
criado_em
string
Hora em que a pasta foi criada
ID do criador
integer
User ID do criador
contagem_filho
integer
Contagem de crianças
ID_externo
string
Código do incorporador se esta pasta foi gerada automaticamente como uma pasta compartilhada de incorporação via 'external_group_id' em um login de incorporação de SSO
is_embed
booleano
Pasta é uma pasta incorporada
raiz_integrada_compartilhada
booleano
Pasta é a pasta compartilhada incorporada como raiz
is_embed_users_root
booleano
Pasta é a pasta raiz incorporada de usuários
é_pessoal
booleano
Pasta é a pasta pessoal do usuário
is_personal_descendente
booleano
A pasta é descendente da pasta pessoal de um usuário
raiz_compartilhada
booleano
Pasta é a pasta compartilhada raiz
root_users_root
booleano
Pasta é a pasta raiz do usuário
pode
objeto
Operações que o usuário atual pode realizar neste objeto
ID da pasta
string
ID da pasta
atualizado em
string
Hora em que a aparência foi atualizada.
user_id
integer
ID do usuário
contagem_de_visualizações
integer
Número de visualizações na IU da Web do Looker
user
UserIdOnly (em inglês)
(USO SUSPENSO) Usuário
Expandir definição UserIdOnly...
id
integer
ID exclusivo
ID do espaço
string
ID do espaço
espaço
Espaço deste visual
Expandir definição do SpaceBase...
nome
string
Nome exclusivo
parent_id
string
ID do pai. Se o ID pai for nulo, é uma entrada de nível raiz
id
string
ID exclusivo
Content_metadata_id
integer
ID dos metadados de conteúdo
criado_em
string
Horário em que o espaço foi criado
ID do criador
integer
User ID do criador
contagem_filho
integer
Contagem de crianças
ID_externo
string
Código do incorporador se este espaço foi gerado automaticamente como um espaço compartilhado incorporado via "external_group_id" em um login de incorporação de SSO
is_embed
booleano
Um espaço é incorporado
raiz_integrada_compartilhada
booleano
Espaço é o espaço compartilhado incorporado da raiz
is_embed_users_root
booleano
Espaço é o espaço raiz incorporado dos usuários
é_pessoal
booleano
O espaço pessoal do usuário
is_personal_descendente
booleano
O espaço é descendente do espaço pessoal de um usuário
raiz_compartilhada
booleano
Espaço é a raiz compartilhada
root_users_root
booleano
Espaço é o espaço raiz do usuário
pode
objeto
Operações que o usuário atual pode realizar neste objeto
consulta
Consulta
Expandir definição da consulta...
pode
objeto
Operações que o usuário atual pode realizar neste objeto
id
integer
ID exclusivo
modelo
string
Modelo
visualização
string
Explorar nome
campos
string[]
pivôs
string[]
fill_fields
string[]
filters
objeto
Filtros
expressao_de_filtro
string
Expressão de filtro
classificações
string[]
limite
string
Limite
limit_column
string
Limite de colunas
total
booleano
Total
total da linha
string
Total bruto
subtotais
string[]
vis_config
objeto
Propriedades de configuração da visualização. Essas propriedades geralmente são opacas e diferem com base no tipo de visualização usada. Não há um conjunto especificado de chaves permitidas. Os valores podem ser qualquer tipo compatível com JSON. Uma chave de "tipo" com um valor de string geralmente está presente e é usada pelo Looker para determinar qual visualização será exibida. As visualizações ignoram as propriedades vis_config desconhecidas.
configuração_do_filtro
objeto
O valor de "filter_config" representa o estado da IU do filtro na página de exploração de uma determinada consulta. Ao executar uma consulta por meio da IU do Looker, esse parâmetro tem precedência sobre "filtros". Ao criar uma consulta ou modificar uma consulta existente, "filter_config" deve ser definido como nulo. Definir como qualquer outro valor pode causar um comportamento inesperado de filtragem. O formato deve ser considerado opaco.
_UI_sections visíveis
string
Seções de IU visíveis
lesma
string
Slug
dynamic_fields
string
Campos dinâmicos
client_id
string
ID do cliente: usado para gerar URLs de exploração encurtados. Se definido pelo cliente, deve ser uma sequência alfanumérica única de 22 caracteres. Caso contrário, será gerado um.
url_de_compartilhamento
string
Compartilhar URL
url_de_compartilhamento_expandido
string
URL de compartilhamento expandido
url
string
URL expandido
fuso horário_de_consulta
string
Fuso horário da consulta
has_table_calculations
booleano
Tem cálculos de tabela
runtime
number
(OBSOLETO) Tempo de execução (obsoleto)
url
string
URL

400: Solicitação inválida

Tipo de dados
Descrição
(objeto)
mensagem
string
Detalhes do erro
url_da_documentação
string
Link da documentação

404: não encontrado

Tipo de dados
Descrição
(objeto)
mensagem
string
Detalhes do erro
url_da_documentação
string
Link da documentação

422: erro de validação

Tipo de dados
Descrição
(objeto)
mensagem
string
Detalhes do erro
Expandir a definição de ValidationErrorDetail...
campo
string
Campo com erro
código
string
Código do erro
mensagem
string
Mensagem de erro
url_da_documentação
string
Link da documentação
url_da_documentação
string
Link da documentação

429: Solicitações demais

Tipo de dados
Descrição
(objeto)
mensagem
string
Detalhes do erro
url_da_documentação
string
Link da documentação

Examples