Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Programmer un transfert Comparaison Shopping Service Center
Ce document explique comment programmer et gérer des tâches de chargement récurrentes pour les données de rapports CSS Center à l'aide du service de transfert de données BigQuery.
Avant de commencer
Avant de créer un transfert de données CSS Center :
Pour la région de l'ensemble de données, nous acceptons l'option par défaut, Multirégional, dans les États-Unis ou dans l'UE.
Si vous souhaitez créer un ensemble de données dans une région spécifique, le transfert de données CSS Center n'est possible que dans les régions suivantes :
us-east4 (Northern Virginia),
asia-northeast1 (Tokyo)
asia-southeast1 (Singapore)
australia-southeast1 (Sydney)
europe-north1 (Findland)
europe-west2 (London)
europe-west6 (Zurich).
Pour créer un transfert de données CSS Center, vous devez disposer de votre ID de domaine CSS.
Si vous avez l'intention de configurer des notifications d'exécution de transfert pour Pub/Sub, vous devez disposer des autorisations pubsub.topics.setIamPolicy. Les autorisations Pub/Sub ne sont pas nécessaires si vous ne configurez que des notifications par e-mail. Pour en savoir plus, consultez la page Notifications d'exécution du service de transfert de données BigQuery.
Autorisations requises
Assurez-vous que l'utilisateur qui crée le transfert de données dispose des autorisations requises.
Ce rôle prédéfini contient les autorisations requises pour créer un transfert. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :
Autorisations requises
Les autorisations suivantes sont requises pour créer un transfert :
bigquery.transfers.update sur l'utilisateur
bigquery.datasets.get sur l'ensemble de données cible
bigquery.datasets.update sur l'ensemble de données cible
Dans la section Type de source, accédez à la liste déroulante Source, puis sélectionnez Google CSS Center.
Dans la section Nom de la configuration de transfert, sous Nom à afficher, saisissez le nom du transfert de données, par exemple My Transfer. Ce nom peut correspondre à n'importe quelle valeur permettant d'identifier le transfert si vous devez le modifier ultérieurement.
La section Options de programmation n'est pas configurable. Les transferts de données CSS Center s'exécutent toutes les 24 heures.
Dans la section Paramètres de destination, accédez au menu déroulant Ensemble de données de destination, puis sélectionnez l'ensemble de données que vous avez créé pour stocker vos données.
Dans la section Détails de la source de données, sous ID CSS, saisissez votre ID de domaine CSS.
Sélectionnez le ou les rapports que vous souhaitez transférer. Pour en savoir plus, consultez Rapports acceptés.
(Facultatif) Dans la section Options de notification :
Cliquez sur le bouton pour activer les notifications par e-mail. Lorsque vous activez cette option, l'administrateur de transfert reçoit une notification par e-mail si l'exécution du transfert échoue.
Sous Sélectionnez un sujet Pub/Sub, choisissez le nom de votre sujet ou cliquez sur Créer un sujet.
Cette option permet de configurer les notifications d'exécution Pub/Sub pour votre transfert de données.
Cliquez sur Enregistrer.
bq
Saisissez la commande bq mk, puis spécifiez l'indicateur de création de transfert --transfer_config. Les paramètres suivants sont également requis :
--data_source
--target_dataset
--display_name
--params
Vous pouvez également indiquer l'option --project_id pour spécifier un projet particulier. Si --project_id n'est pas spécifié, le projet par défaut est utilisé.
dataset est l'ensemble de données cible de la configuration de transfert de données.
name est le nom à afficher pour la configuration du transfert de données. Ce nom peut correspondre à toute valeur permettant d'identifier le transfert si vous devez le modifier ultérieurement.
parameters contient les paramètres de la configuration de transfert de données créée au format JSON. Exemple : --params='{"param":"param_value"}'.
css_id : ID de domaine CSS.
export_products : indique si les données du produit et des problèmes de produit doivent être transférées. Ce paramètre est inclus par défaut, même si vous ne spécifiez pas le paramètre export_products. Nous vous recommandons d'inclure ce paramètre explicitement et de le définir sur true.
data_source correspond à la source de données : css_center.
Par exemple, la commande suivante crée un transfert de données CSS Center nommé My Transfer avec l'ID de domaine CSS 1234 et l'ensemble de données cible mydataset. Le transfert de données est créé dans votre projet par défaut.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[[["\u003cp\u003eThis document provides instructions on how to schedule and manage recurring data load jobs for Comparison Shopping Service (CSS) Center reporting data using the BigQuery Data Transfer Service.\u003c/p\u003e\n"],["\u003cp\u003eBefore setting up a CSS Center data transfer, users must enable the BigQuery Data Transfer Service, create a BigQuery dataset within supported regions, and obtain their CSS domain ID.\u003c/p\u003e\n"],["\u003cp\u003eUsers need specific BigQuery and CSS Center permissions, including \u003ccode\u003ebigquery.transfers.update\u003c/code\u003e, \u003ccode\u003ebigquery.datasets.get\u003c/code\u003e, and \u003ccode\u003ebigquery.datasets.update\u003c/code\u003e to create and manage transfers.\u003c/p\u003e\n"],["\u003cp\u003eCSS Center data transfers are set to run automatically every 24 hours, and users can set up optional email or Pub/Sub notifications for transfer run status updates.\u003c/p\u003e\n"],["\u003cp\u003eData transfers can be configured via the Google Cloud console, command-line tool, or API, with the console supporting all configurations and the command-line tool not supporting notification setups.\u003c/p\u003e\n"]]],[],null,["# Schedule a Comparison Shopping Service Center Transfer\n======================================================\n\n|\n| **Preview**\n|\n|\n| This product is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA products are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n| **Note:** To get support or provide feedback for Comparison Shopping Service (CSS) Center transfers with BigQuery Data Transfer Service, contact [gmc-transfer-preview@google.com](mailto:gmc-transfer-preview@google.com).\n\nThis document shows you how to schedule and manage recurring load jobs for\nCSS Center reporting data using the BigQuery Data Transfer Service.\n\nBefore you begin\n----------------\n\nBefore you create a CSS Center data transfer:\n\n- [Enable the BigQuery Data Transfer Service](/bigquery/docs/enable-transfer-service).\n- [Create a BigQuery dataset](/bigquery/docs/datasets) to store the CSS Center data.\n - For dataset region, we support using the default option, Multi-region, in either US or EU.\n - If you want to create a dataset in a specific region, the CSS Center data transfer is only supported in the following regions:\n - `us-east4 (Northern Virginia)`,\n - `asia-northeast1 (Tokyo)`,\n - `asia-southeast1 (Singapore)`,\n - `australia-southeast1 (Sydney)`,\n - `europe-north1 (Findland)`,\n - `europe-west2 (London)`,\n - `europe-west6 (Zurich)`.\n- You must have your CSS domain ID in order to create a CSS Center data transfer.\n- If you intend to setup transfer run notifications for Pub/Sub, you must have `pubsub.topics.setIamPolicy` permissions. Pub/Sub permissions are not required if you only set up email notifications. For more information, see [BigQuery Data Transfer Service Run Notifications](/bigquery/docs/transfer-run-notifications).\n\nRequired permissions\n--------------------\n\nEnsure that the user creating the data transfer has the following required\npermissions.\n\nFor BigQuery:\n\n\nTo get the permissions that\nyou need to create a transfer,\n\nask your administrator to grant you the\n\n\n[BigQuery admin](/iam/docs/roles-permissions/bigquery#bigquery.admin) (`roles/bigquery.admin`)\nIAM role.\n\n\nFor more information about granting roles, see [Manage access to projects, folders, and organizations](/iam/docs/granting-changing-revoking-access).\n\n\nThis predefined role contains\n\nthe permissions required to create a transfer. To see the exact permissions that are\nrequired, expand the **Required permissions** section:\n\n\n#### Required permissions\n\nThe following permissions are required to create a transfer:\n\n- ` bigquery.transfers.update` on the user\n- `bigquery.datasets.get` on the target dataset\n- `bigquery.datasets.update` on the target dataset\n\n\nYou might also be able to get\nthese permissions\nwith [custom roles](/iam/docs/creating-custom-roles) or\nother [predefined roles](/iam/docs/roles-overview#predefined).\n\nFor the CSS Center:\n\nYou must have access to the CSS Center account that is used in the transfer\nconfiguration.\n\nSet up a CSS Center transfer\n----------------------------\n\nTo create a data transfer for CSS Center reporting: \n\n### Console\n\n1. Go to the Data transfers page in the Google Cloud console.\n\n [Go to Data transfers](https://console.cloud.google.com/bigquery/transfers)\n2. Click add **Create transfer**.\n\n3. On the **Create Transfer** page:\n\n - In the **Source type** section, for **Source** , choose **Google CSS Center**.\n - In the **Transfer config name** section, for **Display name** , enter a\n name for the data transfer such as `My Transfer`. The transfer name can\n be any value that lets you identify the transfer if you need to modify\n it later.\n\n\n - The **Schedule options** section is not configurable. CSS Center\n data transfers are scheduled to run once every 24 hours.\n\n - In the **Destination settings** section, for **Destination dataset**,\n choose the dataset that you created to store your data.\n\n - In the **Data source details** section, for **CSS ID**, enter your CSS\n domain ID.\n\n - Select the report(s) that you would like to transfer. See\n [Supported reports](/bigquery/docs/css-center-transfer#supported_reports)\n for more details.\n\n - (Optional) In the **Notification options** section:\n\n - Click the toggle to enable email notifications. When you enable this option, the transfer administrator receives an email notification when a transfer run fails.\n - For **Select a Pub/Sub topic** , choose your [topic](/pubsub/docs/overview#types) name or click **Create a topic** . This option configures Pub/Sub run [notifications](/bigquery/docs/transfer-run-notifications) for your data transfer.\n\n\n4. Click **Save**.\n\n### bq\n\nEnter the `bq mk` command and supply the transfer creation flag ---\n`--transfer_config`. The following flags are also required:\n\n- `--data_source`\n- `--target_dataset`\n- `--display_name`\n- `--params`\n\nYou can also supply the `--project_id` flag to specify a particular\nproject. If `--project_id` isn't specified, the default project is used. \n\n```bash\nbq mk \\\n--transfer_config \\\n--project_id=project_id \\\n--target_dataset=dataset \\\n--display_name=name \\\n--params='\u003cvar translate=\"no\"\u003eparameters\u003c/var\u003e' \\\n--data_source=data_source\n```\n\nWhere:\n\n- \u003cvar translate=\"no\"\u003eproject_id\u003c/var\u003e is your project ID.\n- \u003cvar translate=\"no\"\u003edataset\u003c/var\u003e is the target dataset for the data transfer configuration.\n- \u003cvar translate=\"no\"\u003ename\u003c/var\u003e is the display name for the data transfer configuration. The transfer name can be any value that lets you identify the transfer if you need to modify it later.\n- \u003cvar translate=\"no\"\u003eparameters\u003c/var\u003e contains the parameters for the created data transfer configuration in JSON format. For example: `--params='{\"param\":\"param_value\"}'`.\n - `css_id`: the CSS domain ID.\n - `export_products`: whether or not to transfer product and product issues data. This parameter is included by default, even if you don't specify the `export_products` parameter. We recommend that you include this parameter explicitly and set it to `true`.\n- \u003cvar translate=\"no\"\u003edata_source\u003c/var\u003e is the data source --- `css_center`.\n\n| **Caution:** You cannot configure notifications by using the command-line tool.\n\nFor example, the following command creates a CSS Center data transfer\nnamed `My Transfer` using CSS domain ID `1234` and target dataset\n`mydataset`. The data transfer is created in your default project. \n\n bq mk \\\n --transfer_config \\\n --target_dataset=mydataset \\\n --display_name='My Transfer' \\\n --params='{\"css_id\":\"1234\",\"export_products\":\"true\",\"export_regional_inventories\":\"true\",\"export_local_inventories\":\"true\",\"export_price_benchmarks\":\"true\",\"export_best_sellers\":\"true\"}' \\\n --data_source=css_center\n\nThe first time you run the command, you receive a message like the\nfollowing:\n\n`[URL omitted] Please copy and paste the above URL into your web browser and\nfollow the instructions to retrieve an authentication code.`\n\nFollow the instructions in the message and paste the authentication code on\nthe command line.\n\n### API\n\nUse the [`projects.locations.transferConfigs.create`](/bigquery-transfer/docs/reference/datatransfer/rest/v1/projects.locations.transferConfigs/create)\nmethod and supply an instance of the [`TransferConfig`](/bigquery-transfer/docs/reference/datatransfer/rest/v1/projects.locations.transferConfigs#TransferConfig)\nresource."]]
