Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Programa una transferencia de Comparison Shopping Service Center
En este documento, se muestra cómo programar y administrar trabajos de carga recurrentes para
los datos de informes de CSS Center con el Servicio de transferencia de datos de BigQuery.
Antes de comenzar
Antes de crear una transferencia de datos de CSS Center, haz lo siguiente:
Para la región del conjunto de datos, admitimos el uso de la opción predeterminada, multirregión, en US o EU.
Si deseas crear un conjunto de datos en una región específica, la transferencia de datos
de CSS Center solo se admite en las siguientes regiones:
us-east4 (Northern Virginia),
asia-northeast1 (Tokyo),
asia-southeast1 (Singapore),
australia-southeast1 (Sydney),
europe-north1 (Findland),
europe-west2 (London),
europe-west6 (Zurich).
Debes tener tu ID de dominio de CSS para crear una transferencia de datos de CSS Center.
Si quieres configurar las notificaciones de ejecución de transferencias para Pub/Sub, debes tener los permisos pubsub.topics.setIamPolicy. Los permisos de Pub/Sub no son necesarios si solo configuras las notificaciones por correo electrónico. Para obtener más información, consulta la sección sobre notificaciones de ejecución del Servicio de transferencia de datos de BigQuery.
Permisos necesarios
Asegúrate de que el usuario que crea la transferencia de datos tenga los siguientes permisos
requeridos.
Este rol predefinido contiene
los permisos necesarios para crear una transferencia. Para ver los permisos exactos que son
necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para crear una transferencia:
bigquery.transfers.update
en el usuario
bigquery.datasets.get
en el conjunto de datos de destino
bigquery.datasets.update
en el conjunto de datos de destino
En la página Crear transferencia, sigue estos pasos:
En la sección Tipo de fuente, en Fuente, elige
Google CSS Center.
En la sección Nombre de la configuración de transferencia (Transfer config name), en Nombre visible, ingresa el nombre de la transferencia de datos, como My Transfer. El nombre de la transferencia puede ser
cualquier valor que te permita identificarla si es necesario hacerle modificaciones
más tarde.
La sección Opciones de programación no se puede configurar. Las transferencias de datos de CSS Center están programadas para ejecutarse una vez cada 24 horas.
En la sección Configuración de destino (Destination settings), en Conjunto de datos de destino (Destination dataset), selecciona el conjunto de datos que creaste para almacenar tus datos.
En la sección Detalles de la fuente de datos, en ID de CSS, ingresa
tu ID de dominio de CSS.
Selecciona los informes que deseas transferir. Consulta Informes compatibles
para obtener más detalles.
De forma opcional, en la sección Opciones de notificación, haz lo siguiente:
Haz clic en el botón de activación para habilitar las notificaciones por correo electrónico. Cuando habilitas esta opción, el administrador de transferencias recibe una notificación por correo electrónico cuando falla una ejecución de transferencia.
En Seleccionar un tema de Cloud Pub/Sub (Select a Cloud Pub/Sub topic), elige el nombre de tu tema o haz clic en Crear un tema (Create a topic). Esta opción configura las notificaciones de ejecución de Pub/Sub para tu transferencia de datos.
Haz clic en Guardar.
bq
Ingresa el comando bq mk y suministra la marca de creación de transferencias --transfer_config. También se requieren las siguientes marcas:
--data_source
--target_dataset
--display_name
--params
También puedes proporcionar la marca --project_id para especificar un proyecto en particular. Si no se especifica --project_id, se usa el proyecto predeterminado.
dataset es el conjunto de datos de destino para la configuración de transferencia de datos.
name es el nombre visible de la configuración de transferencia de datos. El nombre de la transferencia puede ser cualquier valor que te permita identificarla si es necesario hacerle modificaciones más tarde.
parameters contiene los parámetros para la configuración de la transferencia de datos creada en formato JSON. Por ejemplo: --params='{"param":"param_value"}'
css_id: el ID del dominio de CSS.
export_products: indica si se deben transferir o no los datos
de productos y problemas de productos. Este parámetro se incluye de forma predeterminada, incluso si no especificas el parámetro export_products. Te recomendamos
incluir este parámetro de forma explícita y configurarlo como true.
data_source es la fuente de datos: css_center.
Por ejemplo, el siguiente comando crea una transferencia de datos de CSS Center
llamada My Transfer con el ID de dominio de CSS 1234 y el conjunto de datos de destino
mydataset. La transferencia de datos se crea en tu proyecto predeterminado.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-09 (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."]]
