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 creare controlli di pubblicazione, consulta Informazioni sui controlli di pubblicazione e Creare controlli di pubblicazione.

Visualizza e modifica i controlli di pubblicazione

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

Visualizza e modifica 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 associate. Fai clic sull'icona Modifica controllo per un controllo per modificare le sue impostazioni e le configurazioni di pubblicazione associate nel pannello Controllo di modifica. Fai clic sull'icona Elimina controllo per un controllo per eliminarlo, in modo da rimuoverlo anche da tutte le configurazioni di pubblicazione.

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

Sono necessari alcuni minuti perché i controlli appena creati o aggiornati siano pronti per pubblicare il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Visualizza controlli di pubblicazione incorporati

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

Per ulteriori informazioni su questo metodo, consulta la documentazione di riferimento dell'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 incorporati, utilizza il criterio Controls.list.

Facoltativamente, puoi utilizzare il parametro pageSize per impostare un numero massimo di risultati da restituire. Se sono disponibili più 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 dei risultati successiva.

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 ulteriori informazioni su questo metodo, consulta la documentazione di riferimento dell'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 incorporati

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 ulteriori informazioni su questo metodo, consulta la documentazione di riferimento dell'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'

Aggiungi controlli alle configurazioni di pubblicazione in linea

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

Per ulteriori informazioni su questo metodo, consulta la documentazione di riferimento dell'API ServingConfig.addControl.

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

Rimuovi controlli dalle configurazioni di pubblicazione incorporati

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

Per ulteriori informazioni su questo metodo, consulta la documentazione di riferimento dell'API ServingConfig.addControl.

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

Elimina un controllo di pubblicazione

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

Elimina un controllo di pubblicazione nella console

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

  1. Vai alla pagina Controlli nella console di Search for Retail.

    Vai alla pagina Controlli

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

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

Elimina un controllo di pubblicazione incorporato

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

Per ulteriori informazioni su questo metodo, consulta la documentazione di riferimento dell'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 di 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 importa il file per modificare o aggiungere controlli di pubblicazione.

Puoi esportare e importare tramite la console di Search for Retail. Quando esporti i controlli di pubblicazione, esporti tutti i controlli di pubblicazione nel progetto.

Per esportare i controlli di pubblicazione:

  1. Vai alla pagina Controlli nella console di Search for Retail.

    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. Al termine dell'operazione di esportazione, potrai visualizzarne lo stato nell'elenco Importazione, esportazione ed eliminazione collettiva delle attività nella finestra Esporta attività. 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.

Informazioni importanti sull'importazione dei controlli di pubblicazione:

  • Non puoi importare un file di controllo della pubblicazione se contiene controlli per la pubblicazione sia di ricerca sia di suggerimenti.

  • Quando importi i controlli di pubblicazione, tutti i controlli di pubblicazione nel file vengono associati alla configurazione di pubblicazione specificata al momento dell'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 della pubblicazione esportato e inseriscilo in un bucket Cloud Storage. Per esportare i controlli di pubblicazione, consulta l'attività precedente Esportare i controlli di pubblicazione.

    Assicurati che il file contenga solo i controlli di pubblicazione delle ricerche o solo i controlli di pubblicazione dei suggerimenti. Non puoi importare un file contenente entrambi i tipi.

  2. Vai alla pagina Controlli nella console di Search for Retail.

    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 che contiene i controlli da importare.

    2. Seleziona la configurazione di pubblicazione che vuoi associare ai controlli di pubblicazione importati.

    3. Esamina 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 Modificati.

  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 visualizzarne lo stato nella scheda Controlli della finestra Stato attività. Apri la finestra Stato dell'attività facendo clic su Mostra nella finestra del messaggio o seguendo le istruzioni riportate in Visualizzare lo stato di un'operazione di integrazione specifica.