- Solicitação HTTP
- Parâmetros de caminho
- Parâmetros de consulta
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- Image
- Miniatura
- Status
- Faça um teste
Lista miniaturas de imagens anexadas a uma etapa.
Pode retornar qualquer um dos seguintes códigos de erro canônicos: - PERMISSION_DENIED - se o usuário não estiver autorizado a ler no projeto ou em qualquer uma das imagens - INVALID_MCC - se a solicitação estiver incorreta - NOT_FOUND - se a etapa não existir ou se alguma das imagens não existir
Solicitação HTTP
GET https://toolresults.googleapis.com/toolresults/v1beta3/projects/{projectId}/histories/{historyId}/executions/{executionId}/steps/{stepId}/thumbnails
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
Parâmetros | |
---|---|
projectId |
Um ID do projeto. Obrigatório. |
historyId |
Um ID do histórico. Obrigatório. |
executionId |
Um ID de execução. Obrigatório. |
stepId |
Um ID de etapa. Obrigatório. |
Parâmetros de consulta
Parâmetros | |
---|---|
pageToken |
Um token de continuação para retomar a consulta no próximo item. Opcional. |
pageSize |
O número máximo de miniaturas a serem buscadas. Valor padrão: 50. O servidor usará esse padrão se o campo não estiver definido ou tiver um valor zero. Opcional. |
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Uma resposta contendo as miniaturas em uma etapa.
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
Representação JSON |
---|
{
"thumbnails": [
{
object ( |
Campos | |
---|---|
thumbnails[] |
Uma lista de dados de imagem. As imagens são retornadas em uma ordem determinística. eles são ordenados por esses fatores, em ordem de importância: * Primeiro, pelo caso de teste associado. Imagens sem caso de teste são consideradas maiores do que imagens com um. * Segundo, pelo horário de criação. As imagens sem horário de criação são maiores que as imagens com uma. * Terceiro, pela ordem em que foram adicionados à etapa (por chamadas para steps.create ou steps.patch). |
nextPageToken |
Um token de continuação para retomar a consulta no próximo item. Se definido, indica que há mais miniaturas para ler, chamando list novamente com esse valor no campo pageToken. |
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/cloud-platform
Para saber mais, consulte a Visão geral da autenticação.
Imagem
Uma imagem, com um link para a imagem principal e uma miniatura.
Representação JSON |
---|
{ "stepId": string, "sourceImage": { object ( |
Campos | |
---|---|
stepId |
A etapa à qual a imagem está anexada. Sempre definido. |
sourceImage |
Uma referência à imagem original em tamanho real. É o mesmo que a entrada toolOutputs da imagem em sua etapa. Sempre definido. |
Campo de união thumbnail_or_error . Uma miniatura da imagem ou um erro explicando por que a miniatura não foi renderizada. thumbnail_or_error pode ser apenas de um dos tipos a seguir: |
|
thumbnail |
A miniatura. |
error |
Um erro que explica por que a miniatura não foi renderizada. |
Miniatura
Uma única miniatura, com tamanho e formato.
Representação JSON |
---|
{ "contentType": string, "heightPx": integer, "widthPx": integer, "data": string } |
Campos | |
---|---|
contentType |
O tipo de conteúdo da miniatura, por exemplo, "image/png". Sempre definido. |
heightPx |
A altura da miniatura, em pixels. Sempre definido. |
widthPx |
A largura da miniatura, em pixels. Sempre definido. |
data |
O próprio arquivo de miniatura. Ou seja, estes bytes são exatamente os bytes que compõem o arquivo de miniatura; eles podem ser veiculados como uma imagem no estado em que se encontram (com o tipo de conteúdo apropriado). Sempre definido. Uma string codificada em base64. |
Status
O tipo Status
define um modelo de erro lógico que é adequado a diferentes ambientes de programação, incluindo APIs REST e RPC. É usado por gRPC (em inglês). Cada mensagem Status
contém três partes de dados: código do erro, mensagem de erro e detalhes do erro.
É possível descobrir mais sobre esse modelo de erro e como trabalhar com ele no Guia de design de API.
Representação JSON |
---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
Campos | |
---|---|
code |
O código de status, que precisa ser um valor de enumeração de |
message |
Uma mensagem de erro em inglês para o desenvolvedor. Qualquer mensagem de erro para o usuário precisa ser localizada e enviada no campo |
details[] |
Uma lista de mensagens com os detalhes do erro. Há um conjunto comum de tipos de mensagens para as APIs usarem. Um objeto contendo campos de um tipo arbitrário. Um campo adicional |