Gestire i controlli di pubblicazione

In questa pagina viene descritto come visualizzare, modificare, eliminare, esportare e importare la pubblicazione i controlli di sicurezza.

Per informazioni generali sui controlli di pubblicazione e istruzioni su come creare sui controlli di pubblicazione, consulta Informazioni sui controlli di pubblicazione e Crea 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.

Visualizza e modifica 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 Modifica controllo per modificare un controllo le impostazioni e le configurazioni di pubblicazione associate nel controllo Modifica dal riquadro. Fai clic sull'icona Elimina 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 in la pagina Configurazioni di pubblicazione. Fai clic su una configurazione di pubblicazione per visualizzare la relativa pagina Dettagli, in cui sono elencate tutte i controlli di pubblicazione per quella configurazione. Fai clic sull' Icona Modifica controllo per modificare un controllo le relative impostazioni nel pannello Modifica controllo. Fai clic sull' Rimuovi controllo per dissociare il controllo dalla configurazione di pubblicazione (questa operazione non elimina .

Occorrono alcuni minuti prima che i controlli appena creati o aggiornati siano pronti per gestire il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Visualizza i controlli di pubblicazione in linea

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

Per ulteriori informazioni su questo metodo, consulta 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.

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 della 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 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 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, consulta Gestire le configurazioni di pubblicazione.

Rimuovi i controlli dalle configurazioni di pubblicazione in linea

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

Per ulteriori informazioni su questo metodo, consulta Riferimento API ServingConfig.addControl.

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

Eliminare un controllo di pubblicazione

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

Eliminare un controllo di pubblicazione nella console

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

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

    Vai alla pagina Controlli

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

  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 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 la pubblicazione i controlli, modificare il file esportato e poi importare il file per modificarlo o aggiungerlo i controlli di pubblicazione.

Puoi eseguire l'esportazione e l'importazione 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 per la pubblicazione, fai clic su Controlli di esportazione.

  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 visualizzarne lo stato nell'elenco Attività di 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 in Visualizzare lo stato di una una specifica operazione di integrazione.

Importare i controlli di pubblicazione

Per aggiungere controlli di pubblicazione o modificare collettivamente quelli esistenti, puoi creare modifiche in un file di controlli esportato. Puoi quindi importarli in progetto originale o in un altro progetto.

Informazioni importanti sull'importazione dei controlli di pubblicazione:

  • Non puoi importare un file di controllo della pubblicazione se contiene entrambi controlli di pubblicazione di ricerche e 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 il controllo di pubblicazione è già associato a un'altra configurazione di pubblicazione in progetto, viene mantenuta anche l'associazione.

Per importare i controlli di pubblicazione:

  1. Modifica e rivedi un file di controllo della pubblicazione esportato e posizionalo in una nel 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 che contiene i controlli che vuoi importare.

    2. Seleziona la configurazione di pubblicazione che vuoi associare alla pubblicazione importata per i controlli di sicurezza.

    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 nuovi e gli elementi modificati i controlli di sicurezza.

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