JSON kullanarak Shopify yöneticinizdeki ayrıntılı verilere erişme

JavaScript Object Notation'ın kısaltması olan JSON, genellikle sunuculardan web sayfalarına veri gönderildiğinde kullanılan, verileri depolamaya ve taşımaya yönelik bir biçimdir. Shopify yöneticisindeki Siparişler, Ürünler veya Müşteriler sayfaları gibi çoğu kaynak sayfasında, JSON'ı kullanarak daha ayrıntılı verilere erişebilirsiniz.

JSON kullanarak gelişmiş geliştirme görevleri gerçekleştirmeniz gerekmese de Shopify yöneticinizde belirli bir kaynağın JSON dosyasına erişebilmek, daha ayrıntılı bilgi toplamanıza veya sorunları kendi başınıza gidermenize ya da araştırmanıza yardımcı olabilir. Örneğin, belirli veri geçişi görevleri veya tema kodu kişiselleştirmeleri için gerekli olabilecek varyasyon kimliğini bulmak üzere bir ürünün JSON dosyasını inceleyebilirsiniz. Başka bir örnek olarak, Shopify Flow uygulamasında otomatikleştirilmiş bir iş akışı oluştururken kullanmak istediğiniz veri değişkenini doğrulamak için bir siparişin JSON dosyasına başvurabilirsiniz.

JSON çoğunlukla geliştiriciler tarafından kullanılır ancak sınırlı kodlama bilgisine sahip kullanıcılar bile Shopify yöneticilerinde bazı yaygın JSON bilgilerini nasıl bulup yorumlayacaklarını öğrenmekten yararlanabilir.

Bu sayfada

Bir JSON dosyasını yeniden biçimlendirme

Ham JSON verileri, iç içe geçmiş değişkenler ve ayraçlardan oluşan uzun bir dizi olarak görüntülenir. Bu da bir insanın okumasını zorlaştırır.

JSON biçimlendirmesini daha okunaklı hâle getirmek için aşağıdaki seçeneklerden birini değerlendirebilirsiniz:

Tarayıcınıza bir JSON görüntüleyici eklentisi kurun.
Çoğu modern web tarayıcısının varsayılan olarak sunduğu pretty-print özelliğini kullanın:

Örnek ürün bilgilerinin görüntülendiği bir JSON ürün dosyasının ekran görüntüsü. Sayfanın sol üst kısmında vurgulanmış olan "pretty-print" onay kutusu ayarı etkin.

Shopify yöneticinizdeki JSON dosyalarına erişme

Shopify yöneticisi, işletmenizin tüm yönlerini yönetmeye yönelik merkezi bir alandır ve varsayılan olarak yalnızca en faydalı ve alakalı bilgileri görüntüleyecek şekilde tasarlanmıştır. Yöneticinizde işlemler gerçekleştirildiğinde toplanan ek bilgiler, farklı kaynak sayfalarının .json dosyalarında saklanır. Bu ek ayrıntılar varsayılan olarak size gösterilmez çünkü bu miktarda bilgi bunaltıcı ve faydasız olur, yöneticinizi kullanmayı zorlaştırırdı.

Çoğu ticari görev için mağazanızın bilgilerine erişmek ve bunları yorumlamak üzere Shopify'ın mevcut araçlarını kullanabilirsiniz. Ancak bir şeyin neden veya ne zaman olduğuna dair hata giderirken ürünler veya siparişler gibi belirli kaynaklarla ilgili özel bilgileri incelemek zaman zaman faydalı olabilir.

Örnek: Bir siparişin JSON dosyasına erişme

Bu örnekte, Shopify yöneticinizdeki bir siparişin JSON dosyasına erişeceksiniz.

Adımlar:

Shopify yöneticinizden Siparişler bölümüne gidin.
Siparişler listesindeki herhangi bir siparişe tıklayın.
Tarayıcının adres çubuğunda, URL adresinin sonuna .json ekleyin. Aşağıdaki örneğe benzer olacaktır:

https://admin.shopify.com/store/{example-shop-name}/orders/12345678901234.json

Sayfayı JSON biçiminde yeniden yüklemek için Enter tuşuna basın.
İsteğe bağlı: Tarayıcınızda bir JSON görüntüleyici uzantısı yüklü değilse JSON dosyasını daha kullanıcı dostu hale getirmek için tarayıcınızdaki Pretty-print ayarını etkinleştirin. JSON dosyasını yeniden biçimlendirme hakkında daha fazla bilgi edinin.

Siparişle ilişkili "currency" (para birimi) ve "line_items" (satır öğeleri) gibi siparişle ilgili beklenen birçok bilginin görüntülendiğini ancak müşterinin sipariş verirken kullandığı tarayıcı oturumundaki "client_details" (istemci ayrıntıları) gibi başka birçok ayrıntılı bilginin de dahil edildiğini fark edeceksiniz. Bu tür bilgiler genel oturum takibi ve pazarlama platformu analizleri için kullanışlıdır ancak siparişi işleme almanız ve göndermeniz için gerekli değildir.

Bir JSON dosyasındaki belirli alanları görüntüleme

JSON dosyalarını yalnızca belirli alanları görüntülemeye zorlayabilirsiniz. Bu, eklemek istediğiniz belirli özellikleri bildiğinizde bilgileri yorumlamayı kolaylaştırabilir. Tarayıcının adres çubuğundaki herhangi bir JSON dosyası URL'sinin sonuna ?fields= ekleyin ve ardından görüntülemek istediğiniz özellik adlarını, aralarına virgül koyarak istediğiniz sırada ekleyin.

Örneğin, bir siparişin kimliğini, müşteri bilgilerini, toplam fiyatını ve etiketlerini görüntülemek için aşağıdaki örnekte olduğu gibi JSON dosyası URL'sinin sonuna ?fields=id,customer,total_price,tags ekleyin:

https://admin.shopify.com/store/{example-shop-name}/orders/12345678901234.json?fields=id,customer,total_price,tags

Diğer JSON kaynaklarını kullanma

Shopify yöneticinizde belirli bilgileri görüntülemek için aşağıdaki JSON kaynaklarını kullanabilirsiniz:

Ürün sayısı: Toplam ürün sayısını görüntülemek için Ürünler listesi URL'sinin sonuna /count.json ekleyin. URL'nin tam hali şu şekilde olmalıdır:

https://admin.shopify.com/store/{example-shop-name}/products/count.json

İşlemler: Yalnızca sipariş işlemi bilgilerini görüntülemek için bir sipariş sayfası URL'sinin sonuna /transactions.json ekleyin. İşlemler kaynağı hakkında daha fazla bilgi edinin.
Gönderimler: Yalnızca sipariş gönderim bilgilerini görüntülemek için bir sipariş sayfası URL'sinin sonuna /fulfillments.json ekleyin. Gönderim kaynağı hakkında daha fazla bilgi edinin.
Yarım bırakılmış ödemeler: Yarım bırakılmış ödeme hakkında ayrıntılı bilgileri görüntülemek için yarım bırakılmış ödeme URL'sinin sonuna .json ekleyin. Yarım bırakılmış ödeme kaynağı hakkında daha fazla bilgi edinin.

Hata giderme için yaygın JSON özellikleri

Aşağıdaki tabloda, farklı kaynak türleriyle ilgili hata giderme yardımı için başvurabileceğiniz JSON özellikleri listelenmektedir. Örneğin, belirli bir ürünün ne zaman yayınlandığını doğrulamak isterseniz ürünün JSON dosyasında tarihi ve saati ISO 8601 biçiminde gösteren published_at özelliğini inceleyebilirsiniz.

Bu tablo, Shopify yöneticisinde depolanan olası tüm JSON kaynaklarını veya özelliklerini içermez. Bu nedenle, burada yer almayan kaynak veya özellik tanımları için Shopify Geliştirici Belgeleri'ne bakın.

Bazı örnek yönetici kaynaklarını ve bunlarla ilişkili yaygın özellikleri, hata giderme sırasında ne için kullanılabileceklerine ilişkin tanımlar da dahil olmak üzere listeler.
Kaynak	JSON özelliği	Tanım
Ürün	`"product": { "created_at"`	Ürünün ilk oluşturulduğu saat ve tarih.
	`"product": { "published_at"`	Ürünün durumunun Etkin olarak ayarlandığı saat ve tarih.
	`"product": { "updated_at"`	Ürünün en son güncellendiği saat ve tarih. Bu, ürün tanımı, başlık veya SEO bilgilerindeki değişikliklerin yanı sıra bir ürün satın alındığında envanterde yapılan değişiklikler gibi otomatik güncellemeleri de içerebilir.
Varyasyon	`"product": { "variants": [ { "created_at"`	Varyasyonun ilk oluşturulduğu saat ve tarih. Bu tarih ve saat, ürünün genel olarak oluşturulduğu tarih ve saatten farklı olabilir.
	`"product": { "variants": [ { "updated_at"`	Varyasyonun en son güncellendiği saat ve tarih. Bu tarih ve saat, ürünün genel olarak en son güncellendiği tarih ve saatten farklı olabilir.
	`"product": { "variants": [ { "inventory_quantity"`	Mevcut veritabanı değeri ve müşterilerin satın alımı için erişebileceği değer. Varyasyon envanteri takip edilmiyorsa veya fazla satış yapmaya ayarlanmışsa bu negatif bir değer olabilir.
	`"product": { "variants": [ { "old_inventory_quantity"`	Varyasyonun son `updated_at` tarihinden önceki veritabanı değeri.
Sipariş	`"order": { "line_items": [ { "requires_shipping"`	`true` veya `false` olarak gösterilir. Bu, sipariş verildiği sırada ürünün veya varyasyonun kargo ayarlarını belirtir.
	`"order": { "line_items": [ { "taxable"`	`true` veya `false` olarak gösterilir. Bu, sipariş verildiği sırada ürün veya varyasyondan nasıl vergi alınacağının ayarlandığını belirtir.
	`"order": { "line_items": [ { "variant_inventory_management"`	Ürünün envanterini takip etmek için hangi gönderim hizmetinin ayarlandığına bağlı olarak `shopify`, `amazon_marketplace_web`, `null` veya bir üçüncü taraf değeri olarak gösterilir. `null` değeri, sipariş sırasında ürünün takip edilmediği anlamına gelir.
	`"order": { "line_items": [ { "fulfillable_quantity"`	Siparişi tamamlamak için sistem tarafından ne kadar envanterin hâlâ ayrılmış olduğunu gösterir. Bu, mevcut varyasyon envanterine eşit değildir.
	`"order": { "line_items": [ { "quantity"`	Satın alınan ürün veya varyasyonların sayısı.
	`"order": { "line_items": [ { "tax_lines"`	ABD'de bu, eyalet, ilçe ve belediye değerlerini gösterir. Hiçbir vergi satırı gösterilmemesine rağmen siparişten vergi alındıysa bu, verginin kargo masrafından alındığı anlamına gelir.
Müşteri	`"customer": { "created_at"`	Müşterinin ilk oluşturulduğu saat ve tarih.
Müşteri	`"customer": { "updated_at"`	Müşteri profilinin en son güncellendiği saat ve tarih.

JSON'daki meta alanlar

Meta alanlar; ürünler veya koleksiyonlar gibi bir Shopify kaynağına ek özel bilgiler eklemenin esnek bir yoludur. Meta alanlar kullanılarak depolanan verilere örnek olarak ürün özellikleri, beden tabloları, indirilebilir belgeler, yayın tarihleri, görseller veya parça numaraları verilebilir. Meta alanları kullanma hakkında daha fazla bilgi edinin.

Bir kaynakla ilişkilendirilmiş meta alanları görüntülemek için desteklenen bir kaynak sayfası URL'sinin sonuna /metafields.json ekleyebilirsiniz. JSON kullanarak meta alan bilgilerini görüntülemek için kullanabileceğiniz kaynak ve URL biçimlerine ilişkin bazı örnekler için aşağıdaki tabloya başvurun.

Örnek bir JSON meta alanlar dosyası URL'si ile birlikte bazı örnek yönetici paneli kaynaklarını listeler.
Örnek kaynak türü	Örnek URL
Akıllı koleksiyon	`https://admin.shopify.com/store/{your-store-name}/collections/{collection-id}/metafields.json`
Müşteri	`https://admin.shopify.com/store/{your-store-name}/customers/{customer-id}/metafields.json`
Sipariş	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/metafields.json`
Sayfa	`https://admin.shopify.com/store/{your-store-name}/pages/{page-id}/metafields.json`
Ürün	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/metafields.json`
Varyasyon	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/variants/{variant-id}/metafields.json`
Ürün görseli	`https://admin.shopify.com/store/{your-store-name}/metafields.json?metafield[owner_id]={id}&metafield[owner_resource]=product_image` Not: Ürün görseli meta alanları yalnızca API aracılığıyla eklenebilir. URL'deki `{id}` ve diğer yer tutucuları, API sorgularınızdaki gerçek değerlerle değiştirin.
Mağaza	`https://admin.shopify.com/store/{your-store-name}/metafields.json`

Meta alanlara sahip olabilecek kaynakların tam listesi ve her kaynak türü için depolanan belirli özellik türleri için Shopify Geliştirici Belgeleri'ndeki Meta alan JSON kaynağı bölümüne bakın.

JSON'daki etkinlikler

Etkinlikler; bir blog gönderisinin oluşturulması, bir siparişin gönderimi veya bir ürünün eklenmesi gibi belirli işlemler tamamlandığında bazı Shopify kaynakları tarafından oluşturulur.

Bir kaynakla ilişkili etkinlikleri görüntülemek için desteklenen bir kaynak sayfası URL'sinin sonuna /events.json ekleyebilirsiniz. JSON kullanarak etkinlik bilgilerini görüntülemek için kullanabileceğiniz kaynak ve URL biçimlerine ilişkin bazı örnekler için aşağıdaki tabloya başvurun.

Örnek bir JSON etkinlikler dosyası URL'si ile birlikte bazı örnek yönetici paneli kaynaklarını listeler.
Örnek kaynak türü	Örnek URL
Sipariş	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.json` Bu dosya, etkinliklerin `author` (yazarını) listeler. Bu sayede, bir ürünü kimin veya neyin yayınladığı gibi belirli eylemleri hangi kullanıcıların tamamladığını öğrenebilirsiniz.
Ürün	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.json` Bu dosya, etkinliklerin `author` (yazarını) listeler. Bu sayede, bir ödemeyi kimin veya neyin ödendi olarak işaretlediği gibi belirli eylemleri hangi kullanıcıların tamamladığını öğrenebilirsiniz.
Mağaza	`https://admin.shopify.com/store/{your-store-name}/events.json?limit=250` Bu URL biçimi, mağazanızda gerçekleşen en son 250 etkinliği görüntüler. Etkinlikler, bunlarla sınırlı olmamakla birlikte ürün oluşturma veya güncellemeleri, sayfa silmeleri ve varyasyon güncellemelerini içerebilir.

Etkinlik oluşturabilen kaynakların tam listesi ve her kaynak türü için oluşturulan belirli etkinlikler için Shopify Geliştirici Belgeleri'ndeki Etkinlik JSON kaynağı bölümüne bakın.