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)
  },
  "productReviewDataSource": {
    object (ProductReviewDataSource)
  },
  "merchantReviewDataSource": {
    object (MerchantReviewDataSource)
  }
  // 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 de la source de données. En fonction de la valeur saisie, il est possible que certains paramètres ne fonctionnent pas. Seules les sources de données génériques peuvent être créées via l'API.
fileInput

object (FileInput)

Facultatif. Ce 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 d'inventaire en magasin.
regionalInventoryDataSource

object (RegionalInventoryDataSource)

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

object (PromotionDataSource)

Obligatoire. Source de données promotion.
productReviewDataSource

object (ProductReviewDataSource)

Obligatoire. Source de données des avis sur les produits.
merchantReviewDataSource

object (MerchantReviewDataSource)

Obligatoire. Source de données des avis sur les marchands.

PrimaryProductDataSource

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

Représentation JSON 
{
  "channel": enum (Channel),
  "countries": [
    string
  ],
  "defaultRule": {
    object (DefaultRule)
  },
  "feedLabel": string,
  "contentLanguage": string
}
Champs
channel

enum (Channel)

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

string

Facultatif. Pays dans lesquels les articles peuvent être affichés. Représenté par un code de territoire CLDR.
defaultRule

object (DefaultRule)

Facultatif. Gestion des règles par défaut de la source de données. Si cette valeur est définie, les sources de données associées seront remplacées.
feedLabel

string

Facultatif. Immuable. Étiquette du flux spécifiée au niveau de la source de données.

Doit comporter 20 caractères au maximum et ne peut contenir que des lettres majuscules (A-Z), des chiffres (0-9) et des tirets (-).

Consultez également la section Migration vers les libellés de flux.

feedLabel et contentLanguage doivent être tous deux définis ou non pour les sources de données avec le type de contenu produit. Ils doivent être définis pour les sources de données avec une entrée de fichier.

Si ce champ est défini, la source de données n'acceptera que les produits correspondant à cette combinaison. Si cette valeur n'est pas définie, la source de données acceptera les produits sans cette restriction.
contentLanguage

string

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

feedLabel et contentLanguage doivent être tous les deux définis ou non. Vous ne pouvez définir les champs que pour les sources de données sans entrée de fichier.

Si ce champ est défini, la source de données n'acceptera que les produits correspondant à cette combinaison. Si cette valeur n'est pas définie, la source de données acceptera les produits sans cette restriction.

Chaîne

Canal de la 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.

DefaultRule

Gestion des règles par défaut de la source de données.

Représentation JSON 
{
  "takeFromDataSources": [
    {
      object (DataSourceReference)
    }
  ]
}
Champs
takeFromDataSources[]

object (DataSourceReference)

Obligatoire. Liste des sources de données associées dans la règle par défaut. Cette liste est triée en fonction de la priorité par défaut de la règle de jointure des données. Il peut ne contenir aucune référence à self et aux sources de données supplémentaires, ou plusieurs références.

La liste ne doit pas être vide.

Pour associer la source de données à la règle par défaut, vous devez ajouter une référence à cette liste (dans l'ordre séquentiel).

Pour dissocier la source de données de la règle par défaut, vous devez supprimer la référence donnée de cette liste.

Si vous modifiez l'ordre de cette liste, la priorité des sources de données dans la règle par défaut sera modifiée.

Par exemple, si vous indiquez la liste suivante: [1001, self], les valeurs d'attribut seront extraites de la source de données supplémentaire 1001 et self sera utilisé si l'attribut n'est pas défini dans 1001.

DataSourceReference

La référence de la source de données peut être utilisée pour gérer les sources de données associées dans le service de source de données.

Représentation JSON 
{

  // Union field data_source_id can be only one of the following:
  "self": boolean,
  "primaryDataSourceName": string,
  "supplementalDataSourceName": string
  // End of list of possible types for union field data_source_id.
}
Champs

Champ d'union data_source_id.

data_source_id ne peut être qu'un des éléments suivants :
self

boolean

Self doit être utilisé pour faire référence à la source de données principale elle-même.
primaryDataSourceName

string

Facultatif. Nom de la source de données principale. Format : accounts/{account}/dataSources/{datasource}
supplementalDataSourceName

string

Facultatif. Nom de la source de données supplémentaire. Format : accounts/{account}/dataSources/{datasource}

SupplementalProductDataSource

Source de données supplémentaire pour les produits en magasin et en ligne. Une fois la source de données produit supplémentaire créée, assurez-vous de l'associer à une ou plusieurs sources de données produit principales.

Représentation JSON 
{
  "referencingPrimaryDataSources": [
    {
      object (DataSourceReference)
    }
  ],
  "feedLabel": string,
  "contentLanguage": string
}
Champs
referencingPrimaryDataSources[]

object (DataSourceReference)

Uniquement en sortie. Liste (non ordonnée et dédupliquée) de toutes les sources de données principales associées à cette source de données dans des règles par défaut ou personnalisées. Vous ne pouvez pas supprimer une source de données supplémentaire avant d'avoir supprimé tous les liens.
feedLabel

string

Facultatif. Immuable. Étiquette du flux spécifiée au niveau de la source de données.

Doit comporter 20 caractères au maximum et ne peut contenir que des lettres majuscules (A-Z), des chiffres (0-9) et des tirets (-).

Consultez également la section Migration vers les libellés de flux.

feedLabel et contentLanguage doivent être tous deux définis ou non pour les sources de données avec le type de contenu produit.

Ils doivent être définis pour les sources de données avec un file input. Les champs ne doivent pas être définis pour les sources de données sans file input.

Si ce champ est défini, la source de données n'acceptera que les produits correspondant à cette combinaison. Si cette valeur n'est pas définie, la source de données acceptera les produits sans cette restriction.
contentLanguage

string

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

feedLabel et contentLanguage doivent être tous les deux définis ou non. Vous ne pouvez définir les champs que pour les sources de données sans entrée de fichier.

Si ce champ est défini, la source de données n'acceptera que les produits correspondant à cette combinaison. Si cette valeur n'est pas définie, la source de données acceptera 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 auxquelles l'inventaire en magasin est fourni.

Doit comporter 20 caractères au maximum et ne peut contenir que des lettres majuscules (A-Z), des chiffres (0-9) et des tirets (-).

Consultez également la section Migration vers les libellés de flux.
contentLanguage

string

Obligatoire. Immuable. Code de langue ISO 639-1 à deux lettres des articles pour lesquels l'inventaire local est fourni.

RegionalInventoryDataSource

Source de données d'inventaire régionale.

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

string

Obligatoire. Immuable. Libellé du flux des offres auxquelles l'inventaire régional est fourni.

Doit comporter 20 caractères au maximum et ne peut contenir que des lettres majuscules (A-Z), des chiffres (0-9) et des tirets (-).

Consultez également la section Migration vers les libellés de flux.
contentLanguage

string

Obligatoire. Immuable. Code de 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 de territoire CLDR.

Les promotions ne sont disponibles que dans certains pays.
contentLanguage

string

Obligatoire. Immuable. Code de langue ISO 639-1 à deux lettres des éléments de la source de données.

ProductReviewDataSource

Ce type ne comporte aucun champ.

Source de données des avis sur les produits.

MerchantReviewDataSource

Ce type ne comporte aucun champ.

Source de données des avis sur les marchands.

Entrée

Détermine le type d'entrée de la source de données. En fonction de la valeur saisie, certains paramètres peuvent 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 l'entrée de fichiers. Vous pouvez toujours fournir des données via l'API.
UI

Source de données des 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, mais uniquement via l'interface utilisateur de Merchant Center.

Ce type de source de données est en lecture seule.
AUTOFEED Il s'agit également des flux automatiques utilisés pour créer automatiquement vos données produit. Vous pouvez activer ou désactiver ce type de source de données via le lot "Comptes".

FileInput

Données spécifiques aux sources de données de fichiers. Ce champ est vide pour les autres entrées de source de données.

Représentation JSON 
{
  "fetchSettings": {
    object (FetchSettings)
  },
  "fileName": string,
  "fileInputType": enum (FileInputType)
}
Champs
fetchSettings

object (FetchSettings)

Facultatif. Extrayez les détails pour fournir la source de données. Il contient des paramètres pour les types d'entrée de fichiers FETCH et GOOGLE_SHEETS. Les champs obligatoires varient en fonction de la fréquence d'extraction.
fileName

string

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

enum (FileInputType)

Uniquement en sortie. Type d'entrée de fichier.

FetchSettings

Extrayez les détails pour fournir 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 met en pause la planification de la récupération.
dayOfMonth

integer

Facultatif. Jour du mois où le fichier de la source de données doit être extrait (1 à 31). Ce champ ne peut être défini que sur une fréquence mensuelle.
timeOfDay

object (TimeOfDay)

Facultatif. Heure de la journée à laquelle le fichier de la 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 auquel le fichier de la 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 planification. UTC par défaut. Par exemple, "Amérique/Los_Angeles".
frequency

enum (Frequency)

Obligatoire. Fréquence décrivant la planification de la récupération.
fetchUri

string

Facultatif. URL à partir de laquelle le fichier de la source de données peut être extrait. Google Merchant Center accepte les importations planifiées automatiques à l'aide des protocoles HTTP, HTTPS ou SFTP. La valeur doit donc être un lien valide utilisant l'un de ces trois protocoles. Immutabilité pour les fichiers Google Sheets.
username

string

Facultatif. Nom d'utilisateur facultatif pour fetchUri. Permet d'envoyer des sources de données via SFTP.
password

string

Facultatif. Mot de passe facultatif pour fetchUri. 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

Heures d'une journée au format 24 heures. Doit être supérieure ou égale à 0 et généralement inférieure ou égale à 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 d'une heure. Doit être supérieur ou égal à 0 et inférieur ou égal à 59.
seconds

integer

Secondes d'une minute. Doit être supérieure ou égale à 0 et généralement inférieure ou égale à 59. Une API peut autoriser la valeur 60 si elle autorise les secondes intercalaires.
nanos

integer

Fractions de secondes, en nanosecondes. Doit être supérieur ou égal à 0 et inférieur ou égal à 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 d'extraction. Pour une planification de récupération mensuelle, les valeurs [jour du mois][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_month] et [heure de la journée][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] sont obligatoires. Pour une planification de récupération hebdomadaire, les valeurs [jour de la semaine][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.day_of_week] et [heure de la journée][google.shopping.content.bundles.DataSources.FileInput.FetchSchedule.time_of_day] sont obligatoires. Pour une planification quotidienne de la récupération, 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 du fichier.

Enums
FILE_INPUT_TYPE_UNSPECIFIED Type d'entrée de fichier non spécifié.
UPLOAD Le fichier est importé via SFTP, Google Cloud Storage ou manuellement dans Merchant Center.
FETCH Le fichier est extrait de la fetchUri configurée.
GOOGLE_SHEETS Le fichier est extrait de Google Sheets, comme indiqué dans le fichier fetchUri.

Méthodes

create

 Crée la configuration de la nouvelle 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 de votre compte Merchant Center.

get

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

list

 Répertorie les configurations des sources de données pour le compte donné.

patch

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