Gerenciar controles de disponibilização

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

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

Acessar e editar controles de exibição

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

Conferir e editar controles de exibiçã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 associadas. Clique no ícone Editar controle para mudar as configurações e as configurações de exibição associadas no painel Editar controle. Clique no ícone Excluir controle para excluir um controle, o que também o remove de todas as configurações de exibição.

Também é possível conferir e editar os controles de uma configuração de exibição específica na 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 ícone Editar controle para mudar as configurações no painel Editar controle. Clique no ícone Remover controle para desvincular o controle da configuração de exibição. Isso não exclui o controle.

Leva alguns minutos para que os controles recém-criados ou atualizados estejam prontos para exibir o tráfego em tempo real. É possível testar se as mudanças foram aplicadas na página Avaliar do console.

Conferir controles de veiculação inline

Para ver um único controle de veiculação inline, 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 exibição inline, use Controls.list.

Também é possível usar 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 vai incluir um token de página. É possível transmitir um token de página no parâmetro pageToken de uma solicitação list para recuperar a próxima página de resultados.

Para listar apenas os controles associados a uma determinada configuração de exibição, use o parâmetro de consulta filter para especificar o ID da configuração de exibiçã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 os campos a serem atualizados com o parâmetro updateMask ou deixe-o indefinido para atualizar todos os campos com suporte.

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 veiculação.

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

Para remover um controle de uma configuração de exibiçã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 veiculação.

Excluir um controle de exibição

É possível excluir um controle de veiculação do console ou inline usando o método Controls.delete.

Excluir um controle de exibição no console

Exclua um controle de exibição para remover esse controle de todas as configurações de exibição que o usam.

1. Acesse a página Controles no console da Pesquisa para varejo.
   
   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.

Você pode exportar e importar controles de veiculação por dois motivos:

• 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. Exporte os controles de veiculação, edite o arquivo exportado e importe-o para mudar ou adicionar controles de veiculação.

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

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

1. Acesse a página Controles no console da Pesquisa para varejo.
   
   Acessar a página "Controles"

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

3. Na janela Export Serving Controls, 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á conferir o status da operação na lista Importação, exportação e exclusão em massa na janela Atividade de exportação. Abra a janela Export activity clicando em Show na janela de mensagem ou seguindo as instruções em Conferir o status de uma 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. Em seguida, você pode importá-los para o projeto original ou para outro.

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 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 revise um arquivo de controle de veiculação exportado e coloque o arquivo em um 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 da Pesquisa para varejo.
   
   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 o arquivo NDJSON que contém os controles que você quer importar.

   2. Selecione a configuração de veiculação que você quer associar aos controles de veiculação importados.

   3. Analise o plano de visualização da importação. Os controles que serão criados são exibidos na guia New, e os que serão modificados são mostrados na guia Modified.

5. Clique em Importar.

   Uma operação de longa duração é iniciada para importar os controles novos e modificados.

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