Menyiapkan penyimpanan data Shopify

Halaman ini menjelaskan cara membuat penyimpanan data dan menghubungkan Shopify ke Gemini Enterprise.

Sebelum memulai

Sebelum menyiapkan koneksi Shopify, pastikan Anda memiliki hal berikut:

  • Berikan peran Discovery Engine Editor (roles/discoveryengine.editor). Peran ini diperlukan agar pengguna dapat membuat penyimpanan data. Untuk memberikan peran ini, lakukan hal berikut:
    1. Di konsol Google Cloud , buka halaman IAM.

      Buka IAM

    2. Temukan akun pengguna, lalu klik edit Edit.
    3. Berikan peran Discovery Engine Editor kepada pengguna. Untuk mengetahui informasi selengkapnya, lihat Peran dan izin IAM.

Membuat penyimpanan data Shopify

Untuk membuat penyimpanan data Shopify, lakukan langkah-langkah berikut:

  1. Di konsol Google Cloud , buka halaman Gemini Enterprise.

    Gemini Enterprise

  2. Pilih atau buat project Google Cloud .

  3. Di menu navigasi, klik Penyimpanan data.

  4. Klik Buat penyimpanan data.

  5. Di bagian Source, telusuri Shopify, lalu klik Select.

  6. Di bagian Data:

    1. Di bagian Authentication settings, masukkan detail berikut:

      • Client ID: ID untuk aplikasi OAuth 2.0 Anda.
      • Rahasia klien: Kunci rahasia yang terkait dengan aplikasi OAuth 2.0 Anda.
      • URL Toko: URL toko Shopify. Contoh, https://abc-123.myshopify.com.

      Untuk mengetahui informasi selengkapnya tentang kredensial, lihat Konfigurasi Shopify.

    2. Di bagian Destinations, lakukan tindakan berikut:

      1. Di kolom Shop URL, masukkan URL toko Shopify. Contoh, https://abc-123.myshopify.com.

      2. Klik Lanjutkan.

    3. Di bagian Entities to search, pilih semua entity yang diperlukan.

  7. Klik Lanjutkan.

  8. Di bagian Actions, untuk Select Shopify actions to enable, pilih tindakan dari kategori untuk mengaktifkannya bagi penyimpanan data.

    Untuk mengelola daftar tindakan, lihat Mengelola tindakan.

  9. Klik Lanjutkan.

  10. Jika alur pembuatan penyimpanan data menampilkan bagian Advanced options, Anda dapat mencentang kotak Enable Static IP Addresses di dalamnya. Hal ini memastikan penyimpanan data menggunakan kumpulan alamat IP tetap untuk traffic keluar, yang cocok untuk dimasukkan ke daftar yang diizinkan di sistem sumber. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi egress IP statis.

  11. Di bagian Configuration:

    1. Dari daftar Multi-region, pilih lokasi untuk konektor data Anda.
    2. Di kolom Nama konektor data Anda, masukkan nama untuk konektor Anda.
    3. Jika Anda memilih us atau eu sebagai lokasi, konfigurasikan Setelan enkripsi:
      • Opsional: Jika Anda belum mengonfigurasi kunci satu region, klik Buka halaman setelan untuk melakukannya. Untuk mengetahui informasi selengkapnya, lihat Mendaftarkan kunci satu region untuk konektor pihak ketiga.
      • Pilih Google-managed encryption key atau Cloud KMS key.
      • Jika Anda memilih Cloud KMS key:
        • Dalam daftar Key management type, pilih jenis yang sesuai.
        • Di daftar Cloud KMS key, pilih kunci.
      Untuk mengetahui informasi selengkapnya, lihat Kunci enkripsi yang dikelola pelanggan.

  12. Klik Lanjutkan.

  13. Di bagian Penagihan, pilih Harga umum atau Harga yang dapat dikonfigurasi. Untuk informasi selengkapnya, lihat Memverifikasi status penagihan project dan Lisensi.

  14. Klik Create. Gemini Enterprise akan membuat penyimpanan data Anda dan menampilkannya di halaman Data Stores.

Di halaman Data Stores, klik nama penyimpanan data Anda untuk melihat statusnya. Setelah status penyimpanan data berubah dari Creating menjadi Active, konektor Shopify siap digunakan.

Setelah membuat penyimpanan data, hubungkan penyimpanan data yang baru saja Anda buat ke aplikasi yang ada atau buat aplikasi baru dan hubungkan ke aplikasi baru, lalu izinkan Gemini Enterprise untuk mengakses Shopify sebelum menjalankan kueri apa pun. Untuk mengetahui lebih lanjut, lihat Langkah selanjutnya.

Penanganan data dan eksekusi kueri

Bagian ini menjelaskan cara Gemini Enterprise mengelola kueri Anda dan implikasi privasi dari penggunaan penyimpanan data gabungan.

Eksekusi kueri

Setelah Anda memberikan otorisasi kepada Shopify dan mengirim kueri penelusuran ke Gemini Enterprise:

  • Gemini Enterprise mengirimkan kueri penelusuran Anda langsung ke API Shopify.
  • Gemini Enterprise menggabungkan hasil tersebut dengan hasil dari sumber data lain yang terhubung dan menampilkan hasil penelusuran yang komprehensif.

Penanganan data

Saat menggunakan penelusuran gabungan pihak ketiga, aturan penanganan data berikut berlaku:

  • String kueri Anda dikirim ke backend penelusuran pihak ketiga (Shopify API).
  • Pihak ketiga ini dapat mengaitkan kueri dengan identitas Anda.
  • Jika beberapa sumber data penelusuran gabungan diaktifkan, kueri mungkin akan dikirim ke semua sumber data tersebut.
  • Setelah data mencapai sistem pihak ketiga, data tersebut akan diatur oleh persyaratan layanan dan kebijakan privasi sistem tersebut.

Langkah berikutnya