Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Programar uma transferência do Comparison Shopping Service Center
Neste documento, mostramos como programar e gerenciar jobs de carregamento recorrentes para dados de relatórios do CSS Center usando o serviço de transferência de dados do BigQuery.
Antes de começar
Antes de criar uma transferência de dados do CSS Center:
Para a região do conjunto de dados, é possível usar a opção padrão, multirregional, nos EUA ou na UE.
Se você quiser criar um conjunto de dados em uma região específica, a transferência de dados do CSS Center só será aceita nas seguintes regiões:
us-east4 (Northern Virginia),
asia-northeast1 (Tokyo),
asia-southeast1 (Singapore),
australia-southeast1 (Sydney),
europe-north1 (Findland),
europe-west2 (London),
europe-west6 (Zurich).
Você precisa ter o ID do domínio do CSS para criar uma transferência de dados do CSS Center.
Se você pretende configurar notificações de execução de transferência do Pub/Sub,
é preciso ter permissões pubsub.topics.setIamPolicy. As permissões do Pub/Sub não serão necessárias caso você configure notificações por e-mail. Para mais informações, consulte Notificações de execução do serviço de transferência de dados do BigQuery.
Permissões necessárias
Verifique se o usuário que está criando a transferência de dados tem as seguintes permissões
necessárias:
Esse papel predefinido contém
as permissões necessárias para criar uma transferência. Para conferir as permissões exatas
necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
As seguintes permissões são necessárias para criar uma transferência:
bigquery.transfers.update
no usuário
bigquery.datasets.get
no conjunto de dados de destino
bigquery.datasets.update
no conjunto de dados de destino
Na seção Tipo de origem, em Origem, escolha Google CSS Center.
No campo Nome de exibição da seção Transferir nome da configuração, insira um
nome para a transferência de dados, como My Transfer. O nome da transferência pode ser
qualquer valor que permita identificá-la, caso você precise
modificá-la mais tarde.
A seção Opções de programação não é configurável. Centro de CSS
as transferências de dados são programadas para execução a cada 24 horas.
Na seção Configurações de destino, em Conjunto de dados de destino, escolha o conjunto criado para armazenar seus dados.
Na seção Detalhes da fonte de dados, em ID do CSS, insira o ID do domínio do CSS.
Selecione os relatórios que você quer transferir. Consulte Relatórios suportados
para mais detalhes.
Opcional: na seção Opções de notificação:
Clique no botão para ativar as notificações por e-mail. Quando você ativa essa
opção, o administrador de transferência recebe uma notificação por e-mail
se uma execução de transferência falhar.
Em Selecionar um tópico do Pub/Sub, escolha o nome do tópico
ou clique em Criar um tópico. Essa opção configura notificações de execução do Pub/Sub da sua transferência de dados.
Clique em Salvar.
bq
Insira o comando bq mk e forneça a sinalização de execução da transferência
--transfer_config. As sinalizações a seguir também são obrigatórias:
--data_source
--target_dataset
--display_name
--params
Também é possível fornecer a sinalização --project_id para especificar um projeto determinado. Se --project_id não for especificado, o projeto padrão será usado.
dataset é o conjunto de dados de destino na configuração da transferência de dados.
name é o nome de exibição da configuração de transferência de dados. O nome da transferência pode ser
qualquer valor que permita identificá-la facilmente, caso precise
modificá-la mais tarde.
parameters contém os parâmetros da configuração da
transferência de dadps criada no formato JSON. Por exemplo, --params='{"param":"param_value"}'.
css_id: o ID do domínio do CSS.
export_products: se é necessário ou não transferir os dados
do produto e de problemas do produto. Esse parâmetro está incluído por padrão, mesmo que
você não especifique o parâmetro export_products. Recomendamos
que você inclua esse parâmetro explicitamente e o defina como true.
data_source é a fonte de dados: css_center.
Por exemplo, o comando a seguir cria uma transferência de dados do CSS Center chamada My Transfer usando o ID de domínio do CSS 1234 e o conjunto de dados de destino mydataset. A transferência de dados é criada no projeto padrão.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-28 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."]]
