Gestire i controlli di pubblicazione

Questa pagina descrive come visualizzare, modificare, eliminare, esportare e importare i controlli di pubblicazione.

Per informazioni generali sui controlli di pubblicazione e istruzioni su come crearli, consulta Informazioni sui controlli di pubblicazione e Creare controlli di pubblicazione.

Visualizzare e modificare i controlli di pubblicazione

Puoi visualizzare i controlli di pubblicazione per Vertex AI Search for Commerce utilizzando la console e l'API.

Visualizzare e modificare i controlli di pubblicazione nella console

La scheda Controlli di pubblicazione della pagina Controlli elenca tutti i controlli di pubblicazione e le relative configurazioni di pubblicazione. Fai clic sull'icona Modifica controllo per modificare le impostazioni e le configurazioni di gestione associate di un controllo nel riquadro Modifica controllo. Fai clic sull'icona Elimina controllo per eliminare un controllo, che viene rimosso anche da tutte le configurazioni di gestione.

Puoi anche visualizzare e modificare i controlli per una configurazione di pubblicazione specifica nella pagina Configurazioni di pubblicazione. Fai clic su una configurazione di pubblicazione per visualizzare la pagina Dettagli, che elenca tutti i controlli di pubblicazione per quella configurazione. Fai clic sull'icona Modifica controllo per modificare le impostazioni di un controllo nel riquadro Modifica controllo. Fai clic sull'icona Rimuovi controllo per dissociare il controllo dalla configurazione di pubblicazione (in questo modo il controllo non viene eliminato).

L'applicazione dei controlli appena creati o aggiornati richiede alcuni minuti. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Visualizzare i controlli di pubblicazione in linea

Per visualizzare un singolo controllo di pubblicazione in linea, utilizza Control.get.

Per saperne di più su questo metodo, consulta il riferimento 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'

Per elencare più controlli di pubblicazione in linea, utilizza Controls.list.

Se vuoi, puoi utilizzare il parametro pageSize per impostare un numero massimo di risultati da restituire. Se sono disponibili altri risultati, la risposta list include un token di pagina. Puoi passare un token di pagina nel parametro pageToken di una richiesta list per recuperare la pagina successiva dei risultati.

Per elencare solo i controlli associati a una determinata configurazione di pubblicazione, utilizza il parametro di query filter per specificare l'ID configurazione di pubblicazione.

Per saperne di più su questo metodo, consulta il riferimento 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

Controlli di pubblicazione delle patch in linea

Per aggiornare i campi in un controllo di pubblicazione, utilizza Controls.patch e includi un'istanza di Control nel corpo della richiesta. Specifica i campi da aggiornare con il parametro updateMask oppure lascialo non impostato per aggiornare tutti i campi supportati.

Per saperne di più su questo metodo, consulta il riferimento 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'

Aggiungere controlli alle configurazioni di pubblicazione in linea

Per aggiungere un controllo a una configurazione di pubblicazione, utilizza ServingConfig.addControl.

Per saperne di più su questo metodo, consulta il riferimento API ServingConfig.addControl.

Per un esempio di questo metodo, vedi Gestire le configurazioni di pubblicazione.

Rimuovere i controlli dalle configurazioni di pubblicazione in linea

Per rimuovere un controllo da una configurazione di pubblicazione, utilizza ServingConfig.removeControl.

Per saperne di più su questo metodo, consulta il riferimento API ServingConfig.addControl.

Per un esempio di questo metodo, vedi Gestire le configurazioni di pubblicazione.

Eliminare un controllo di pubblicazione

Puoi eliminare un controllo di pubblicazione dalla console o in linea utilizzando il metodo Controls.delete.

Eliminare un controllo di pubblicazione nella console

Elimina un controllo di gestione per rimuoverlo da tutte le configurazioni di gestione che lo utilizzano.

  1. Vai alla pagina Controlli nella console Search for commerce.

    Vai alla pagina Controlli

  2. Nella riga della tabella del controllo che prevedi di rimuovere, fai clic su Elimina.

  3. Nella finestra di conferma, fai clic su Elimina per completare l'eliminazione.

Elimina un controllo di pubblicazione inline

Per eliminare i controlli di pubblicazione inline, utilizza Controls.delete.

Per saperne di più su questo metodo, consulta il riferimento 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'

Esporta controlli di pubblicazione

Puoi esportare i controlli di pubblicazione in un file in un bucket Cloud Storage.

Esistono due motivi per cui potresti voler esportare e importare i controlli di pubblicazione:

  • Per spostare i controlli di pubblicazione da un progetto all'altro.

  • Per eseguire una modifica collettiva su tutti o alcuni controlli di pubblicazione. Esporta i controlli di pubblicazione, modifica il file esportato e poi importalo per modificare o aggiungere controlli di pubblicazione.

Puoi esportare e importare tramite la console Search for Commerce. Quando esporti i controlli di pubblicazione, vengono esportati tutti i controlli di pubblicazione del progetto.

Per esportare i controlli di pubblicazione:

  1. Vai alla pagina Controlli nella console Search for commerce.

    Vai alla pagina Controlli

  2. Nella scheda Controlli di pubblicazione, fai clic su Esporta controlli.

  3. Nella finestra Esporta controlli di pubblicazione, seleziona il bucket Cloud Storage in cui vuoi esportare il file dei controlli.

  4. Fai clic su Esporta.

    I controlli esportati vengono salvati in un file NDJSON nel bucket selezionato con un nome nel seguente formato:

    projects_PROJECT_ID_TIMESTAMP_exported_controls.ndjson
  5. Una volta completata l'operazione di esportazione, puoi visualizzarne lo stato nell'elenco Importazione, esportazione ed eliminazione collettive nella finestra Attività di esportazione. Apri la finestra Esporta attività facendo clic su Mostra nella finestra del messaggio o seguendo le istruzioni riportate in Visualizzare lo stato di un'operazione di integrazione specifica.

Importa controlli di pubblicazione

Per aggiungere controlli di pubblicazione o modificare quelli esistenti in blocco, puoi apportare le modifiche in un file di controlli esportato. Puoi quindi importarli nel progetto originale o in un altro progetto.

Cose da sapere sull'importazione dei controlli di pubblicazione:

  • Non puoi importare un file di controllo della pubblicazione se contiene controlli della pubblicazione per la ricerca e per i consigli.

  • Quando importi i controlli di pubblicazione, tutti i controlli di pubblicazione nel file vengono associati alla configurazione di pubblicazione che specifichi durante l'importazione. Se un controllo di pubblicazione è già associato a un'altra configurazione di pubblicazione nel progetto, viene mantenuta anche questa associazione.

Per importare i controlli di pubblicazione:

  1. Modifica ed esamina un file di controllo di pubblicazione esportato e inseriscilo in un bucket Cloud Storage. Per esportare i controlli di pubblicazione, consulta l'attività precedente Esportare controlli di pubblicazione.

    Assicurati che il file contenga solo controlli di pubblicazione della ricerca o solo controlli di pubblicazione dei consigli. Non puoi importare un file che contiene entrambi i tipi.

  2. Vai alla pagina Controlli nella console Search for commerce.

    Vai alla pagina Controlli

  3. Nella scheda Controlli di pubblicazione, fai clic su Importa controlli.

  4. Nella finestra Importa controlli di pubblicazione:

    1. Sfoglia e seleziona il bucket Cloud Storage e il file NDJSON contenente i controlli che vuoi importare.

    2. Seleziona la configurazione di pubblicazione a cui vuoi associare i controlli di pubblicazione importati.

    3. Controlla il piano di anteprima dell'importazione. I controlli che verranno creati vengono visualizzati nella scheda Nuovo, mentre quelli che verranno modificati vengono visualizzati nella scheda Modificato.

  5. Fai clic su Importa.

    Viene avviata un'operazione a lunga esecuzione per importare i controlli nuovi e modificati.

  6. Al termine dell'operazione di importazione, puoi visualizzare lo stato dell'operazione nella scheda Controlli della finestra Stato attività. Apri la finestra Stato attività facendo clic su Mostra nella finestra del messaggio o seguendo le istruzioni riportate in Visualizzare lo stato di un'operazione di integrazione specifica.