Faça a gestão dos controlos de publicação

Esta página descreve como ver, editar, eliminar, exportar e importar controlos de publicação.

Para obter informações gerais sobre os controlos de publicação e instruções sobre como criar controlos de publicação, consulte os artigos Acerca dos controlos de publicação e Crie controlos de publicação.

Veja e edite controlos de publicação

Pode ver os controlos de publicação do Vertex AI Search para comércio através da consola e da API.

Veja e edite os controlos de publicação na consola

O separador Controlos de publicação da página Controlos apresenta todos os controlos de publicação e as respetivas configurações de publicação associadas. Clique no ícone Editar controlo de um controlo para alterar as respetivas definições e configurações de publicação associadas no painel Editar controlo. Clique no ícone Eliminar controlo para eliminar um controlo, o que também o remove de todas as configurações de publicação.

Também pode ver e editar os controlos de uma configuração de publicação específica na página Configurações de publicação. Clique numa configuração de publicação para ver a respetiva página Detalhes, que apresenta todos os controlos de publicação dessa configuração. Clique no ícone Editar controlo de um controlo para alterar as respetivas definições no painel Editar controlo. Clique no ícone Remover controlo para dissociar o controlo da configuração de publicação (isto não elimina o controlo).

Demora alguns minutos até que os controlos criados ou atualizados recentemente estejam prontos para publicar tráfego em direto. Pode testar se as alterações foram aplicadas na página Avaliar da consola.

Veja os controlos de publicação inline

Para ver um único controlo de publicação inline, use Control.get.

Para mais informações sobre este método, consulte a Control.get referência da API.

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 apresentar vários controlos de publicação inline, use Controls.list.

Opcionalmente, pode usar o parâmetro pageSize para definir um número máximo de resultados a devolver. Se estiverem disponíveis mais resultados, a resposta list inclui um token de página. Pode transmitir um token de página no parâmetro pageToken de um pedido para obter a página seguinte de resultados.list

Para listar apenas os controlos associados a uma determinada configuração de publicação, use o parâmetro de consulta filter para especificar o ID da configuração de publicação.

Para mais informações sobre este método, consulte a Control.list referência da API.

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

Controlos de publicação de patches inline

Para atualizar campos num controlo de publicação, use Controls.patch e inclua uma instância de Control no corpo do pedido. Especifique os campos a atualizar com o parâmetro updateMask ou deixe-o não definido para atualizar todos os campos suportados.

Para mais informações sobre este método, consulte a Controls.patch referência da API.

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'

Adicione controlos às configurações de publicação inline

Para adicionar um controlo a uma configuração de publicação, use ServingConfig.addControl.

Para mais informações sobre este método, consulte a ServingConfig.addControl referência da API.

Para ver um exemplo deste método, consulte o artigo Gerir configurações de publicação.

Remova os controlos das configurações de publicação incorporadas

Para remover um controlo de uma configuração de publicação, use ServingConfig.removeControl.

Para mais informações sobre este método, consulte a ServingConfig.addControl referência da API.

Para ver um exemplo deste método, consulte o artigo Gerir configurações de publicação.

Elimine um controlo de publicação

Pode eliminar um controlo de publicação a partir da consola ou inline através do método Controls.delete.

Elimine um controlo de publicação na consola

Elimine um controlo de publicação para o remover de todas as configurações de publicação que o estejam a usar.

  1. Aceda à página Controlos na consola de pesquisa para comércio.

    Aceda à página Controlos

  2. Na linha da tabela do controlo que planeia remover, clique em Eliminar.

  3. Na janela de confirmação, clique em Eliminar para concluir a eliminação.

Elimine um controlo de publicação inline

Para eliminar os controlos de publicação inline, use Controls.delete.

Para mais informações sobre este método, consulte a Controls.delete referência da API.

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'

Exporte controlos de publicação

Pode exportar os controlos de publicação para um ficheiro num contentor do Cloud Storage.

Existem dois motivos pelos quais pode querer exportar e importar controlos de publicação:

  • Para mover controlos de publicação de um projeto para outro.

  • Para fazer uma edição em massa em todos ou alguns controlos de publicação. Exporte os controlos de publicação, edite o ficheiro exportado e, em seguida, importe o ficheiro para alterar ou adicionar controlos de publicação.

Pode exportar e importar através da consola do Search for commerce. Quando exporta os controlos de publicação, exporta todos os controlos de publicação no projeto.

Para exportar controlos de publicação, faça o seguinte:

  1. Aceda à página Controlos na consola de pesquisa para comércio.

    Aceda à página Controlos

  2. No separador Controlos de publicação, clique em Exportar controlos.

  3. Na janela Exportar controlos de publicação, selecione o contentor do Cloud Storage para o qual quer exportar o ficheiro de controlos.

  4. Clique em Exportar.

    Os controlos exportados são guardados num ficheiro NDJSON no contentor selecionado com um nome no seguinte formato:

    projects_PROJECT_ID_TIMESTAMP_exported_controls.ndjson

  5. Após a conclusão da operação de exportação, pode ver o estado da operação na lista Importação, exportação e eliminação de atividades em massa na janela Exportar atividade. Abra a janela Exportar atividade clicando em Mostrar na janela de mensagem ou seguindo as instruções em Ver o estado de uma operação de integração específica.

Importe controlos de publicação

Para adicionar controlos de publicação ou modificar os existentes em massa, pode fazer as alterações num ficheiro de controlos exportado. Em seguida, pode importá-los para o projeto original ou para um projeto diferente.

Aspetos a ter em conta sobre a importação de controlos de publicação:

  • Não pode importar um ficheiro de controlo da publicação se contiver controlos da publicação de pesquisa e de recomendações.

  • Quando importa controlos de publicação, todos os controlos de publicação no ficheiro ficam associados à configuração de publicação que especificar na importação. Se um controlo de publicação já estiver associado a outra configuração de publicação no projeto, essa associação também é mantida.

Para importar controlos de publicação, faça o seguinte:

  1. Edite e reveja um ficheiro de controlo de publicação exportado e coloque o ficheiro num contentor do Cloud Storage. (Para exportar controlos de publicação, consulte a tarefa anterior Exporte controlos de publicação.)

    Certifique-se de que o ficheiro contém apenas controlos de publicação de pesquisas ou apenas controlos de publicação de recomendações. Não pode importar um ficheiro que contenha ambos os tipos.

  2. Aceda à página Controlos na consola de pesquisa para comércio.

    Aceda à página Controlos

  3. No separador Controlos de publicação, clique em Importar controlos.

  4. Na janela Importar controlos de publicação:

    1. Procure e selecione o contentor do Cloud Storage e o ficheiro NDJSON que contém os controlos que quer importar.

    2. Selecione a configuração de publicação à qual quer associar os controlos de publicação importados.

    3. Reveja o plano de pré-visualização da importação. Os controlos que vão ser criados são apresentados no separador Novo, e os controlos que vão ser modificados são apresentados no separador Modificado.

  5. Clique em Importar.

    É iniciada uma operação de longa duração para importar os controlos novos e modificados.

  6. Após a conclusão da operação de importação, pode ver o estado da operação no separador Controlos da janela Estado da atividade. Abra a janela Estado da atividade clicando em Mostrar na janela de mensagem ou seguindo as instruções em Ver o estado de uma operação de integração específica.