REST Resource: accounts.dataSources

Ressource : DataSource

Source de données du compte Merchant Center.

Représentation JSON 
{
  "name": string,
  "dataSourceId": string,
  "displayName": string,
  "input": enum (Input),
  "fileInput": {
    object (FileInput)
  },

  // Union field Type can be only one of the following:
  "primaryProductDataSource": {
    object (PrimaryProductDataSource)
  },
  "supplementalProductDataSource": {
    object (SupplementalProductDataSource)
  },
  "localInventoryDataSource": {
    object (LocalInventoryDataSource)
  },
  "regionalInventoryDataSource": {
    object (RegionalInventoryDataSource)
  },
  "promotionDataSource": {
    object (PromotionDataSource)
  }
  // End of list of possible types for union field Type.
}
Champs
name

string

Identifiant. Nom de la source de données. Format : {datasource.name=accounts/{account}/dataSources/{datasource}}
dataSourceId

string (int64 format)

Uniquement en sortie. ID de la source de données.
displayName

string

Obligatoire. Nom de la source de données affiché dans l'interface utilisateur de Merchant Center.
input

enum (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

object (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

object (PrimaryProductDataSource)

Obligatoire. Source de données principale pour les produits en magasin et en ligne.
supplementalProductDataSource

object (SupplementalProductDataSource)

Obligatoire. Source de données supplémentaire pour les produits en magasin et en ligne.
localInventoryDataSource

object (LocalInventoryDataSource)

Obligatoire. Source de données de l'inventaire en magasin.
regionalInventoryDataSource

object (RegionalInventoryDataSource)

Obligatoire. Source de données de l'inventaire régional.
promotionDataSource

object (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 (Channel),
  "countries": [
    string
  ],
  "feedLabel": string,
  "contentLanguage": string
}
Champs
channel

enum (Channel)

Obligatoire. Immuable. Spécifie le type de canal de source de données.
countries[]

string

Facultatif. Pays dans lesquels les articles peuvent être diffusés. Représenté par un code CLDR.
feedLabel

string

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 feedLabel et contentLanguage doivent être définis ou non définis pour les sources de données avec un type de contenu produit. Elles doivent être définies pour les sources de données comportant une entrée de fichier.

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

string

Facultatif. Immuable. Langue ISO 639-1 à deux lettres des éléments de la source de données.

Les champs feedLabel et contentLanguage doivent être tous les deux définis ou non définis. Les champs ne peuvent être désactivés que pour les sources de données sans entrée de fichier.

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.

SupplementalProductDataSource

Source de données supplémentaire pour les produits en magasin et en ligne.

Représentation JSON 
{
  "feedLabel": string,
  "contentLanguage": string
}
Champs
feedLabel

string

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 feedLabel et contentLanguage doivent être définis ou non définis pour les sources de données avec un type de contenu produit. Elles doivent être définies pour les sources de données comportant une entrée de fichier.

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

string

Facultatif. Immuable. Langue ISO 639-1 à deux lettres des éléments de la source de données.

Les champs feedLabel et contentLanguage doivent être tous les deux définis ou non définis. Les champs ne peuvent être désactivés que pour les sources de données sans entrée de fichier.

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

string

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

string

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

string

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

string

Obligatoire. Immuable. Langue ISO 639-1 à deux lettres des articles pour lesquels l'inventaire régional est fourni.

PromotionDataSource

Source de données de la promotion.

Représentation JSON 
{
  "targetCountry": string,
  "contentLanguage": string
}
Champs
targetCountry

string

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

string

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 On parle également de flux automatiques pour 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 (FetchSettings)
  },
  "fileName": string,
  "fileInputType": enum (FileInputType)
}
Champs
fetchSettings

object (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 FETCH et GOOGLE_SHEETS. Les champs obligatoires varient en fonction de la fréquence de récupération.
fileName

string

Facultatif. Nom de fichier de la source de données. Obligatoire pour le type d'entrée de fichier UPLOAD.
fileInputType

enum (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 (TimeOfDay)
  },
  "dayOfWeek": enum (DayOfWeek),
  "timeZone": string,
  "frequency": enum (Frequency),
  "fetchUri": string,
  "username": string,
  "password": string
}
Champs
enabled

boolean

Facultatif. Active ou suspend le planning de récupération.
dayOfMonth

integer

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

object (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

enum (DayOfWeek)

Facultatif. Jour de la semaine où le fichier de source de données doit être extrait. Ce champ ne peut être défini que pour la fréquence hebdomadaire.
timeZone

string

Facultatif. Fuseau horaire utilisé pour la programmation. UTC par défaut. Par exemple, "America/Los_Angeles".
frequency

enum (Frequency)

Obligatoire. Fréquence décrivant le planning de récupération.
fetchUri

string

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

string

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

string

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

integer

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

integer

Minutes de l'heure de la journée. Elles doivent être comprises entre 0 à 59.
seconds

integer

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

integer

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

create

 Crée la configuration de la source de données pour le compte donné.

delete

 Supprime une source de données de votre compte Merchant Center.

fetch

 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.

get

 Récupère la configuration de la source de données pour le compte donné.

list

 Liste les configurations des sources de données du compte donné.

patch

 Met à jour la configuration de source de données existante.