Metafield Tanımı

Metafield’ler, Shopify’daki ürünler, siparişler, müşteriler ve diğer kaynaklar için özel veriler saklamanıza olanak tanır. Boyut kılavuzları, spesifikasyonlar, SEO verileri veya dahili notlar gibi ekstra bilgiler eklemek için kullanışlıdırlar.

Shopify’da metafield’ler hakkında daha fazla bilgi edinin →

DataEase ile, dosyalarınızdaki dinamik sütunlar kullanarak metafield’leri içe aktarabilir, dışa aktarabilir ve güncelleyebilirsiniz.

📊 DataEase’te Metafield’lerin Çalışma Şekli

DataEase’ten veri dışa aktardığınızda, metafield’ler dinamik sütunlar olarak gösterilir. Bu, her bir metafield’in dosyada kendi sütununu aldığı ve belirli bir adlandırma formatı kullandığı anlamına gelir:

metafield {namespace}.{name} [{type}]

Örnek:

metafield global.description_tag [single_line_text_field]

Bu yapı, hangi metafield’den bahsettiğinizi ve hangi formatta olduğunu DataEase’e (ve Shopify’a) bildirir.

🧠 Metafield İçe Aktarma Mantığı

Bir metafield içe aktarma dosyanızda yoksa, değiştirilmeyecektir.
Bir metafield dosyada varsa ama boşsa, Shopify’dan silinecektir.
Bir metafield değere sahipse, oluşturulacak veya güncellenecektir.

Bu, değiştirmek istemediğiniz verileri üzerine yazmadan metafield’leri yönetmeyi kolaylaştırır.

🧩 Desteklenen Metafield Türleri

Shopify, geniş bir metafield türü yelpazesini destekler. Tam listeyi burada görebilirsiniz:

Bu türleri içe aktarırken sütun başlıklarınızda kullanın. Örneğin:

metafield specs.material [multi_line_text_field] metafield shipping.weight [number_decimal]

📏 Metafield Limitleri

Metafield’lerle çalışmadan önce, Shopify limitlerinin farkında olun:

🔢 Kaynak başına limitler

250 tanım her kaynak türü için
20 sabitlenmiş tanım her kaynak türü için

📦 Türüne göre karakter limitleri

Tür	Karakter Limiti
boolean	65,000
color	65,000
date	65,000
date_time	65,000
dimension	65,000
id	2,048
json	2,000,000
link	65,000
money	65,000
multi_line_text_field	65,000
number_decimal	65,000
number_integer	65,000
rating	65,000
rich_text_field	65,000
single_line_text_field	65,000
url	2,048
volume	65,000
weight	65,000

Tam metafield limitlerini görün →

🔐 Sahip türleri ve erişim (Admin API 2026-07)

Envanter transferleri (TRANSFER) — envanter transferlerinin metafield tanımları dışa aktarılabilir, içe aktarılabilir ve mağazalar arasında kopyalanabilir. Bunları içe aktarmak envanter transferleri izni gerektirir (read_inventory_transfers, write_inventory_transfers); uygulama bu izni 27 Eylül 2026’dan itibaren istemektedir. Mağaza sahibi DataEase’i açıp güncellenmiş izinleri onaylayana kadar TRANSFER satırları, onaylamanızı isteyen bir hatayla başarısız olur; diğer tüm satırlar her zamanki gibi içe aktarılır.
Kendi ad alanlarınızda (accessAdmin) yönetici erişimi (örneğin custom) — Shopify orada yalnızca tek bir değere izin verdiğinden, DataEase bu tür tanımlar için accessAdmin göndermez ve Shopify bunu kendisi uygular. Dosyadaki bir PUBLIC_READ / PUBLIC_READ_WRITE değeri artık Shopify hatasına neden olmaz.
Uygulama ad alanlarında yönetici erişimi ($app, app--…) — MERCHANT_READ ve MERCHANT_READ_WRITE olduğu gibi gönderilir; eski dosyalardan gelen PUBLIC_READ / PUBLIC_READ_WRITE değerleri MERCHANT_READ / MERCHANT_READ_WRITE olarak gönderilir.

🧰 Kullanım Örneği

Ürünlere özel SEO etiketleri ekleyin:

DataEase ile ürünleri dışa aktarın
Yeni bir sütun ekleyin: metafield global.title_tag [single_line_text_field]
SEO başlıklarınızı sütuna girin
Güncellenmiş dosyayı içe aktarın - metafield’leriniz artık aktif!

✅ En İyi Uygulamalar

Her metafield için köşeli parantezlerde doğru formatı kullanın.
Önemli verileri üzerine yazmaktan kaçının - değiştirmek istemediğiniz alanlar için sütunları kaldırın.
Değişiklik yapmadan önce mevcut metafield’lerinizi yedeklemek için dışa aktarma yapın.

Metafield’ler, Shopify mağazanızın işlevselliğini genişletmenin güçlü bir yoludur. DataEase ile, onları verimli bir şekilde - toplu halde - ve kod yazmaya gerek kalmadan yönetebilirsiniz.

Ek alanlar

Bu varlık için DataEase’in desteklediği daha fazla sütun:

accessAdmin — Metafield tanımı için yönetici erişim seviyesi. Yalnızca uygulama ad alanlarına uygulanır (yukarıdaki Sahip türleri ve erişim bölümüne bakın).
accessCustomer — Metafield tanımı için müşteri erişim seviyesi.
accessStoreFront — Metafield tanımı için vitrin erişim seviyesi.
capabilitiesAdminFilterableEnabled — Metafield için yönetici filtrelemesinin etkin olup olmadığını belirtir.
capabilitiesAdminFilterableEligible — Yönetici filtreleme yeteneği için uygunluk durumu.
capabilitiesAdminFilterableStatus — Yönetici filtreleme yeteneğinin mevcut durumu.
capabilitiesSmartCollectionConditionEnabled — Metafield için akıllı koleksiyon koşulunun etkin olup olmadığını belirtir.
capabilitiesSmartCollectionConditionEligible — Akıllı koleksiyon koşulu yeteneği için uygunluk durumu.
capabilitiesUniqueValuesEnabled — Metafield için benzersiz değerlerin etkin olup olmadığını belirtir.
capabilitiesUniqueValuesEligible — Benzersiz değerler yeteneği için uygunluk durumu.
constraintsKey — Metafield anahtarına uygulanan kısıtlamalar.
constraintsValues — Metafield değerlerine uygulanan kısıtlamalar.
metafieldsCount — Tanımla ilişkili metafield sayısı.
pinnedPosition — Metafield’in yönetici panelinde sabitlenip sabitlenmediğini belirtir.
metafieldsValidationStatus — Metafield’lerin doğrulama durumu.
category — Metafield tanımının kategorisi.
description — Metafield tanımının açıklaması.
key — Metafield tanımının anahtarı.
name — Metafield tanımının adı.
namespace — Metafield tanımının ad alanı.
ownerType — Metafield tanımıyla ilişkili sahip türü (örneğin PRODUCT, CUSTOMER, TRANSFER).
type — Metafield tanımının veri türü.
validations — Metafield tanımı için doğrulamalar içeren JSON dizisi.
deleteAssociatedMetafields — İlişkili metafield’lerin silinip silinmeyeceğini belirtir.