Menjadwalkan Transfer Google Merchant Center

Pratinjau

Produk ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Catatan: Guna mendapatkan dukungan atau memberikan masukan terkait transfer Google Merchant Center dengan BigQuery Data Transfer Service, hubungi [e-mail].

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:

  • Akses standar ke akun Google Merchant Center yang digunakan dalam konfigurasi transfer. Anda dapat memverifikasi akses dengan mengklik bagian Pengguna di UI Google Merchant Center.

  • Untuk mengakses data daya saing harga dan terlaris, Anda harus memenuhi persyaratan kelayakan untuk analisis pasar.

Menyiapkan transfer Google Merchant Center

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

• ID Penjual atau ID akun multiklien: Ini adalah ID Penjual yang ditampilkan di UI Google Merchant Center.

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.

     

   • 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.

       

       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.

     

   • 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.

     

   • 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.

     • Jika Anda login dengan identitas gabungan, akun layanan diperlukan untuk membuat transfer. Jika Anda login dengan Akun Google, akun layanan untuk transfer bersifat opsional.
     • Akun layanan harus memiliki izin yang diperlukan.

   • (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.

Perhatian: Anda tidak dapat mengonfigurasi notifikasi menggunakan alat command line.

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.

Perhatian: Saat Anda membuat transfer Google Merchant Center menggunakan alat command line, konfigurasi transfer akan disiapkan menggunakan nilai default untuk Schedule (setiap 24 jam pada waktu pembuatan). Proses transfer pertama akan segera dimulai, dan akan gagal dengan pesan error berikut: `No data to transfer found for the Merchant account.

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.