Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Menjadwalkan Transfer Comparison Shopping Service Center
Dokumen ini menunjukkan cara menjadwalkan dan mengelola tugas pemuatan berulang untuk
data pelaporan Pusat CSS menggunakan BigQuery Data Transfer Service.
Untuk region set data, kami mendukung penggunaan opsi default, Multi-region, di
AS atau Uni Eropa.
Jika Anda ingin membuat set data di region tertentu, transfer data CSS Center hanya didukung di region berikut:
us-east4 (Northern Virginia),
asia-northeast1 (Tokyo),
asia-southeast1 (Singapore),
australia-southeast1 (Sydney),
europe-north1 (Findland),
europe-west2 (London),
europe-west6 (Zurich).
Anda harus memiliki ID domain CSS untuk membuat transfer data CSS Center.
Jika ingin menyiapkan notifikasi proses transfer untuk Pub/Sub, Anda harus memiliki izin pubsub.topics.setIamPolicy. Izin Pub/Sub tidak diperlukan jika Anda hanya menyiapkan notifikasi email. Untuk mengetahui
informasi selengkapnya, baca
Notifikasi Operasi BigQuery Data Transfer Service.
Izin yang diperlukan
Pastikan pengguna yang membuat transfer data memiliki izin yang diperlukan berikut.
Untuk BigQuery:
Untuk mendapatkan izin yang diperlukan guna membuat transfer,
minta administrator untuk memberi Anda
peran IAM BigQuery Admin (roles/bigquery.admin).
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran bawaan ini berisi
izin yang diperlukan untuk membuat transfer. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:
Di bagian Source type, untuk Source, pilih Google CSS Center.
Di bagian Transfer config name, untuk Display name, masukkan nama untuk transfer data, misalnya My Transfer. Nama transfer dapat berupa nilai apa pun yang memungkinkan Anda mengidentifikasi transfer jika perlu mengubahnya nanti.
Bagian Opsi jadwal tidak dapat dikonfigurasi. Transfer data Pusat CSS dijadwalkan untuk berjalan sekali setiap 24 jam.
Di bagian Destination settings, untuk Destination dataset,
pilih set data yang Anda buat untuk menyimpan data.
Di bagian Detail sumber data, untuk ID CSS, masukkan ID domain CSS Anda.
Pilih laporan yang ingin Anda transfer. Lihat
Laporan yang didukung
untuk mengetahui detail selengkapnya.
(Opsional) Di bagian Notification options:
Klik tombol untuk mengaktifkan notifikasi email. Saat Anda mengaktifkan opsi ini, administrator transfer akan menerima notifikasi email saat proses transfer gagal.
Untuk Select a Pub/Sub topic, pilih nama topik atau klik Create a topic.
Opsi ini mengonfigurasi notifikasi operasi Pub/Sub untuk transfer data Anda.
Klik Simpan.
bq
Masukkan perintah bq mk dan berikan flag pembuatan transfer — --transfer_config. Flag berikut juga diperlukan:
--data_source
--target_dataset
--display_name
--params
Anda juga dapat memberikan flag --project_id untuk menentukan project
tertentu. Jika --project_id tidak ditentukan, project default akan digunakan.
dataset adalah set data target untuk konfigurasi transfer data.
name adalah nama tampilan untuk konfigurasi transfer data. Nama transfer dapat berupa nilai apa pun yang memungkinkan Anda mengidentifikasi transfer jika perlu mengubahnya nanti.
parameters berisi parameter untuk konfigurasi transfer data yang dibuat dalam format JSON. Contoh: --params='{"param":"param_value"}'.
css_id: ID domain CSS.
export_products: apakah akan mentransfer data produk dan masalah produk atau tidak. Parameter ini disertakan secara default, meskipun
Anda tidak menentukan parameter export_products. Sebaiknya
sertakan parameter ini secara eksplisit dan tetapkan ke true.
data_source adalah sumber data — css_center.
Misalnya, perintah berikut akan membuat transfer data Pusat CSS
bernama My Transfer menggunakan ID domain CSS 1234 dan set data target
mydataset. Transfer data dibuat di project default Anda.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-17 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."]]
