Retail est renommé Vertex AI Search pour le commerce. Nous sommes en train de mettre à jour le contenu pour refléter le nouveau branding.

Cette page a été traduite par l'API Cloud Translation.

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 contrôles de diffusion et des instructions pour les créer, consultez les pages À propos des contrôles de diffusion et Créer des contrôles 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 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 Modifier le contrôle d'un contrôle pour modifier ses paramètres et les configurations de diffusion associées dans le panneau Modifier le contrôle. 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 consulter 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 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 le contrôle pour dissocier le contrôle de la configuration de diffusion (cela ne le supprime pas).

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 en ligne

Pour afficher un seul contrôle de diffusion en ligne, 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 commandes 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 commandes associées à une certaine configuration de diffusion, utilisez le paramètre de requête filter pour spécifier l'ID de 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'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 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 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 les commandes des configurations de diffusion intégrées

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 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.

Accédez à la page Commandes dans la console de la recherche pour les établissements commerciaux.

Accéder à la page "Contrôles"
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 un contrôle de diffusion intégré

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 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 l'ensemble ou une 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 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:

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

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 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é 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 Importer, exporter et supprimer des activités de manière groupée de la fenêtre Exporter une activité. Ouvrez la fenêtre Activité d'exportation 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 en modifier plusieurs à la fois, vous pouvez apporter vos modifications dans un fichier de commandes exporté. Vous pouvez ensuite les importer dans le projet d'origine ou dans un autre projet.

Informations importantes à connaître sur 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 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 maintenue.

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

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.
Accédez à la page Commandes dans la console de la recherche pour les établissements commerciaux.

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:
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. Consultez le plan d'aperçu de l'importation. Les commandes qui seront créées s'affichent dans l'onglet Nouveau, et celles qui seront modifiées s'affichent dans l'onglet 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 son état 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 de message ou en suivant les instructions de la section Afficher l'état d'une opération d'intégration spécifique.