Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Pianificare un trasferimento del Comparison Shopping Service Center
Questo documento mostra come pianificare e gestire i job di caricamento ricorrenti per i dati dei report del CSS Center utilizzando BigQuery Data Transfer Service.
Prima di iniziare
Prima di creare un trasferimento di dati CSS Center:
Per la regione del set di dati, supportiamo l'utilizzo dell'opzione predefinita, ovvero Più regioni, negli
Stati Uniti o nell'UE.
Se vuoi creare un set di dati in una regione specifica, il trasferimento dei dati di CSS Center
è supportato solo nelle seguenti regioni:
us-east4 (Northern Virginia),
asia-northeast1 (Tokyo),
asia-southeast1 (Singapore),
australia-southeast1 (Sydney),
europe-north1 (Findland),
europe-west2 (London),
europe-west6 (Zurich).
Per creare un trasferimento di dati CSS Center, devi disporre dell'ID dominio CSS.
Se intendi configurare le notifiche di esecuzione del trasferimento per Pub/Sub, devi disporre delle autorizzazioni pubsub.topics.setIamPolicy. Le autorizzazioni Pub/Sub
non sono necessarie se configuri solo le notifiche email. Per saperne di più, consulta Notifiche di esecuzione di BigQuery Data Transfer Service.
Autorizzazioni obbligatorie
Assicurati che l'utente che crea il trasferimento dei dati disponga delle seguenti autorizzazioni
richieste.
Questo ruolo predefinito contiene
le autorizzazioni necessarie per creare un trasferimento. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per creare un trasferimento sono necessarie le seguenti autorizzazioni:
bigquery.transfers.update
sull'utente
bigquery.datasets.get
sul set di dati di destinazione
bigquery.datasets.update
sul set di dati di destinazione
Nella sezione Tipo di origine, per Origine, scegli
Google CSS Center.
Nella sezione Nome configurazione di trasferimento, per Nome visualizzato, inserisci un nome per il trasferimento di dati, ad esempio My Transfer. Il nome del trasferimento può essere qualsiasi valore che ti consenta di identificare il trasferimento se devi modificarlo in un secondo momento.
La sezione Opzioni di pianificazione non è configurabile. I trasferimenti di dati di CSS Center sono pianificati per essere eseguiti una volta ogni 24 ore.
Nella sezione Impostazioni destinazione, per Set di dati di destinazione,
scegli il set di dati che hai creato per archiviare i dati.
Nella sezione Dettagli origine dati, in ID CSS, inserisci l'ID dominio CSS.
Seleziona i report da trasferire. Per ulteriori dettagli, vedi Report supportati.
(Facoltativo) Nella sezione Opzioni di notifica:
Fai clic sul pulsante di attivazione/disattivazione per abilitare le notifiche via email. Quando attivi questa opzione, l'amministratore del trasferimento riceve una notifica via email quando l'esecuzione di un trasferimento non riesce.
In Seleziona un argomento Pub/Sub, scegli il nome dell'argomento o fai clic su Crea un argomento.
Questa opzione configura le notifiche di esecuzione di Pub/Sub per il trasferimento di dati.
Fai clic su Salva.
bq
Inserisci il comando bq mk e fornisci il flag di creazione del trasferimento: --transfer_config. Sono necessari anche i seguenti flag:
--data_source
--target_dataset
--display_name
--params
Puoi anche fornire il flag --project_id per specificare un progetto
particolare. Se --project_id non è specificato, viene utilizzato il progetto predefinito.
dataset è il set di dati di destinazione per la configurazione del trasferimento dei dati.
name è il nome visualizzato per la configurazione del trasferimento di dati. Il nome del trasferimento può essere qualsiasi valore che ti consenta di identificare il trasferimento se devi modificarlo in un secondo momento.
parameters contiene i parametri per la configurazione del trasferimento dei dati
creata in formato JSON. Ad esempio:
--params='{"param":"param_value"}'.
css_id: l'ID dominio CSS.
export_products: se trasferire o meno i dati relativi a prodotti e problemi dei prodotti. Questo parametro è incluso per impostazione predefinita, anche se non specifichi il parametro export_products. Ti consigliamo
di includere questo parametro in modo esplicito e di impostarlo su true.
data_source è l'origine dati: css_center.
Ad esempio, il seguente comando crea un trasferimento di dati CSS Center
denominato My Transfer utilizzando l'ID dominio CSS 1234 e il set di dati di destinazione
mydataset. Il trasferimento dei dati viene creato nel tuo progetto predefinito.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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."]]
