Gerenciar controles de veiculação

Esta página descreve como visualizar, editar, excluir, exportar e importar controles de veiculação.

Para informações gerais sobre controles de veiculação e instruções sobre como criar controles de veiculação, consulte Sobre os controles de veiculação e Criar controles de veiculação.

Ver e editar controles de veiculação

É possível conferir os controles de veiculação da Vertex AI para Pesquisa para varejo usando o console e a API.

Visualizar e editar controles de veiculação no console

A guia Controles de exibição da página "Controles" lista todos os seus controles de exibição e as configurações de exibição associadas. Clique no botão Ícone Editar controle que pode ser alterado por um controle as configurações e as configurações de veiculação associadas em Editar controle do painel de controle. Clique no ícone Excluir controle do um controle para excluí-la, o que também a remove de todas as configurações de exibição.

Você também pode ver e editar os controles de uma configuração de veiculação específica no a página Configurações de exibição. Clique em uma configuração de exibição para acessar a página Detalhes, que lista todos os controles de exibição para essa configuração. Clique no botão Ícone Editar controle que pode ser alterado por um controle suas configurações no painel Editar controle. Clique no botão Remover controle para dissociar o controle da configuração de veiculação (isso não exclui a controle).

Leva alguns minutos para que os controles recém-criados ou atualizados estejam prontos para exibir o tráfego em tempo real. Você pode testar se as alterações foram aplicadas na página Avaliar do console.

Conferir controles de veiculação inline

Para ver um único controle de veiculação in-line, use Control.get.

Para saber mais sobre esse método, consulte a referência da API Control.get.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls/CONTROL_ID'

Para listar vários controles de veiculação in-line, use Controls.list.

Opcionalmente, use o parâmetro pageSize para definir um número máximo de resultados a serem retornados. Se mais resultados estiverem disponíveis, a resposta list incluirá um token de página. É possível transmitir um token de página no parâmetro pageToken de um list para recuperar a próxima página de resultados.

Para listar somente os controles associados a uma determinada configuração de veiculação, use O parâmetro de consulta filter para especificar o ID de configuração de veiculação.

Para saber mais sobre esse método, consulte a Referência da API Control.list.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=servingConfig=SERVING_CONFIG_ID

Patch de controles de veiculação inline

Para atualizar campos em um controle de veiculação, use Controls.patch e inclua uma instância de Control no corpo da solicitação. Especifique o campos para atualizar com o parâmetro updateMask ou deixá-lo indefinido para atualizar todos os campos aceitos.

Para saber mais sobre esse método, consulte a Referência da API Controls.patch.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
      "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls/CONTROL_ID",
      "FIELD_NAME_1": "NEW_FIELD_VALUE_1"
      "FIELD_NAME_2": "NEW_FIELD_VALUE_2"
    }' \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls/CONTROL_ID?updateMask=FIELD_NAME_1,FIELD_NAME_2'

Adicionar controles às configurações de exibição inline

Para adicionar um controle a uma configuração de exibição, use ServingConfig.addControl.

Para saber mais sobre esse método, consulte a referência da API ServingConfig.addControl.

Para conferir um exemplo desse método, consulte Gerenciar configurações de exibição.

Remover controles das configurações de exibição inline

Para remover um controle de uma configuração de veiculação, use ServingConfig.removeControl:

Para saber mais sobre esse método, consulte a referência da API ServingConfig.addControl.

Para conferir um exemplo desse método, consulte Gerenciar configurações de exibição.

Excluir um controle de exibição

Você pode excluir um controle de exibição do console ou in-line usando a propriedade Controls.delete.

Excluir um controle de exibição no console

Exclua um controle de exibição para removê-lo de todas as configurações de exibição que o usam.

1. Acesse a página Controles no console do Search for Retail.
   
   Acessar a página "Controles"

2. Na linha da tabela do controle que você pretende remover, clique em Excluir.

3. Na janela de confirmação, clique em Excluir para concluir o processo.

Excluir um controle de exibição inline

Para excluir controles de exibição inline, use Controls.delete.

Para saber mais sobre esse método, consulte a referência da API Controls.delete.

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls/SERVING_CONTROL_ID'

Exportar controles de veiculação

Visualização

Esse recurso está sujeito aos "Termos de ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos de serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

É possível exportar os controles de veiculação para um arquivo em um bucket do Cloud Storage.

Há dois motivos para exportar e importar controles de veiculação:

• Para mover os controles de veiculação de um projeto para outro.

• Para fazer uma edição em massa em todos ou alguns controles de exibição. Exportar a veiculação controles de configuração, edite o arquivo exportado e importe-o para alterar ou adicionar controles de veiculação.

É possível exportar e importar usando o console do Search for Retail. Ao exportar controles de veiculação, você exporta todos eles na projeto.

Para exportar os controles de veiculação, faça o seguinte:

1. Acesse a página Controles no console do Search for Retail.
   
   Acessar a página "Controles"

2. Na guia Controles de veiculação, clique em Exportar controles.

3. Na janela Exportar controles de veiculação, selecione o bucket do Cloud Storage. para o qual você quer exportar o arquivo de controles.

4. Clique em Exportar.

   Os controles exportados são salvos em um arquivo NDJSON no bucket selecionado com um nome no seguinte formato:

   projects_PROJECT_ID_TIMESTAMP_exported_controls.ndjson

5. Depois que a operação de exportação for concluída, você poderá ver o status da operação em a lista Importação, exportação e exclusão de atividades em massa na seção Exportar, atividade. Abra a janela Export activity clicando em Show. na janela da mensagem ou seguindo as instruções em Consultar o status de um operação de integração específica.

Importar controles de veiculação

Visualização

Esse recurso está sujeito aos "Termos de ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos de serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Para adicionar controles de exibição ou modificar os atuais em massa, faça as mudanças em um arquivo de controles exportado. Você pode importá-los para projeto original ou em uma outra projeto.

O que saber sobre a importação de controles de veiculação:

• Não é possível importar um arquivo de controle de veiculação se ele tiver ambos controles de veiculação de pesquisa e recomendações.

• Quando você importa controles de veiculação, todos os controles no arquivo são associados à configuração de veiculação especificada na importação. Se um controle de veiculação já estiver associado a outra configuração de veiculação no projeto, essa associação também será mantida.

Para importar controles de veiculação, faça o seguinte:

1. Edite e analise um arquivo de controle de veiculação exportado e coloque-o em um do bucket do Cloud Storage. Para exportar os controles de veiculação, consulte a tarefa anterior Exportar controles de veiculação.)

   Verifique se o arquivo contém apenas controles de veiculação de pesquisa ou apenas controles de veiculação de recomendações. Não é possível importar um arquivo que contenha os dois tipos.

2. Acesse a página Controles no console do Search for Retail.
   
   Acessar a página "Controles"

3. Na guia Controles de veiculação, clique em Importar controles.

4. Na janela Importar controles de veiculação:

   1. Procure e selecione o bucket do Cloud Storage e um arquivo NDJSON que contém os controles que quiser importar.

   2. Selecione a configuração de veiculação que você quer associar à veiculação importada. com os controles de segurança.

   3. Analise o plano de visualização da importação. Os controles que serão criados são exibidos na guia Novo e os controles que serão modificados são exibidos na guia Modificado.

5. Clique em Importar.

   Uma operação de longa duração é iniciada para importar os objetos controles de segurança.

6. Depois que a operação de importação for concluída, você poderá ver o status da operação na Guia Controles da janela Status da atividade. Abra a guia Atividade status clicando em Mostrar na janela da mensagem ou seguindo as instruções Consulte o status de uma operação de integração específica.