Cette page explique comment afficher, modifier, supprimer, exporter et importer des commandes de diffusion.
Pour obtenir des informations générales sur les contrôles de diffusion et savoir comment les créer, consultez À propos des contrôles de diffusion et Créer des contrôles de diffusion.
Afficher et modifier les contrôles 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 contrôles de diffusion dans la console
L'onglet "Contrôles de diffusion" de la page "Contrôles" répertorie tous vos contrôles de diffusion ainsi que les configurations de diffusion associées. Cliquez sur l'icône editModifier le contrôle pour modifier les paramètres d'un contrôle et les configurations de diffusion associées dans le panneau Modifier le contrôle. Cliquez sur l'icône deleteSupprimer le contrôle pour supprimer un contrôle et le retirer de toutes les configurations de diffusion.
Vous pouvez également consulter et modifier les contrôles 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 tous les contrôles de diffusion pour cette configuration. Cliquez sur l'icône editModifier le contrôle d'un contrôle pour modifier ses paramètres dans le panneau Modifier le contrôle. Cliquez sur l'icône do_not_disturb_onSupprimer le contrôle pour dissocier le contrôle de la configuration de diffusion (cela ne supprime pas le contrôle).
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 un contrôle de diffusion unique intégré, 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 lister plusieurs contrôles de diffusion en ligne, utilisez Controls.list
.
Vous pouvez éventuellement utiliser le paramètre pageSize
pour définir un nombre maximal de résultats à renvoyer. Si d'autres 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 n'afficher que les contrôles associés à une configuration de diffusion spécifique, utilisez le paramètre de requête filter
pour 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
Modifier les commandes de diffusion de manière intégrée
Pour mettre à jour les champs d'un contrôle 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 laissez-le non défini pour mettre à jour tous les champs compatibles.
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 contrôles aux configurations de diffusion de manière intégrée
Pour ajouter un contrôle à 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 Gérer les configurations de diffusion.
Supprimer des contrôles des configurations de diffusion de manière intégrée
Pour supprimer un contrôle 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 Gérer les configurations de diffusion.
Supprimer un contrôle de diffusion
Vous pouvez supprimer un contrôle de diffusion depuis la console ou de manière intégrée à l'aide de la méthode Controls.delete
.
Supprimer un contrôle de diffusion dans la console
Supprimez un contrôle de diffusion pour le supprimer de toutes les configurations de diffusion qui l'utilisent.
Accédez à la page Contrôles dans la console Search for Commerce.
Accéder à la page "Contrôles"Dans la ligne du tableau correspondant au contrôle que vous souhaitez supprimer, cliquez sur deleteSupprimer.
Dans la fenêtre de confirmation, cliquez sur Supprimer pour terminer la suppression.
Supprimer un contrôle de diffusion intégré
Pour supprimer des contrôles de diffusion intégrés, 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 commandes de diffusion vers un fichier dans un bucket Cloud Storage.
Vous pouvez exporter et importer des commandes de diffusion pour deux raisons :
Pour déplacer les commandes de diffusion d'un projet vers un autre.
Pour effectuer une modification groupée sur tout ou partie des contrôles de diffusion. 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 Commerce. Lorsque vous exportez des commandes de diffusion, vous exportez toutes celles du projet.
Pour exporter des commandes de diffusion :
Accédez à la page Contrôles dans la console Search for Commerce.
Accéder à la page "Contrôles"Dans l'onglet Contrôles de diffusion, cliquez sur Exporter les contrôles.
Dans la fenêtre Exporter les contrôles de diffusion, sélectionnez le bucket Cloud Storage vers lequel vous souhaitez exporter le fichier de contrôles.
Cliquez sur Exporter.
Les contrôles exportés sont enregistrés dans un fichier NDJSON dans le bucket sélectionné, avec un nom au format suivant :
projects_PROJECT_ID_TIMESTAMP_exported_controls.ndjson
Une fois l'opération d'exportation terminée, vous pouvez consulter son état dans la liste Importation, exportation et suppression groupées d'activités de la fenêtre Exporter l'activité. Ouvrez la fenêtre Exporter l'activité en cliquant sur Afficher dans la fenêtre de 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 contrôles d'inférence ou modifier ceux existants de manière groupée, vous pouvez apporter vos modifications dans un fichier de contrôles exporté. Vous pouvez ensuite les importer dans le projet d'origine ou dans un autre projet.
Voici ce que vous devez savoir sur l'importation de commandes de diffusion :
Vous ne pouvez pas importer de fichier de commandes de diffusion s'il contient à la fois des commandes de diffusion pour la recherche et pour les 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 contrôles de diffusion :
Modifiez et vérifiez un fichier de commandes de diffusion exporté, puis placez-le 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 de la recherche ou des commandes de diffusion des recommandations. Vous ne pouvez pas importer de fichier contenant les deux types.
Accédez à la page Contrôles dans la console Search for Commerce.
Accéder à la page "Contrôles"Dans l'onglet Contrôles de diffusion, cliquez sur Importer des contrôles.
Dans la fenêtre Importer des commandes de diffusion :
Parcourez et sélectionnez le bucket Cloud Storage et le fichier NDJSON contenant les contrôles que vous souhaitez importer.
Sélectionnez la configuration de diffusion à laquelle vous souhaitez associer les commandes de diffusion importées.
Examinez le plan d'aperçu de l'importation. Les contrôles qui seront créés sont affichés dans l'onglet Nouveau, et ceux qui seront modifiés sont affichés dans l'onglet Modifié.
Cliquez sur Importer.
Une opération de longue durée est lancée pour importer les contrôles nouveaux et modifiés.
Une fois l'opération d'importation terminée, vous pouvez consulter son état dans l'onglet Contrôles de la fenêtre État de l'activité. Ouvrez la fenêtre État de l'activité en cliquant sur Afficher dans la fenêtre de message ou en suivant les instructions de Afficher l'état d'une opération d'intégration spécifique.