Index
DataSourcesService
(interface)CreateDataSourceRequest
(message)DataSource
(message)DataSource.Input
(enum)DeleteDataSourceRequest
(message)FetchDataSourceRequest
(message)FileInput
(message)FileInput.FetchSettings
(message)FileInput.FetchSettings.Frequency
(enum)FileInput.FileInputType
(enum)GetDataSourceRequest
(message)ListDataSourcesRequest
(message)ListDataSourcesResponse
(message)LocalInventoryDataSource
(message)PrimaryProductDataSource
(message)PrimaryProductDataSource.Channel
(enum)PromotionDataSource
(message)RegionalInventoryDataSource
(message)SupplementalProductDataSource
(message)UpdateDataSourceRequest
(message)
DataSourcesService
Service permettant de gérer les sources de données principales, supplémentaires, d'inventaire et autres Pour en savoir plus, consultez l'article d'aide Merchant Center.
CreateDataSource |
---|
Crée la configuration de la source de données pour le compte donné.
|
DeleteDataSource |
---|
Supprime une source de données de votre compte Merchant Center.
|
FetchDataSource |
---|
Effectue la récupération des données immédiatement (même en dehors du calendrier de récupération) sur une source de données à partir de votre compte Merchant Center. Si vous devez appeler cette méthode plusieurs fois par jour, utilisez plutôt le service Products pour mettre à jour vos données produit. Cette méthode ne fonctionne que sur les sources de données comportant un ensemble d'entrées de fichiers.
|
GetDataSource |
---|
Récupère la configuration de la source de données pour le compte donné.
|
ListDataSources |
---|
Liste les configurations des sources de données du compte donné.
|
UpdateDataSource |
---|
Met à jour la configuration de source de données existante. Les champs définis dans le masque de mise à jour, mais non fournis dans la ressource, seront supprimés.
|
CreateDataSourceRequest
Message de requête pour la méthode CreateDataSource.
Champs | |
---|---|
parent |
Obligatoire. Compte dans lequel cette source de données sera créée. Format : |
data_source |
Obligatoire. Source de données à créer. |
DataSource
Source de données du compte Merchant Center.
Champs | |
---|---|
name |
Identifiant. Nom de la source de données. Format : |
data_source_id |
Uniquement en sortie. ID de la source de données. |
display_name |
Obligatoire. Nom de la source de données affiché dans l'interface utilisateur de Merchant Center. |
input |
Uniquement en sortie. Détermine le type d'entrée pour la source de données. Selon les données saisies, certains paramètres risquent de ne pas fonctionner. Seules des sources de données génériques peuvent être créées via l'API. |
file_input |
Facultatif. Le champ n'est utilisé que lorsque les données sont gérées via un fichier. |
Champ d'union Type . Type de source de données. Type ne peut être qu'un des éléments suivants : |
|
primary_product_data_source |
Obligatoire. Source de données principale pour les produits en magasin et en ligne. |
supplemental_product_data_source |
Obligatoire. Source de données supplémentaire pour les produits en magasin et en ligne. |
local_inventory_data_source |
Obligatoire. Source de données de l'inventaire en magasin. |
regional_inventory_data_source |
Obligatoire. Source de données de l'inventaire régional. |
promotion_data_source |
Obligatoire. Source de données promotion. |
Entrée
Détermine le type d'entrée pour la source de données. Selon les informations saisies, certains paramètres risquent de ne pas être acceptés.
Enums | |
---|---|
INPUT_UNSPECIFIED |
Entrée non spécifiée. |
API |
Représente les sources de données pour lesquelles les données sont principalement fournies via l'API. |
FILE |
Représente les sources de données pour lesquelles les données sont principalement fournies via une entrée de fichier. Les données peuvent toujours être fournies via l'API. |
UI |
Source de données pour les produits ajoutés directement dans Merchant Center. Vous ne pouvez pas créer ni mettre à jour ce type de source de données via cette API uniquement via l'interface utilisateur de Merchant Center. Ce type de source de données est en lecture seule. |
AUTOFEED |
Également appelés flux automatiques, ils vous permettent de créer automatiquement vos données produit. Vous pouvez activer ou désactiver ce type de source de données via le groupe "Comptes". |
DeleteDataSourceRequest
Message de requête pour la méthode DeleteDataSource.
Champs | |
---|---|
name |
Obligatoire. Nom de la source de données à supprimer. Format : |
FetchDataSourceRequest
Message de requête pour la méthode FetchDataSource.
Champs | |
---|---|
name |
Obligatoire. Nom de la ressource de source de données à extraire. Format : |
FileInput
Données spécifiques aux sources de données de fichiers. Ce champ est vide pour les autres entrées de sources de données.
Champs | |
---|---|
fetch_settings |
Facultatif. Extrayez les détails pour diffuser la source de données. Il contient les paramètres des types d'entrée de fichier |
file_name |
Facultatif. Nom de fichier de la source de données. Obligatoire pour le type d'entrée de fichier |
file_input_type |
Uniquement en sortie. Type de fichier saisi. |
FetchSettings
Extrayez les détails pour diffuser la source de données.
Champs | |
---|---|
enabled |
Facultatif. Active ou suspend le planning de récupération. |
day_of_month |
Facultatif. Jour du mois au cours duquel le fichier de source de données doit être extrait (compris entre 1 et 31). Ce champ ne peut être défini que pour la fréquence mensuelle. |
time_of_day |
Facultatif. Heure de la journée à laquelle le fichier de source de données doit être extrait. Les minutes et les secondes ne sont pas acceptées et seront ignorées. |
day_of_week |
Facultatif. Jour de la semaine pendant lequel le fichier de source de données doit être extrait. Ce champ ne peut être défini que pour la fréquence hebdomadaire. |
time_zone |
Facultatif. Fuseau horaire utilisé pour la programmation. UTC par défaut. Par exemple, "America/Los_Angeles". |
frequency |
Obligatoire. Fréquence décrivant le planning de récupération. |
fetch_uri |
Facultatif. URL où le fichier de source de données peut être extrait. Google Merchant Center accepte les importations planifiées automatiques qui utilisent les protocoles HTTP, HTTPS ou SFTP. La valeur doit donc correspondre à un lien valide utilisant l'un de ces trois protocoles. Immuable pour les fichiers Google Sheets. |
username |
Facultatif. Nom d'utilisateur facultatif pour [fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. Permet d'envoyer des sources de données via SFTP. |
password |
Facultatif. Mot de passe facultatif pour [fetch url][google.shopping.content.bundles.DataSources.FileInput.fetch_url]. Permet d'envoyer des sources de données via SFTP. |
Fréquence
Les champs obligatoires varient en fonction de la fréquence de récupération. Pour un calendrier de récupération mensuel, [day of month][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_month] et [hour of day][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] sont requis. Pour un calendrier de récupération hebdomadaire, [day of week][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_week] et [hour of day][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] sont requis. Pour un planning de récupération quotidien, seule une [heure de la journée][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] est requise.
Enums | |
---|---|
FREQUENCY_UNSPECIFIED |
Fréquence non spécifiée. |
FREQUENCY_DAILY |
La récupération a lieu tous les jours. |
FREQUENCY_WEEKLY |
La récupération a lieu toutes les semaines. |
FREQUENCY_MONTHLY |
La récupération a lieu tous les mois. |
FileInputType
Mode de diffusion des fichiers.
Enums | |
---|---|
FILE_INPUT_TYPE_UNSPECIFIED |
Type d'entrée du fichier non spécifié. |
UPLOAD |
Vous pouvez importer le fichier via SFTP, Google Cloud Storage ou manuellement dans Merchant Center. |
FETCH |
Le fichier est récupéré à partir du fichier [fetch_uri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] configuré. |
GOOGLE_SHEETS |
Le fichier est récupéré à partir des feuilles de calcul Google Sheets spécifiées dans [fetch_uri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri]. |
GetDataSourceRequest
Message de requête pour la méthode GetDataSource.
Champs | |
---|---|
name |
Obligatoire. Nom de la source de données à récupérer. Format : |
ListDataSourcesRequest
Message de requête pour la méthode ListDataSources.
Champs | |
---|---|
parent |
Obligatoire. Compte pour lequel répertorier les sources de données. Format : |
page_size |
Facultatif. Nombre maximal de sources de données à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000. Si aucune valeur n'est spécifiée, le nombre maximal de sources de données est renvoyé. |
page_token |
Facultatif. Jeton de page reçu d'un appel Lors de la pagination, tous les autres paramètres fournis à |
ListDataSourcesResponse
Message de réponse pour la méthode ListDataSources.
Champs | |
---|---|
data_sources[] |
Sources de données du compte spécifié. |
next_page_token |
Jeton pouvant être envoyé en tant que |
LocalInventoryDataSource
Source de données d'inventaire en magasin.
Champs | |
---|---|
feed_label |
Obligatoire. Immuable. Libellé du flux des offres pour lesquelles l'inventaire en magasin est fourni. Le nom ne doit pas comporter plus de 20 lettres majuscules (A-Z), chiffres (0-9) et tirets (-). Consultez également Migration vers les libellés de flux. |
content_language |
Obligatoire. Immuable. Langue ISO 639-1 à deux lettres des articles pour lesquels l'inventaire en magasin est disponible. |
PrimaryProductDataSource
Il s'agit de la principale source de données pour les produits en magasin et en ligne.
Champs | |
---|---|
channel |
Obligatoire. Immuable. Spécifie le type de canal de source de données. |
countries[] |
Facultatif. Pays dans lesquels les articles peuvent être diffusés. Représenté par un code CLDR. |
feed_label |
Facultatif. Immuable. Libellé du flux spécifié au niveau de la source de données. Le nom ne doit pas comporter plus de 20 lettres majuscules (A-Z), chiffres (0-9) et tirets (-). Consultez également Migration vers les libellés de flux. Les champs Si cette option est définie, la source de données n'acceptera que les produits correspondant à cette combinaison. Si cette règle n'est pas configurée, la source de données accepte les produits qui ne respectent pas cette restriction. |
content_language |
Facultatif. Immuable. Langue ISO 639-1 à deux lettres des éléments de la source de données. Les champs Si cette option est définie, la source de données n'acceptera que les produits correspondant à cette combinaison. Si cette règle n'est pas configurée, la source de données accepte les produits qui ne respectent pas cette restriction. |
Chaîne
Canal de source de données.
Le canal permet de distinguer les sources de données pour différents secteurs de produits.
Enums | |
---|---|
CHANNEL_UNSPECIFIED |
Non spécifié. |
ONLINE_PRODUCTS |
Produit en ligne. |
LOCAL_PRODUCTS |
Produit en magasin. |
PRODUCTS |
Source de données unifiée pour les produits en magasin et en ligne. Remarque: La gestion des produits via l'API n'est pas possible pour ce canal. |
PromotionDataSource
Source de données de la promotion.
Champs | |
---|---|
target_country |
Obligatoire. Immuable. Pays cible utilisé dans l'identifiant unique. Représenté par un code CLDR. Les promotions ne sont disponibles que dans certains pays. |
content_language |
Obligatoire. Immuable. Langue ISO 639-1 à deux lettres des éléments de la source de données. |
RegionalInventoryDataSource
Source de données d'inventaire régional.
Champs | |
---|---|
feed_label |
Obligatoire. Immuable. Libellé du flux des offres auxquelles l'inventaire régional est fourni. Le nom ne doit pas comporter plus de 20 lettres majuscules (A-Z), chiffres (0-9) et tirets (-). Consultez également Migration vers les libellés de flux. |
content_language |
Obligatoire. Immuable. Langue ISO 639-1 à deux lettres des articles auxquels l'inventaire régional est fourni. |
SupplementalProductDataSource
Source de données supplémentaire pour les produits en magasin et en ligne.
Champs | |
---|---|
feed_label |
Facultatif. Immuable. Libellé du flux spécifié au niveau de la source de données. Le nom ne doit pas comporter plus de 20 lettres majuscules (A-Z), chiffres (0-9) et tirets (-). Consultez également Migration vers les libellés de flux. Les champs Si cette option est définie, la source de données n'acceptera que les produits correspondant à cette combinaison. Si cette règle n'est pas configurée, la source de données accepte les produits sans cette restriction. |
content_language |
Facultatif. Immuable. Langue ISO 639-1 à deux lettres des éléments de la source de données. Les champs Si cette option est définie, la source de données n'acceptera que les produits correspondant à cette combinaison. Si cette règle n'est pas configurée, la source de données accepte les produits sans cette restriction. |
UpdateDataSourceRequest
Message de requête pour la méthode UpdateDataSource.
Champs | |
---|---|
data_source |
Obligatoire. Ressource de source de données à mettre à jour. |
update_mask |
Obligatoire. Liste des champs de la source de données à mettre à jour. Les champs spécifiés dans le masque de mise à jour sans valeur spécifiée dans le corps seront supprimés de la source de données. Fournir un "*" spécial pour le remplacement complet de la source de données n'est pas acceptée. |