Package google.shopping.merchant.datasources.v1beta

Index

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

rpc CreateDataSource(CreateDataSourceRequest) returns (DataSource)

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

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/content

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.
DeleteDataSource

rpc DeleteDataSource(DeleteDataSourceRequest) returns (Empty)

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

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/content

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.
FetchDataSource

rpc FetchDataSource(FetchDataSourceRequest) returns (Empty)

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.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/content

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.
GetDataSource

rpc GetDataSource(GetDataSourceRequest) returns (DataSource)

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

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/content

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.
ListDataSources

rpc ListDataSources(ListDataSourcesRequest) returns (ListDataSourcesResponse)

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

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/content

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.
UpdateDataSource

rpc UpdateDataSource(UpdateDataSourceRequest) returns (DataSource)

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.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/content

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

CreateDataSourceRequest

Message de requête pour la méthode CreateDataSource.

Champs
parent

string

Obligatoire. Compte dans lequel cette source de données sera créée. Format : accounts/{account}
data_source

DataSource

Obligatoire. Source de données à créer.

DataSource

Source de données du compte Merchant Center.

Champs
name

string

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

int64

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

string

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

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

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 :
primary_product_data_source

PrimaryProductDataSource

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

SupplementalProductDataSource

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

LocalInventoryDataSource

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

RegionalInventoryDataSource

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

PromotionDataSource

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 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".

DeleteDataSourceRequest

Message de requête pour la méthode DeleteDataSource.

Champs
name

string

Obligatoire. Nom de la source de données à supprimer. Format : accounts/{account}/dataSources/{datasource}

FetchDataSourceRequest

Message de requête pour la méthode FetchDataSource.

Champs
name

string

Obligatoire. Nom de la ressource de source de données à extraire. Format : accounts/{account}/dataSources/{datasource}

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

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.
file_name

string

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

FileInputType

Uniquement en sortie. Type de fichier saisi.

FetchSettings

Extrayez les détails pour diffuser la source de données.

Champs
enabled

bool

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

int32

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

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.
day_of_week

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.
time_zone

string

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

Frequency

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

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.

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

string

Obligatoire. Nom de la source de données à récupérer. Format : accounts/{account}/dataSources/{datasource}

ListDataSourcesRequest

Message de requête pour la méthode ListDataSources.

Champs
parent

string

Obligatoire. Compte pour lequel répertorier les sources de données. Format : accounts/{account}
page_size

int32

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

string

Facultatif. Jeton de page reçu d'un appel ListDataSources précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à ListDataSources doivent correspondre à l'appel ayant fourni le jeton de page.

ListDataSourcesResponse

Message de réponse pour la méthode ListDataSources.

Champs
data_sources[]

DataSource

Sources de données du compte spécifié.
next_page_token

string

Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

LocalInventoryDataSource

Source de données d'inventaire en magasin.

Champs
feed_label

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.
content_language

string

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

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.
feed_label

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.
content_language

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.

PromotionDataSource

Source de données de la promotion.

Champs
target_country

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.
content_language

string

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

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.
content_language

string

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

SupplementalProductDataSource

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

Champs
feed_label

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.
content_language

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.

UpdateDataSourceRequest

Message de requête pour la méthode UpdateDataSource.

Champs
data_source

DataSource

Obligatoire. Ressource de source de données à mettre à jour.
update_mask

FieldMask

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.

Il n'est pas possible de fournir une valeur spéciale "*" pour le remplacement complet de la source de données.