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 per il retail utilizzando la console e l'API.

Visualizzare e modificare i controlli di pubblicazione nella console

La scheda Controlli pubblicazione della pagina Controlli elenca tutti i controlli pubblicazione e le relative configurazioni associate. Fai clic sull'icona editModifica controllo per un controllo per modificarne le impostazioni e le configurazioni di pubblicazione associate nel riquadro Modifica controllo. Fai clic sull'icona deleteElimina controllo per un controllo per eliminarlo e rimuoverlo da tutte le configurazioni di pubblicazione.

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 visualizzarne la pagina Dettagli, che elenca tutti i controlli di pubblicazione per quella configurazione. Fai clic sull'icona editModifica controllo di un controllo per modificarne le impostazioni nel riquadro Modifica controllo. Fai clic sull'icona do_not_disturb_onRimuovi controllo per disaccoppiare il controllo dalla configurazione di pubblicazione (il controllo non viene eliminato).

I controlli appena creati o aggiornati possono richiedere alcuni minuti prima di essere pronti per gestire il traffico in tempo reale. 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 all'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.

Facoltativamente, 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 pagina. Puoi passare un token di pagina nel parametro pageToken di una richiesta list per recuperare la pagina di 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 saperne di più su questo metodo, consulta il riferimento all'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

Eseguire il patching dei controlli di pubblicazione 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 o lascialo non impostato per aggiornare tutti i campi supportati.

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

Per un esempio di questo metodo, consulta 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 all'API ServingConfig.addControl.

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

Eliminare un controllo di pubblicazione

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

Eliminare 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 Ricerca per la vendita al dettaglio.
   
   Vai alla pagina Controlli

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

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

Eliminare un controllo di pubblicazione in linea

Per eliminare i controlli di pubblicazione in linea, utilizza Controls.delete.

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

Esportare i 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 i controlli di pubblicazione.

Puoi esportare e importare tramite la console Ricerca per la vendita al dettaglio. Quando esporti i controlli di pubblicazione, vengono esportati tutti i controlli di pubblicazione nel project.

Per esportare i controlli di pubblicazione:

1. Vai alla pagina Controlli nella console Ricerca per la vendita al dettaglio.
   
   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 di 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, puoi visualizzare lo stato dell'operazione nell'elenco Attività di importazione, esportazione ed eliminazione collettive nella finestra Attività di esportazione. Apri la finestra Attività di esportazione facendo clic su Mostra nella finestra del messaggio o seguendo le istruzioni riportate in Visualizzare lo stato di un'operazione di integrazione specifica.

Importare i controlli di pubblicazione

Per aggiungere controlli di pubblicazione o modificarne collettivamente quelli esistenti, puoi apportare le modifiche in un file dei 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 di pubblicazione se contiene sia controlli di pubblicazione per la ricerca sia per i consigli.

• 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 e rivedi un file di controllo della pubblicazione esportato e posiziona il file 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 rete di ricerca o solo controlli di pubblicazione dei consigli. Non puoi importare un file che contenga entrambi i tipi.

2. Vai alla pagina Controlli nella console Ricerca per la vendita al dettaglio.
   
   Vai alla pagina Controlli

3. Nella scheda Controlli 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. 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 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.