Riset alur terjemahan produk Shopify dengan AI

Pilih jalur terjemahan yang Anda perlukan

Gunakan tool merchant Shopify saat editor dapat mengelola terjemahan secara langsung. Gunakan GraphQL Admin API saat membutuhkan antrean peninjauan eksternal yang berulang dan developer dapat memelihara aplikasinya. Pada jalur API, client model terpisah menyusun teks sementara Shopify menangani terjemahan tersimpan.

Mulai dengan development store dan satu produk. Baca kolom yang dapat diterjemahkan, siapkan kandidat, dapatkan peninjauan, baru kirim perubahan yang dimaksud. Pisahkan pengaturan model, kredensial toko, dan izin publikasi agar setiap langkah dapat diperiksa serta dikoreksi secara mandiri.

Pilih workflow merchant atau aplikasi

Dokumentasi Shopify Translate & Adapt menjelaskan pengeditan manual dan terjemahan otomatis, dengan peninjauan sebelum publikasi. Ini mungkin cukup saat merchant menginginkan kontrol editorial langsung tanpa membangun aplikasi. Integrasi kustom hanya masuk akal bila kebutuhan spesifik, seperti antrean peninjauan eksternal, membenarkan kepemilikan connector.

Pilih berdasarkan siapa yang memelihara antrean tinjauan dan pemetaan kolom. Untuk app pihak ketiga, periksa konfigurasi, izin, dan perilaku ekspor yang terdokumentasi sebelum instalasi. Editor yang menghadap merchant dan aplikasi dengan penyusunan model eksternal menyelesaikan kebutuhan operasional yang berbeda.

Rencanakan autentikasi dan batas versi

Referensi translatableResource memerlukan read_translations; translationsRegister memerlukan write_translations. Gunakan development store dan catat instalasi app, versi API, serta scope yang diberikan saat pengujian. Kredensial gateway LLM tidak mengautentikasi request Shopify Admin API, dan token Shopify tidak boleh dikirim ke endpoint model.

Mulai dengan akses baca untuk discovery bila desain aplikasi memungkinkan. Tambahkan hanya izin untuk workflow berotorisasi berikutnya. Pin versi API yang didukung setelah memeriksa referensinya, bukan deploy terhadap alias latest yang tidak tercatat. Simpan token di sisi server dan kecualikan dari ekspor peninjauan serta log request.

Baca kolom yang dapat diterjemahkan bersama digest-nya

Query terdokumentasi mengembalikan resource identifier dan entri yang dapat diterjemahkan dengan key, value, digest, serta locale. Pertahankan digest khusus kolom dengan snapshot sumber. Digest menghubungkan terjemahan yang diusulkan ke konten yang benar-benar dibaca, bukan ke judul produk yang disalin dari spreadsheet.

Query di bawah diadaptasi dari schema resmi sebagai contoh read-only. Berikan product GID berotorisasi dalam lingkungan development. Periksa key yang dikembalikan dan gunakan allowlist kolom eksplisit; gunakan locale sumber yang dikembalikan, jangan menyimpulkannya dari bahasa browser.

query TranslationSource($resourceId: ID!) {
  translatableResource(resourceId: $resourceId) {
    resourceId
    translatableContent {
      key
      value
      digest
      locale
    }
  }
}

Buat kandidat terjemahan di luar Shopify

Buat record kandidat internal yang berisi resource ID, field key, source digest, target locale, revisi glosarium, dan draft value. Kirim hanya teks serta konteks produk yang diperlukan ke model. Jauhkan SKU, harga, mata uang, inventaris, dan identitas varian dari patch yang dibuat.

Validasi teks wajib, placeholder, dan terminologi yang disetujui sebelum peninjau dwibahasa melihat kandidat. Minta peninjau produk memeriksa klaim serta peringatan terhadap sumber asli. Ekstensi browser yang menerjemahkan storefront tidak membuat record ini atau membuktikan Shopify telah menyimpan terjemahan; ekstensi hanya alat inspeksi.

Daftarkan hanya terjemahan terkini yang disetujui

Mutation translationsRegister menerima kolom terjemahan dengan translatableContentDigest. Hasil terdokumentasi mencakup userErrors. Connector harus memeriksa hasil itu, bukan menganggap response HTTP saja sebagai bukti registrasi berhasil.

Sebelum penulisan berotorisasi, bandingkan sumber saat ini dengan snapshot yang ditinjau. Jika berubah, tahan kandidat dan dapatkan peninjauan baru. Simpan daftar kolom yang dimaksudkan untuk diubah serta terjemahan sebelumnya untuk pemulihan. Mulai dengan satu kolom di development store dan baca kembali sebelum memperluas patch.

Verifikasi storefront secara terpisah

Terjemahan tersimpan dan ketersediaan storefront adalah checkpoint terpisah dalam workflow Shopify. Rencanakan konfigurasi locale dan pemeriksaan theme bersama merchant. Menyimpan nilai terjemahan tidak otomatis mengotorisasi publikasi bahasa atau perubahan pengaturan pasar.

Di development store, periksa produk target, pemilih locale, konten fallback, tautan, dan label varian. Baca kembali terjemahan tersimpan dan bandingkan dengan nilai yang disetujui. Jika kolom tidak ada, selidiki dukungan resource atau rendering theme sebelum membuat terjemahan lain. Pertahankan observasi tanpa menyajikan development store sebagai keberhasilan merchant live.

Bukti dan batas connector

Referensi resmi menetapkan interface terjemahan Shopify. Aplikasi yang terhubung ke APIsRouter belum diuji di sini, dan sumber yang ditinjau tidak menetapkan pengaturan baseURL gateway arbitrer di Shopify atau Translate & Adapt. Perlakukan jalur aplikasi kustom sebagai riset connector sampai memiliki hasil development store.

Tes lengkap harus mempertahankan versi aplikasi, catatan autentikasi berscope, query sumber, kandidat, persetujuan, hasil registrasi, dan perbandingan baca ulang. Sertakan konflik perubahan sumber serta request yang ditolak. Catat identitas model dan penggunaan secara terpisah dari operasi toko agar klaim kompatibilitas memiliki cakupan jelas.

Pertanyaan umum