Changement de nom : le secteur de la vente au détail s'appelle Vertex AI Search pour le commerce. Nous sommes en train de mettre à jour le contenu pour refléter le nouveau branding.

Gérer les commandes de diffusion

Cette page explique comment afficher, modifier, supprimer, exporter et importer des commandes de diffusion.

Pour obtenir des informations générales sur les commandes de diffusion et des instructions sur la création de commandes de diffusion, consultez À propos des commandes de diffusion et Créer des commandes de diffusion.

Afficher et modifier les commandes de diffusion

Vous pouvez afficher les commandes de diffusion pour Vertex AI Search pour le commerce à l'aide de la console et de l'API.

Afficher et modifier les commandes de diffusion dans la console

L'onglet Commandes de diffusion de la page "Commandes" répertorie toutes vos commandes de diffusion et les configurations de diffusion associées. Cliquez sur l'icône Modifier la commande d'une commande pour modifier ses paramètres et les configurations de diffusion associées dans le panneau Modifier la commande. Cliquez sur l'icône Supprimer la commande pour supprimer une commande, ce qui la supprimera également de toutes les configurations de diffusion.

Vous pouvez également afficher et modifier les commandes d'une configuration de diffusion spécifique sur la page Configurations de diffusion. Cliquez sur une configuration de diffusion pour afficher sa page Détails, qui répertorie toutes les commandes de diffusion associées à cette configuration. Cliquez sur l'icône Modifier la commande d'une commande pour modifier ses paramètres dans le panneau Modifier la commande. Cliquez sur l'icône Supprimer la commande pour dissocier la commande de la configuration de diffusion (cela ne supprime pas la commande).

Il faut quelques minutes pour que les contrôles nouvellement créés ou mis à jour puissent diffuser le trafic en direct. Vous pouvez vérifier si vos modifications ont été appliquées sur la page Évaluer de la console.

Afficher les commandes de diffusion intégrées

Pour afficher une seule commande de diffusion intégrée, utilisez Control.get.

Pour en savoir plus sur cette méthode, consultez la documentation de référence de l'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'

Pour répertorier plusieurs commandes de diffusion intégrées, utilisez Controls.list.

Vous pouvez éventuellement utiliser le paramètre pageSize pour définir un nombre maximal de résultats à renvoyer. Si davantage de résultats sont disponibles, la réponse list inclut un jeton de page. Vous pouvez transmettre un jeton de page dans le paramètre pageToken d'une requête list pour récupérer la page de résultats suivante.

Pour ne répertorier que les commandes associées à une configuration de diffusion spécifique, utilisez le paramètre de requête filter afin de spécifier l'ID de la configuration de diffusion.

Pour en savoir plus sur cette méthode, consultez la documentation de référence de l'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

Commandes de diffusion de correctifs intégrées

Pour mettre à jour les champs d'une commande de diffusion, utilisez Controls.patch et incluez une instance de Control dans le corps de la requête. Spécifiez les champs à mettre à jour avec le paramètre updateMask ou ne le définissez pas pour mettre à jour tous les champs acceptés.

Pour en savoir plus sur cette méthode, consultez la documentation de référence de l'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'

Ajouter des commandes intégrées aux configurations de diffusion

Pour ajouter une commande à une configuration de diffusion, utilisez ServingConfig.addControl.

Pour en savoir plus sur cette méthode, consultez la documentation de référence de l'API ServingConfig.addControl.

Pour obtenir un exemple de cette méthode, consultez la page Gérer les configurations de diffusion.

Supprimer les commandes des configurations de diffusion intégrées

Pour supprimer une commande d'une configuration de diffusion, utilisez ServingConfig.removeControl.

Pour en savoir plus sur cette méthode, consultez la documentation de référence de l'API ServingConfig.addControl.

Pour obtenir un exemple de cette méthode, consultez la page Gérer les configurations de diffusion.

Supprimer un contrôle de diffusion

Vous pouvez supprimer une commande de diffusion depuis la console ou de façon intégrée à l'aide de la méthode Controls.delete.

Supprimer une commande de diffusion dans la console

Supprimez une commande de diffusion pour la retirer de toutes les configurations de diffusion qui l'utilisent.

Accédez à la page Commandes de la console Search for Retail.

Accéder à la page "Commandes"
Dans la ligne du tableau correspondant au contrôle que vous souhaitez supprimer, cliquez sur Supprimer.
Dans la fenêtre de confirmation, cliquez sur Supprimer pour terminer la suppression.

Supprimer une commande de diffusion intégrée

Pour supprimer des commandes de diffusion intégrées, utilisez Controls.delete.

Pour en savoir plus sur cette méthode, consultez la documentation de référence de l'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'

Exporter les commandes de diffusion

Vous pouvez exporter vos contrôles de diffusion vers un fichier hébergé dans un bucket Cloud Storage.

Il peut être utile d'exporter et d'importer des commandes de diffusion pour deux raisons:

Pour déplacer les commandes de diffusion d'un projet à un autre
Pour apporter des modifications groupées à l'ensemble des commandes de diffusion ou à certaines d'entre elles. Exportez les commandes de diffusion, modifiez le fichier exporté, puis importez-le pour modifier ou ajouter des commandes de diffusion.

Vous pouvez exporter et importer des données via la console Search for Retail. Lorsque vous exportez des commandes de diffusion, vous exportez toutes les commandes de diffusion du projet.

Pour exporter les commandes de diffusion, procédez comme suit:

Accédez à la page Commandes de la console Search for Retail.

Accéder à la page "Commandes"
Dans l'onglet Commandes de diffusion, cliquez sur Exporter les commandes.
Dans la fenêtre Exporter les commandes de diffusion, sélectionnez le bucket Cloud Storage vers lequel vous souhaitez exporter le fichier de commandes.
Cliquez sur Exporter.

Les commandes exportées sont enregistrées dans un fichier NDJSON dans le bucket sélectionné, sous un nom au format suivant:
```
projects_PROJECT_ID_TIMESTAMP_exported_controls.ndjson
```
Une fois l'opération d'exportation terminée, vous pouvez consulter l'état de l'opération dans la liste Activités d'importation, d'exportation et de suppression groupées de la fenêtre Activité d'exportation. Ouvrez la fenêtre Export activity (Exporter l'activité) en cliquant sur Show (Afficher) dans la fenêtre du message ou en suivant les instructions de la section Afficher l'état d'une opération d'intégration spécifique.

Importer des commandes de diffusion

Pour ajouter des commandes de diffusion ou modifier des commandes de diffusion existantes de façon groupée, vous pouvez effectuer vos modifications dans un fichier de commandes exporté. Vous pouvez ensuite les importer dans le projet d'origine ou dans un autre projet.

Remarques importantes sur l'importation des commandes de diffusion:

Vous ne pouvez pas importer un fichier de contrôle de diffusion s'il contient à la fois des commandes de diffusion de recherche et de recommandations.
Lorsque vous importez des commandes de diffusion, toutes les commandes de diffusion du fichier sont associées à la configuration de diffusion que vous spécifiez lors de l'importation. Si une commande de diffusion est déjà associée à une autre configuration de diffusion dans le projet, cette association est également conservée.

Pour importer des commandes d'inférence, procédez comme suit:

Modifier et examiner un fichier de contrôle de diffusion exporté, puis le placer dans un bucket Cloud Storage. (Pour exporter des commandes de diffusion, consultez la tâche précédente Exporter des commandes de diffusion.)

Assurez-vous que le fichier ne contient que des commandes de diffusion pour la recherche ou uniquement des commandes de diffusion des recommandations. Vous ne pouvez pas importer un fichier contenant ces deux types.
Accédez à la page Commandes de la console Search for Retail.

Accéder à la page "Commandes"
Dans l'onglet Commandes de diffusion, cliquez sur Commandes d'importation.
Dans la fenêtre Importer les commandes de diffusion:
1. Parcourez et sélectionnez le bucket Cloud Storage et le fichier NDJSON contenant les commandes que vous souhaitez importer.
2. Sélectionnez la configuration de diffusion à laquelle vous souhaitez associer les commandes de diffusion importées.
3. Vérifiez le plan d'aperçu des importations. Les commandes qui seront créées s'affichent dans l'onglet New (Nouveau), tandis que celles qui seront modifiées figurent dans l'onglet Modified (Modifié).
Cliquez sur Importer.

Une opération de longue durée est lancée pour importer les commandes nouvelles et modifiées.
Une fois l'opération d'importation terminée, vous pouvez consulter l'état de l'opération dans l'onglet Commandes de la fenêtre État de l'activité. Ouvrez la fenêtre État de l'activité en cliquant sur Afficher dans la fenêtre du message ou en suivant les instructions de la section Afficher l'état d'une opération d'intégration spécifique.