Gérer les commandes de diffusion

Cette page explique comment afficher, modifier, supprimer, exporter et importer des données .

Pour obtenir des informations générales sur les commandes de diffusion et des instructions sur la création des commandes de diffusion, consultez À propos des commandes de diffusion et Créez 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

La Onglet Contrôles de diffusion de la page "Commandes" affiche toutes les commandes de diffusion et les des configurations de diffusion. Cliquez sur l'icône Icône Modifier la commande d'une commande à modifier ses paramètres et les configurations de diffusion associées dans la commande Modifier panneau. Cliquez sur l'icône Supprimer la commande d'une commande pour la supprimer, ce qui la supprime é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 tous les des contrôles de diffusion pour cette configuration. Cliquez sur l'icône Modifier le contrôle d'un contrôle pour modifier ses paramètres dans le panneau Modifier le contrôle. Cliquez sur l'icône Supprimer la commande de dissocier la commande de la configuration de diffusion (cela ne supprime pas de 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 Évaluation de la console.

Afficher les commandes de diffusion en ligne

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

Pour en savoir plus sur cette méthode, consultez les 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 de manière intégrée, 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 list. pour récupérer la page suivante des résultats.

Pour ne lister que les commandes associées à 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

Commandes de diffusion des correctifs intégrées

Pour mettre à jour les champs d'une commande de diffusion, utilisez Controls.patch et inclure 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 les 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 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 les Documentation de référence de l'API ServingConfig.addControl

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

Suppression intégrée des commandes des configurations de diffusion

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 section Gérer les configurations de diffusion.

Supprimer un contrôle de diffusion

Vous pouvez supprimer un contrôle de diffusion à partir de la console ou en ligne à 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.

  1. Accédez à la page Paramètres de la console Search for Retail.

    Accéder à la page "Commandes"

  2. Dans la ligne du tableau correspondant au contrôle que vous souhaitez supprimer, cliquez sur Supprimer.

  3. 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 les 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 des commandes de diffusion d'un projet à un autre.

  • Pour effectuer une modification groupée sur tout ou partie des commandes de diffusion : Exporter la diffusion modifier le fichier exporté, puis l'importer pour modifier ou ajouter des commandes de diffusion.

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

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

  1. Accédez à la page Commandes dans la console de la recherche pour les marchands.

    Accéder à la page "Commandes"

  2. Dans l'onglet Commandes de diffusion, cliquez sur Exporter les commandes.

  3. Dans la fenêtre Exporter les commandes de diffusion, sélectionnez le bucket Cloud Storage. vers lequel vous souhaitez exporter le fichier de contrôles.

  4. Cliquez sur Exporter.

    Les commandes exportées sont enregistrées dans un fichier NDJSON dans le bucket sélectionné avec un nom au format suivant :

    projects_PROJECT_ID_TIMESTAMP_exported_controls.ndjson

  5. Une fois l'opération d'exportation terminée, vous pouvez voir son état dans la liste Importation, exportation, suppression d'activités de la page Exporter 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 Consulter 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 existantes de façon groupée, vous pouvez définir vos dans un fichier de contrôles exporté. Vous pouvez ensuite les importer dans le projet d'origine ou dans une autre projet.

Points à retenir concernant l'importation de commandes de diffusion:

  • Vous ne pouvez pas importer un fichier de commandes de diffusion s'il contient à la fois des commandes de diffusion pour la recherche et les recommandations.

  • Lorsque vous importez des commandes de diffusion, toutes les commandes de diffusion du fichier deviennent associée à 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 maintenue.

Pour importer des commandes de diffusion, procédez comme suit:

  1. Modifiez et examinez un fichier de commande 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 résultats de recherche ou de diffusion de recommandations. Vous ne pouvez pas importer un fichier contenant les deux types.

  2. Accédez à la page Commandes dans la console de la recherche pour les marchands.

    Accéder à la page "Commandes"

  3. Dans l'onglet Commandes de diffusion, cliquez sur Importer des commandes.

  4. Dans la fenêtre Importer des 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. Examinez le plan d'aperçu des importations. Les commandes créées sont affichées dans l'onglet Nouveau et les commandes qui seront s'affichent dans l'onglet Modifications.

  5. Cliquez sur Importer.

    Une opération de longue durée est lancée pour importer les commandes nouvelles et modifiées.

  6. Une fois l'opération d'importation terminée, vous pouvez consulter son état dans l'onglet Commandes de la fenêtre État de l'activité. Ouvrez la Activité état en cliquant sur Afficher dans la fenêtre du message ou en suivant les instructions fournies dans Afficher l'état d'une opération d'intégration spécifique