Gestire i controlli della pubblicazione

In questa pagina viene descritto 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.

Visualizzare e modificare i controlli di pubblicazione

Puoi visualizzare i controlli di pubblicazione per AI Commerce Search 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 un controllo per modificarne le impostazioni e le configurazioni di pubblicazione associate nel riquadro Modifica controllo. Fai clic sull'icona Elimina controllo per eliminare un controllo, che verrà rimosso anche da tutte le configurazioni di pubblicazione.

Puoi anche visualizzare e modificare i controlli per una configurazione di pubblicazione specifica su la 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 per un controllo per modificarne le impostazioni nel riquadro Modifica controllo. Fai clic sull'icona Rimuovi controllo per dissociare il controllo dalla configurazione di pubblicazione (il controllo non viene eliminato).

I controlli appena creati o aggiornati richiedono alcuni minuti per essere pronti a gestire il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate su la 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 Control.get riferimento 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'

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 della query filter per specificare l'ID della configurazione di pubblicazione.

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

Applicare patch ai 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 Controls.patch riferimento 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'

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 ServingConfig.addControl riferimento API.

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 ServingConfig.addControl riferimento API.

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 metodo Controls.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 in AI Commerce Search in Gemini Enterprise for Customer Experience console.

    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 Controls.delete riferimento 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'

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

Puoi esportare e importare tramite la console AI Commerce Search in Gemini Enterprise for Customer Experience. Quando esporti i controlli di pubblicazione, esporti tutti i controlli di pubblicazione del progetto.

Per esportare i controlli di pubblicazione:

  1. Vai alla pagina Controlli in AI Commerce Search in Gemini Enterprise for Customer Experience console.

    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, puoi visualizzare lo stato dell'operazione nell'elenco Attività di importazione, esportazione ed eliminazione collettiva 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 in blocco quelli esistenti, puoi apportare le modifiche in un file di controlli esportato. Puoi quindi importarli nel progetto originale o in un progetto diverso.

Informazioni importanti sull'importazione dei controlli di pubblicazione:

  • Non puoi importare un file di controlli di pubblicazione se contiene sia controlli di pubblicazione per la ricerca sia per le raccomandazioni.

  • 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, l'associazione viene mantenuta.

Per importare i controlli di pubblicazione:

  1. Modifica e rivedi un file di controlli di 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 controlli di pubblicazione per la ricerca o solo controlli di pubblicazione per le raccomandazioni. Non puoi importare un file che contiene entrambi i tipi.

  2. Vai alla pagina Controlli in AI Commerce Search in Gemini Enterprise for Customer Experience console.

    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 che vuoi importare.

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

    3. Rivedi il piano di anteprima dell'importazione. I controlli che verranno creati vengono visualizzati nella scheda Nuovo e i controlli 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.