Menjadwalkan Transfer Google Merchant Center

Sebelum memulai

Sebelum melakukan transfer Google Merchant Center:

  • Pastikan Anda telah menyelesaikan semua tindakan yang diperlukan untuk mengaktifkan BigQuery Data Transfer Service.
  • Buat set data BigQuery untuk menyimpan data Google Merchant Center.
    • Untuk region set data, kami mendukung penggunaan opsi default, Multi-region, baik di AS maupun UE.
    • Jika Anda ingin membuat set data di region tertentu, transfer data Merchant Center hanya didukung di region berikut:
    • us-east4 (Northern Virginia),
    • asia-northeast1 (Tokyo),
    • asia-southeast1 (Singapore),
    • australia-southeast1 (Sydney),
    • europe-north1 (Finland),
    • europe-west2 (London),
    • europe-west6 (Zurich).
  • Jika ingin menyiapkan notifikasi proses transfer untuk Pub/Sub, Anda harus memiliki izin pubsub.topics.setIamPolicy. Izin Pub/Sub tidak diperlukan jika Anda baru saja menyiapkan notifikasi email. Untuk mengetahui informasi selengkapnya, baca Notifikasi Operasi BigQuery Data Transfer Service.

Izin yang diperlukan

Pastikan orang yang melakukan transfer memiliki izin yang diperlukan berikut:

  • BigQuery:

    • Izin bigquery.transfers.update untuk membuat transfer
    • Izin bigquery.datasets.get dan bigquery.datasets.update pada set data target

    Peran IAM bigquery.admin yang telah ditetapkan mencakup izin bigquery.transfers.update, bigquery.datasets.update, dan bigquery.datasets.get. Untuk informasi lebih lanjut tentang peran IAM dalam BigQuery Data Transfer Service, lihat Kontrol akses.

  • Google Merchant Center:

Menyiapkan transfer Google Merchant Center

Menyiapkan transfer data untuk pelaporan Google Merchant Center memerlukan hal berikut:

Guna melakukan transfer data untuk pelaporan Google Merchant Center:

Konsol

  1. Buka halaman BigQuery di konsol Google Cloud.

    Buka halaman BigQuery

  2. Klik Data transfers.

  3. Klik Create Transfer.

  4. Di halaman Create Transfer:

    • Di bagian Source type, pilih Google Merchant Center untuk Source.

    • Di bagian Transfer config name, untuk Display name, masukkan nama untuk transfer, misalnya My Transfer. Nama transfer dapat berupa nilai apa pun yang memungkinkan Anda mengidentifikasi transfer jika perlu mengubahnya nanti.

      Nama transfer

    • Di bagian Schedule options:

      • Pilih Repeat frequency. Jika memilih Jam, Hari, Minggu, atau Bulan, Anda juga harus menentukan frekuensinya. Anda juga dapat memilih Custom untuk menentukan frekuensi pengulangan kustom. Jika Anda memilih On-demand, transfer ini akan berjalan saat Anda memicu transfer secara manual.

      • Jika perlu, pilih Start now atau Start at set time, lalu masukkan tanggal mulai dan waktu proses.

      • Untuk Start date and run time, masukkan tanggal dan waktu untuk memulai transfer. Nilai ini harus setidaknya 24 jam lebih lambat dari waktu UTC saat ini. Jika Anda memilih Start now, opsi ini akan dinonaktifkan.

        Jadwal transfer

        Jika Anda membiarkan opsi jadwal disetel ke Start now, proses transfer pertama akan segera dimulai dan akan gagal dengan pesan error berikut: No data to transfer found for the Merchant account. If you have just created this transfer, you may need to wait for up to a day before the data of your Merchant account are prepared and available for the transfer. Proses terjadwal berikutnya akan berhasil dijalankan. Jika data akun Penjual Anda disiapkan pada tanggal yang sama dalam waktu UTC, Anda dapat menyiapkan pengisian ulang untuk proses hari ini.

    • Di bagian Destination settings, untuk Destination dataset, pilih set data yang Anda buat untuk menyimpan data.

      Mentransfer set data

    • Di bagian Data source details, untuk Merchant ID, masukkan ID Penjual atau ID MCA Anda.

      Pilih laporan yang ingin Anda transfer. Lihat Laporan yang Didukung untuk detail selengkapnya.

      Transfer data Google Merchant Center.

    • Di menu Service Account, pilih service account dari akun layanan yang terkait dengan project Google Cloud Anda. Anda dapat mengaitkan akun layanan dengan transfer Anda, bukan menggunakan kredensial pengguna. Untuk mengetahui informasi selengkapnya tentang cara menggunakan akun layanan dengan transfer data, lihat Menggunakan akun layanan.

    • (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 Anda.
  5. Klik Save.

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.

bq mk \
--transfer_config \
--project_id=project_id \
--target_dataset=dataset \
--display_name=name \
--params='parameters' \
--data_source=data_source
--service_account_name=service_account_name

Dengan keterangan:

  • project_id adalah project ID Anda.
  • dataset adalah set data target untuk konfigurasi transfer.
  • name adalah nama tampilan untuk konfigurasi transfer. Nama transfer dapat berupa nilai apa pun yang memungkinkan Anda mengidentifikasi transfer jika perlu mengubahnya nanti.
  • parameters berisi parameter untuk konfigurasi transfer yang dibuat dalam format JSON. Contoh: --params='{"param":"param_value"}'.
    • Untuk transfer Google Merchant Center, Anda harus memberikan parameter merchant_id.
    • Parameter export_products menentukan apakah akan mentransfer data produk dan masalah produk atau tidak. Parameter ini disertakan secara default, meskipun Anda tidak menentukan parameter export_products. Google merekomendasikan agar Anda menyertakan parameter ini secara eksplisit dan menetapkannya ke "benar".
    • Parameter export_regional_inventories menentukan apakah akan mentransfer data inventaris regional atau tidak.
    • Parameter export_local_inventories menentukan apakah akan mentransfer data inventaris lokal atau tidak.
    • Parameter export_price_competitiveness menentukan apakah akan mentransfer data persaingan harga atau tidak.
    • Parameter export_price_insights menentukan apakah akan mentransfer data analisis harga atau tidak.
    • Parameter export_best_sellers_v2 menentukan apakah akan mentransfer data terlaris atau tidak.
    • Parameter export_performance menentukan apakah akan mentransfer data performa produk atau tidak.
  • data_source adalah sumber data — merchant_center.
  • service_account_name adalah nama akun layanan yang digunakan untuk mengautentikasi transfer Anda. Akun layanan harus dimiliki oleh project_id yang sama dengan yang digunakan untuk membuat transfer dan harus memiliki semua izin yang diperlukan.

Misalnya, perintah berikut akan membuat transfer Google Merchant Center bernama My Transfer menggunakan ID Penjual 1234 dan set data target mydataset. Transfer dibuat di project default Anda.

bq mk \
--transfer_config \
--target_dataset=mydataset \
--display_name='My Transfer' \
--params='{"merchant_id":"1234","export_products":"true","export_regional_inventories":"true","export_local_inventories":"true","export_price_benchmarks":"true","export_best_sellers":"true"}' \
--data_source=merchant_center

Saat pertama kali menjalankan perintah ini, Anda akan menerima pesan seperti berikut:

[URL omitted] Please copy and paste the above URL into your web browser and follow the instructions to retrieve an authentication code.

Ikuti petunjuk dalam pesan, lalu tempel kode autentikasi pada command line.

Jika Anda baru saja membuat transfer ini, Anda mungkin perlu menunggu hingga satu hari sebelum data akun Penjual disiapkan dan tersedia untuk transfer.` Proses terjadwal berikutnya akan berhasil berjalan. Jika data akun Penjual disiapkan pada tanggal yang sama dalam waktu UTC, Anda dapat menyiapkan pengisian ulang untuk proses hari ini.

API

Gunakan metode projects.locations.transferConfigs.create dan berikan instance resource TransferConfig.

Memecahkan masalah penyiapan transfer Google Merchant Center

Jika Anda mengalami masalah saat menyiapkan transfer, lihat Masalah transfer Google Merchant Center di Memecahkan masalah penyiapan transfer BigQuery Data Transfer Service.