Shopify AI product translation workflow research

اپنی ضرورت کے مطابق translation path چنیں

جب editor translations براہ راست manage کر سکے تو Shopify کے merchant tools استعمال کریں۔ Repeatable external review queue درکار ہو اور developer application maintain کر سکے تو GraphQL Admin API استعمال کریں۔ API path میں الگ model client text draft کرتا ہے اور Shopify stored translations handle کرتا ہے۔

Development store اور ایک product سے شروع کریں۔ اس کے translatable fields پڑھیں، candidate تیار کریں، review لیں اور پھر intended changes submit کریں۔ Model settings، store credentials اور publication permissions الگ رکھیں تاکہ ہر step independently inspect اور correct ہو سکے۔

Merchant workflow یا application منتخب کریں

Shopify Translate & Adapt documentation manual editing اور automatic translation کو review-before-publication کے ساتھ بیان کرتی ہے۔ جب merchant application بنائے بغیر direct editorial control چاہتا ہو تو یہ کافی ہو سکتا ہے۔ Custom integration صرف اس وقت مناسب ہے جب external review queue جیسی specific requirement connector own کرنے کا جواز دے۔

Review queue اور field mapping کون maintain کرے گا، اس کے مطابق انتخاب کریں۔ Third-party app ہو تو installation سے پہلے اس کی documented configuration، permissions اور export behavior inspect کریں۔ Merchant-facing editor اور external model drafting والی application مختلف operational needs حل کرتی ہیں۔

Authentication اور version boundaries plan کریں

translatableResource reference کو read_translations چاہیے؛ translationsRegister کو write_translations۔ Testing کے لیے development store استعمال کریں اور app installation، API version اور granted scopes record کریں۔ LLM gateway credential Shopify Admin API request کو authenticate نہیں کرتی، اور Shopify token model endpoint کو نہیں بھیجنا چاہیے۔

جہاں application design اجازت دے، discovery کے لیے read access سے شروع کریں۔ Later authorized workflow کے لیے صرف ضروری permissions add کریں۔ Reference چیک کرنے کے بعد supported API version pin کریں؛ unrecorded latest alias پر deploy نہ کریں۔ Tokens server-side رکھیں اور review exports اور request logs سے نکالیں۔

Translatable fields ان کے digests کے ساتھ پڑھیں

Documented query resource identifier اور key، value، digest اور locale والی translatable entries واپس کرتی ہے۔ Field-specific digests source snapshot کے ساتھ رکھیں۔ یہ proposed translation کو حقیقتاً پڑھے گئے content سے جوڑتے ہیں، spreadsheet سے copy کیے گئے product title سے نہیں۔

نیچے query official schema سے adapted read-only example ہے۔ Development environment میں authorized product GID دیں۔ Returned keys inspect کریں اور explicit field allowlist استعمال کریں؛ browser language سے source locale infer کرنے کے بجائے returned source locale رکھیں۔

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

Shopify سے باہر translation candidate بنائیں

Internal candidate record میں resource ID، field key، source digest، target locale، glossary revision اور draft value رکھیں۔ Model کو صرف text اور ضروری product context دیں۔ SKU، price، currency، inventory اور variant identity generated patch سے باہر رکھیں۔

Bilingual reviewer کو candidate دکھانے سے پہلے required text، placeholders اور approved terminology validate کریں۔ Product reviewer سے claims اور warnings original source کے خلاف check کرائیں۔ Browser extension storefront translate کرتی ہو تو بھی یہ record نہیں بنتا اور Shopify نے translation store کی، یہ ثابت نہیں ہوتا؛ یہ صرف inspection aid ہے۔

صرف approved اور current translations register کریں

translationsRegister mutation translatable fields اور translatableContentDigest قبول کرتی ہے۔ اس کا documented result userErrors بھی شامل کرتا ہے۔ Connector کو اس result کو inspect کرنا چاہیے؛ صرف HTTP response successful registration کا proof نہیں۔

Authorized write سے پہلے current source کو reviewed snapshot سے compare کریں۔ بدل گیا ہو تو candidate hold کریں اور نئی review لیں۔ Intended field changes اور recovery کے لیے previous translations کی explicit list رکھیں۔ Development store میں ایک field سے شروع کریں، read back کریں، پھر patch بڑھائیں۔

Storefront الگ verify کریں

Shopify کے documented workflow میں stored translation اور storefront availability الگ checkpoints ہیں۔ Merchant کے ساتھ locale configuration اور theme checks plan کریں۔ Translated value save ہونا language publish یا market settings بدلنے کی اجازت خودکار طور پر نہیں دیتا۔

Development store میں target product، locale selector، fallback content، links اور variant labels inspect کریں۔ Stored translation read back کر کے approved value سے compare کریں۔ Field absent ہو تو نئی translation generate کرنے کے بجائے resource support یا theme rendering investigate کریں۔ Observations محفوظ کریں اور development store کو live merchant success کے طور پر پیش نہ کریں۔

Evidence اور connector limits

Official references Shopify translation interfaces قائم کرتی ہیں۔ APIsRouter-connected application یہاں test نہیں ہوئی، اور reviewed sources Shopify یا Translate & Adapt میں arbitrary gateway baseURL setting establish نہیں کرتے۔ Custom-application path کو development-store result آنے تک connector research سمجھیں۔

Complete test کے لیے application version، scoped authentication record، source query، candidate، approval، registration result اور read-back comparison محفوظ کریں۔ Source-change conflict اور rejected request بھی شامل کریں۔ Model identity اور usage کو store operations سے الگ record کریں تاکہ compatibility claim کا scope واضح رہے۔

عمومی سوالات