Cette page explique comment créer et mettre à jour de façon programmatique les sources de données qui vous permettent d'insérer des produits. Données automatisées sources facilitent l'envoi vos données produit à Google. Les sources de données automatisées permettent aux utilisateurs des informations à jour sur des produits pertinents provenant de votre site Web parviennent à Google.
Content API for Shopping vous permet uniquement de créer des sources de données principales. Avec Merchant Data Sources API, vous pouvez créer les types de sources de données suivants:
- Sources principales de données produit
- Sources de données produit supplémentaires
- Sources de données d'inventaire en magasin
- Sources de données d'inventaire régional
- Sources de données des promotions
Content API for Shopping ne permettait de gérer que les sources de données contenant des fichiers. L'API Merchant Center vous permet de gérer les sources de données avec des entrées de fichier et d'API.
L'API Merchant Data Sources vous permet d'effectuer les opérations suivantes:
- Créer une source de données principale avec un
feedLabel
spécifique etcontentLanguage
- Créez une source de données générique. Une source de données générique ne contient pas
feedLabel
etcontentLanguage
définis. Avec les sources de données génériques, vous pouvez insérer avec différentes combinaisons defeedLabel
etcontentLanguage
une source de données. - Créez une source de données supplémentaire à associer à une source de données principale existante.
- Planifier la source de données d'un fichier.
- Inscrivez votre compte pour la gestion automatique des sources de données.
- Gérer les sources de données de l'API
- Gérez la règle par défaut des sources de données à l'aide des sources de données produit principales.
- Utilisez d'autres types de sources de données, comme les promotions.
Prérequis
- Votre compte doit avoir été migré vers des flux pour un seul paramètre régional.
Pour vérifier que le compte a déjà fait l'objet d'une migration vers la répartition cible de données, utilisez la liste de sources de données ou méthodes get. Si vous n'êtes pas éligible, vous recevrez le message d'exception suivant. Contactez l'assistance.
This account is in the data sources migration process and can't be used with this API yet. Contact support for more info on when this account will be able to use the data sources endpoint.
Créer une source de données
Pour créer une source de données principale avec un feedLabel
spécifique et
contentLanguage
, définissez les champs feedLabel
et contentLanguage
dans
configuration spécifique au type. Par exemple, PrimaryProductDataSource
.
Pour afficher la source de données que vous venez de créer, créez une requête GET
ou LIST
.
Créer une source de données principale avec un caractère générique
Pour créer un flux principal avec des caractères génériques, configurez votre source de données à l'aide de la méthode
PrimaryProductDataSource
et ne définissez pas les champs feedLabel
et contentLanguage
.
Avec Content API for Shopping, il n'existe qu'une seule source de données API créée pour vous. L'API Merchant Data Sources vous permet d'avoir plusieurs sources de données API, dont certaines peuvent être des caractères génériques.
Seules les sources de données avec une entrée API peuvent être des sources de données à caractère générique. Données à caractère générique sources ne sont pas compatibles avec les entrées de fichiers.
Créer une source de données supplémentaire et l'associer à la source de données principale
Vous pouvez utiliser des sources de données supplémentaires pour mettre à jour partiellement vos données produit en procédant comme suit :
en ajoutant l'identifiant unique de la source de données en tant que paramètre de requête lorsque
les appels au
accounts.productInputs.insert
et
accounts.productInputs.delete
méthodes. Vous ne pouvez utiliser des sources de données supplémentaires que pour mettre à jour des produits existants.
Pour créer une source de données supplémentaire, configurez votre source de données à l'aide de
SupplementalProductDataSource
, puis associez-le en mettant à jour defaultRule
de votre source de données principale.
Les sources de données de fichiers supplémentaires ne peuvent pas être des sources de données avec des caractères génériques. API supplémentaire Les sources de données doivent toujours être des sources de données avec des caractères génériques.
Planifier la source de données d'un fichier
Pour planifier votre flux de fichiers, configurez votre source de données en tant que fichier
source de données via le champ FileInput
, puis configurez
fetchsettings
à l'aide du champ FileInput.FetchSettings
.
Supprimer une source de données
Pour supprimer une source de données existante de votre compte, utilisez le
accounts.dataSources.delete
.
Extraire la source de données
Pour récupérer un fichier configuré dans la source de données, utilisez la méthode
accounts.dataSources.fetch
. Cette méthode permet d'extraire immédiatement les données d'une source de données
votre compte. Cette méthode ne fonctionne que sur les sources de données comportant un ensemble d'entrées de fichiers.
Obtenir la source de données
Pour récupérer la configuration de la source de données associée à votre compte, utilisez le
accounts.dataSources.get
.
Répertorier les sources de données
Pour répertorier les configurations des sources de données de votre compte, utilisez le
accounts.dataSources.list
.
Appliquer un correctif à la source de données
Pour mettre à jour la configuration d'une source de données existante, utilisez le
accounts.dataSources.patch
.
Associer des sources de données
Les sources principales de données produit vous permettent de gérer règle des sources de données. La règle par défaut est celle qui s'applique dans votre source de données. La règle par défaut peut être définie lors de la création source de données ou en mettant à jour une source de données existante via la règle par défaut .
L'exemple de configuration suivant permet de s'assurer que tous les attributs
provenant de la source de données avec l'identifiant unique 1001
. Ensuite, les
sont ajoutés à partir de la source de données principale. Finalement, les autres
seront extraits de la source de données supplémentaire avec l'attribut
Identifiant 1002
s'il n'est pas déjà fourni dans une autre source de données. Si les
est fourni dans plusieurs sources de données, la valeur la plus élevée dans la liste est
sélectionnée.
defaultRule {
takeFromDataSources: [
'1001', // Supplemental product data source
'self', // Self reference to the primary data source
'1002' // Supplemental product data source
]
}
Gestion automatique des flux
Pour activer la gestion automatique des sources de données dans votre compte, procédez comme suit : suivantes:
- Vérifiez si votre compte peut bénéficier de l'inscription en appelant le
Accounts.AutofeedSettings.Get
. - Assurez-vous que votre compte n'est pas une place de marché. compte.
Une fois que votre compte est éligible pour l'inscription, vous pouvez utiliser le
Accounts.AutofeedSettings.Update
: permet d'activer la gestion automatique des données
sources. Activer la gestion automatique des sources de données permet à Google
ajoutez vos produits depuis votre boutique en ligne et assurez-vous qu'ils sont toujours à jour
sur les plates-formes de Google.
Récupérer l'état de l'importation du fichier
Pour obtenir l'état d'une source de données avec un fichier, une extraction ou une feuille de calcul, vous
peuvent appeler la méthode GET
du service FileUpload
. Pour obtenir le résultat de
la dernière récupération de la source de données calculée de manière asynchrone lorsque les données
Le traitement de la source est terminé. Utilisez l'identifiant de nom latest
.
GET https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/datasources/{datasourceId}/fileUploads/latest
L'état de l'importation du fichier peut contenir une vue détaillée de vos produits, y compris tout problème potentiel.
Notez que l'état d'importation du fichier peut ne pas exister si le fichier n'a jamais été importé. Il est possible que l'état de l'importation du fichier soit en cours de traitement si vous y êtes invité peu de temps après. le fichier est importé.