- Ressource : DataSource
- PrimaryProductDataSource
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- Canal
- SupplementalProductDataSource
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- LocalInventoryDataSource
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- RegionalInventoryDataSource
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- PromotionDataSource
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- Entrée
- FileInput
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- FetchSettings
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- TimeOfDay
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- DayOfWeek
- Fréquence
- FileInputType
- Méthodes
Ressource : DataSource
Source de données du compte Merchant Center.
Représentation JSON |
---|
{ "name": string, "dataSourceId": string, "displayName": string, "input": enum ( |
Champs | |
---|---|
name |
Identifiant. Nom de la source de données. Format : |
dataSourceId |
Uniquement en sortie. ID de la source de données. |
displayName |
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. |
fileInput |
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 : |
|
primaryProductDataSource |
Obligatoire. Source de données principale pour les produits en magasin et en ligne. |
supplementalProductDataSource |
Obligatoire. Source de données supplémentaire pour les produits en magasin et en ligne. |
localInventoryDataSource |
Obligatoire. Source de données de l'inventaire en magasin. |
regionalInventoryDataSource |
Obligatoire. Source de données de l'inventaire régional. |
promotionDataSource |
Obligatoire. Source de données promotion. |
PrimaryProductDataSource
Il s'agit de la principale source de données pour les produits en magasin et en ligne.
Représentation JSON |
---|
{
"channel": enum ( |
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. |
feedLabel |
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 auxquels aucune restriction n'a été appliquée. |
contentLanguage |
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 auxquels aucune restriction n'a été appliquée. |
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. |
SupplementalProductDataSource
Source de données supplémentaire pour les produits en magasin et en ligne.
Représentation JSON |
---|
{ "feedLabel": string, "contentLanguage": string } |
Champs | |
---|---|
feedLabel |
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. |
contentLanguage |
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. |
LocalInventoryDataSource
Source de données d'inventaire en magasin.
Représentation JSON |
---|
{ "feedLabel": string, "contentLanguage": string } |
Champs | |
---|---|
feedLabel |
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. |
contentLanguage |
Obligatoire. Immuable. Langue ISO 639-1 à deux lettres des articles pour lesquels l'inventaire en magasin est disponible. |
RegionalInventoryDataSource
Source de données d'inventaire régional.
Représentation JSON |
---|
{ "feedLabel": string, "contentLanguage": string } |
Champs | |
---|---|
feedLabel |
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. |
contentLanguage |
Obligatoire. Immuable. Langue ISO 639-1 à deux lettres des articles auxquels l'inventaire régional est fourni. |
PromotionDataSource
Source de données de la promotion.
Représentation JSON |
---|
{ "targetCountry": string, "contentLanguage": string } |
Champs | |
---|---|
targetCountry |
Obligatoire. Immuable. Pays cible utilisé dans l'identifiant unique. Représenté par un code CLDR. Les promotions ne sont disponibles que dans certains pays. |
contentLanguage |
Obligatoire. Immuable. Langue ISO 639-1 à deux lettres des éléments de la source de données. |
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". |
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.
Représentation JSON |
---|
{ "fetchSettings": { object ( |
Champs | |
---|---|
fetchSettings |
Facultatif. Extrayez les détails pour diffuser la source de données. Il contient les paramètres des types d'entrée de fichier |
fileName |
Facultatif. Nom de fichier de la source de données. Obligatoire pour le type d'entrée de fichier |
fileInputType |
Uniquement en sortie. Type de fichier saisi. |
FetchSettings
Extrayez les détails pour diffuser la source de données.
Représentation JSON |
---|
{ "enabled": boolean, "dayOfMonth": integer, "timeOfDay": { object ( |
Champs | |
---|---|
enabled |
Facultatif. Active ou suspend le planning de récupération. |
dayOfMonth |
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. |
timeOfDay |
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. |
dayOfWeek |
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. |
timeZone |
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. |
fetchUri |
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. |
TimeOfDay
Représente une heure de la journée. La date et le fuseau horaire sont spécifiés ailleurs, ou ne sont pas significatifs. Une API peut choisir d'autoriser des secondes intercalaires. Les types associés sont google.type.Date
et google.protobuf.Timestamp
.
Représentation JSON |
---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
Champs | |
---|---|
hours |
Heure de la journée au format 24 heures. Elle doit être comprise entre 0 à 23. Une API peut choisir d'autoriser la valeur "24:00:00" pour des cas tels que l'heure de fermeture des bureaux. |
minutes |
Minutes de l'heure de la journée. Elles doivent être comprises entre 0 à 59. |
seconds |
Secondes de l'heure de la journée. Elles doivent normalement être comprises entre 0 et 59. Une API peut autoriser la valeur 60 si elle autorise les secondes intercalaires. |
nanos |
Fractions de secondes en nanosecondes. La valeur doit être comprise entre 0 et 999 999 999. |
DayOfWeek
Représente un jour de la semaine.
Enums | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
Le jour de la semaine n'est pas spécifié. |
MONDAY |
Lundi |
TUESDAY |
Mardi |
WEDNESDAY |
Mercredi |
THURSDAY |
Jeudi |
FRIDAY |
Vendredi |
SATURDAY |
Samedi |
SUNDAY |
Dimanche |
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 |
Le fichier est importé via SFTP, Google Cloud Storage ou manuellement dans Merchant Center. |
FETCH |
Le fichier est récupéré à partir de l'instance [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri] configurée. |
GOOGLE_SHEETS |
Le fichier est récupéré à partir des feuilles de calcul Google Sheets spécifiées dans [fetchUri][google.shopping.content.bundles.DataSources.FileInput.FetchSettings.fetch_uri]. |
Méthodes |
|
---|---|
|
Crée la configuration de la source de données pour le compte donné. |
|
Supprime une source de données de votre compte Merchant Center. |
|
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. |
|
Récupère la configuration de la source de données pour le compte donné. |
|
Liste les configurations des sources de données du compte donné. |
|
Met à jour la configuration de source de données existante. |