پژوهش گردش‌کار ترجمه محصول Shopify با AI

مسیر ترجمه موردنیاز را انتخاب کنید

وقتی ویرایشگر می‌تواند ترجمه‌ها را مستقیم مدیریت کند از ابزارهای تاجر Shopify استفاده کنید. وقتی صف بازبینی خارجی تکرارشونده می‌خواهید و توسعه‌دهنده‌ای می‌تواند برنامه را نگه دارد از GraphQL Admin API استفاده کنید. در مسیر API، client مدل جداگانه متن را پیش‌نویس و Shopify ترجمه‌های ذخیره‌شده را مدیریت می‌کند.

با فروشگاه development و یک محصول شروع کنید. فیلدهای قابل‌ترجمه آن را بخوانید، نامزد آماده کنید، بازبینی بگیرید و فقط بعد تغییرات موردنظر را submit کنید. تنظیمات مدل، اعتبارنامه فروشگاه و مجوز انتشار را جدا نگه دارید تا هر مرحله مستقل بررسی و اصلاح شود.

گردش‌کار تاجر یا برنامه را انتخاب کنید

مستندات Translate & Adapt Shopify ویرایش دستی و ترجمه خودکار را با بازبینی پیش از انتشار توضیح می‌دهد. وقتی تاجر کنترل ویراستاری مستقیم بدون ساخت برنامه می‌خواهد، این ممکن است کافی باشد. integration سفارشی فقط وقتی منطقی است که نیاز مشخصی مانند صف بازبینی خارجی مالکیت connector را توجیه کند.

بر اساس مالک صف بازبینی و نگاشت فیلد انتخاب کنید. برای برنامه ثالث، پیش از نصب پیکربندی مستند، مجوزها و رفتار خروجی‌گیری آن را بررسی کنید. ویرایشگر رو‌به‌تاجر و برنامه دارای پیش‌نویس مدل خارجی نیاز عملیاتی یکسانی حل نمی‌کنند.

مرزهای احراز هویت و نسخه را برنامه‌ریزی کنید

مرجع translatableResource به read_translations و translationsRegister به write_translations نیاز دارد. برای آزمون از فروشگاه development استفاده و نصب برنامه، API version و scopeهای داده‌شده را ثبت کنید. اعتبارنامه gateway LLM درخواست Shopify Admin API را احراز نمی‌کند و token Shopify نباید به endpoint مدل ارسال شود.

هرجا طراحی برنامه اجازه می‌دهد برای کشف از دسترسی read شروع کنید. فقط مجوزهای لازم گردش‌کار مجاز بعدی را اضافه کنید. پس از بررسی reference، API version پشتیبانی‌شده را pin و با alias latest ثبت‌نشده deploy نکنید. tokenها را سمت سرور نگه دارید و از خروجی بازبینی و log درخواست خارج کنید.

فیلدهای قابل‌ترجمه را همراه digest بخوانید

query مستند یک resource identifier و entryهای قابل‌ترجمه با key، value، digest و locale برمی‌گرداند. digestهای ویژه هر فیلد را با snapshot منبع نگه دارید. آن‌ها ترجمه پیشنهادی را به محتوایی که واقعاً خوانده شده وصل می‌کنند، نه عنوان محصولی که از spreadsheet کپی شده است.

query زیر از schema رسمی به‌عنوان نمونه فقط‌خواندنی سازگار شده است. در محیط development یک product GID مجاز بدهید. keyهای برگشتی را بررسی و allowlist صریح فیلد استفاده کنید؛ locale منبع برگشتی را از زبان مرورگر استنباط نکنید.

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

نامزد ترجمه را بیرون از Shopify تولید کنید

رکورد نامزد داخلی شامل resource ID، field key، source digest، locale هدف، revision واژه‌نامه و مقدار پیش‌نویس بسازید. فقط متن و زمینه ضروری محصول را به مدل بفرستید. SKU، قیمت، ارز، موجودی و هویت variant را از patch تولیدشده بیرون نگه دارید.

پیش از دیدن نامزد توسط بازبین دوزبانه، متن لازم، placeholder و اصطلاحات تأییدشده را اعتبارسنجی کنید. از بازبین محصول بخواهید ادعا و هشدار را با منبع اصلی بررسی کند. افزونه مرورگری که storefront را ترجمه می‌کند این رکورد را نمی‌سازد و ذخیره ترجمه در Shopify را ثابت نمی‌کند؛ فقط ابزار بازرسی است.

فقط ترجمه‌های جاری و تأییدشده را ثبت کنید

mutation مربوط به translationsRegister فیلدهای ترجمه‌شده با translatableContentDigest را می‌پذیرد. نتیجه مستند آن userErrors را شامل می‌شود. connector باید آن نتیجه را بررسی کند و پاسخ HTTP را به‌تنهایی اثبات ثبت موفق نداند.

پیش از نوشتن مجاز، منبع جاری را با snapshot بازبینی‌شده مقایسه کنید. اگر تغییر کرده، نامزد را متوقف و بازبینی جدید بگیرید. فهرست صریح فیلدهای موردنظر و ترجمه‌های قبلی برای بازیابی نگه دارید. با یک فیلد در فروشگاه development شروع و پیش از گسترش patch آن را دوباره بخوانید.

storefront را جداگانه تأیید کنید

در گردش‌کار مستند Shopify، ترجمه ذخیره‌شده و دسترس‌پذیری storefront checkpointهای جدا هستند. پیکربندی locale و کنترل theme را با تاجر برنامه‌ریزی کنید. ذخیره مقدار ترجمه‌شده خودکار مجوز انتشار زبان یا تغییر تنظیمات بازار نیست.

در فروشگاه development محصول هدف، انتخابگر locale، محتوای fallback، پیوندها و labelهای variant را بررسی کنید. ترجمه ذخیره‌شده را دوباره بخوانید و با مقدار تأییدشده مقایسه کنید. اگر فیلدی غایب است، پیش از تولید ترجمه دیگر پشتیبانی resource یا render theme را بررسی کنید. مشاهده‌ها را نگه دارید و فروشگاه development را موفقیت زنده تاجر معرفی نکنید.

شواهد و محدودیت‌های connector

مراجع رسمی رابط‌های ترجمه Shopify را تثبیت می‌کنند. برنامه متصل به APIsRouter اینجا آزمایش نشده است و منابع بررسی‌شده تنظیم عمومی gateway baseURL در Shopify یا Translate & Adapt را ثابت نمی‌کنند. مسیر برنامه سفارشی را تا رسیدن به نتیجه فروشگاه development پژوهش connector بدانید.

برای آزمون کامل، نسخه برنامه، رکورد احراز هویت محدود، query منبع، نامزد، تأیید، نتیجه ثبت و مقایسه read-back را نگه دارید. تعارض تغییر منبع و درخواست ردشده را هم وارد کنید. هویت و مصرف مدل را از عملیات فروشگاه جدا ثبت کنید تا دامنه ادعای سازگاری روشن باشد.

پرسش‌های پرتکرار