Dostęp do szczegółowych danych w panelu administracyjnym Shopify za pomocą formatu JSON

JSON, skrót od JavaScript Object Notation, to format do przechowywania i transportu danych, często używany, gdy dane są wysyłane z serwerów na strony WWW. Na większości stron zasobów w panelu administracyjnym Shopify, takich jak strony Zamówienia, Produkty lub Klienci, możesz uzyskać dostęp do bardziej szczegółowych danych za pomocą formatu JSON.

Mimo że wykonywanie zaawansowanych zadań programistycznych z użyciem formatu JSON nie jest wymagane, możliwość dostępu do pliku JSON dla określonego zasobu w panelu administracyjnym Shopify może pomóc w samodzielnym zebraniu bardziej szczegółowych informacji, rozwiązywaniu lub badaniu problemów. Na przykład możesz przejrzeć plik JSON produktu, aby znaleźć jego ID wariantu, które może być wymagane w przypadku niektórych zadań migracji danych lub dostosowań kodu szablonu. Innym przykładem jest możliwość odwołania się do pliku JSON zamówienia w celu potwierdzenia zmiennej danych, której chcesz użyć podczas tworzenia zautomatyzowanego workflow w aplikacji Shopify Flow.

Format JSON jest najczęściej używany przez programistów, ale nawet użytkownicy z ograniczoną wiedzą na temat kodowania mogą skorzystać z nauki wyszukiwania i interpretowania niektórych popularnych informacji w formacie JSON w panelu administracyjnym Shopify.

Na tej stronie

Formatowanie pliku JSON

Nieprzetworzone dane JSON wyświetlają się jako długa sekwencja zagnieżdżonych zmiennych i nawiasów, co jest trudne do odczytania dla człowieka.

Aby formatowanie JSON było bardziej czytelne, rozważ jedną z następujących opcji:

Zainstaluj w przeglądarce rozszerzenie do przeglądania plików JSON.
Użyj funkcji formatowania „pretty-print”, która jest domyślnie dostępna w większości nowoczesnych przeglądarek internetowych:

Zrzut ekranu pliku JSON produktu z wyświetlonymi przykładowymi informacjami o produkcie. Opcja pola wyboru „pretty-print” jest aktywna i podświetlona w lewym górnym rogu strony.

Dostęp do plików JSON w panelu administracyjnym Shopify

Panel administracyjny Shopify jest centralnym miejscem do zarządzania wszystkimi aspektami Twojej firmy i domyślnie wyświetla tylko najbardziej przydatne i istotne informacje. Dodatkowe informacje, które są gromadzone za każdym razem, gdy w panelu administracyjnym wykonywane są czynności, są przechowywane w plikach .json różnych stron zasobów. Te dodatkowe szczegóły nie są domyślnie wyświetlane, ponieważ taka ilość informacji byłaby przytłaczająca i nieprzydatna, a także utrudniałaby korzystanie z panelu administracyjnego.

W przypadku większości zadań biznesowych możesz używać istniejących narzędzi Shopify, aby uzyskiwać dostęp do informacji o swoim sklepie i je interpretować. Czasami jednak pomocne może być przejrzenie konkretnych informacji na temat poszczególnych zasobów, takich jak produkty lub zamówienia, podczas rozwiązywania problemów związanych z tym, dlaczego lub kiedy coś się wydarzyło.

Przykład: Dostęp do pliku JSON zamówienia

W tym przykładzie uzyskasz dostęp do pliku JSON zamówienia w panelu administracyjnym Shopify.

Kroki:

W panelu administracyjnym Shopify przejdź do opcji Zamówienia.
Kliknij dowolne zamówienie na liście Zamówienia.
W pasku adresu przeglądarki dodaj .json na końcu adresu URL. Będzie on wyglądał podobnie do tego przykładu:

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

Naciśnij klawisz Enter, aby ponownie załadować stronę w formacie JSON.
Opcjonalnie: Jeśli nie masz zainstalowanego w przeglądarce rozszerzenia do przeglądania plików JSON, aktywuj w przeglądarce ustawienie Pretty-print, aby plik JSON był bardziej przyjazny dla użytkownika. Dowiedz się więcej na temat ponownego formatowania pliku JSON.

Zauważysz, że wyświetla się wiele oczekiwanych informacji na temat zamówienia, takich jak „currency” (waluta) i „line_items” (pozycje) powiązane z zamówieniem, ale także wiele innych szczegółowych informacji, takich jak „client_details” (dane klienta) z sesji przeglądarki klienta, kiedy złożył zamówienie. Tego rodzaju informacje są przydatne do ogólnego śledzenia sesji i analiz platformy marketingowej, ale nie są konieczne do przetwarzania i realizacji zamówienia.

Wyświetlanie określonych pól w pliku JSON

Możesz wymusić, aby pliki JSON wyświetlały tylko określone pola, co może ułatwić interpretację informacji, gdy znasz poszczególne właściwości, które chcesz uwzględnić. Na końcu dowolnego adresu URL pliku JSON w pasku adresu przeglądarki dodaj ?fields=, a następnie wpisz nazwy właściwości, które chcesz wyświetlić, w dowolnej kolejności, oddzielone przecinkiem.

Na przykład, aby wyświetlić ID zamówienia, informacje o kliencie, cenę całkowitą i tagi, dodaj ?fields=id,customer,total_price,tags na końcu adresu URL pliku JSON, jak w poniższym przykładzie:

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

Korzystanie z innych zasobów JSON

Możesz użyć następujących zasobów JSON, aby wyświetlić określone informacje w panelu administracyjnym Shopify:

Liczba produktów: Dodaj /count.json na końcu adresu URL listy Produktów, aby wyświetlić całkowitą liczbę produktów. Pełny adres URL powinien mieć następującą postać:

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

Transakcje: Dodaj /transactions.json na końcu adresu URL strony zamówienia, aby wyświetlić tylko informacje o transakcjach w ramach zamówienia. Dowiedz się więcej o zasobie Transakcje.
Realizacje: Dodaj /fulfillments.json na końcu adresu URL strony zamówienia, aby wyświetlić tylko informacje o realizacji zamówienia. Dowiedz się więcej o zasobie Realizacja.
Przerwane realizacje zakupu: Dodaj .json na końcu adresu URL przerwanej realizacji zakupu, aby wyświetlić szczegółowe informacje na temat przerwanej realizacji zakupu. Dowiedz się więcej o zasobie Przerwana realizacja zakupu.

Popularne właściwości JSON do rozwiązywania problemów

Poniższa tabela zawiera listę właściwości JSON, do których możesz się odwołać w celu rozwiązania problemów z różnymi typami zasobów. Jeśli na przykład chcesz potwierdzić, kiedy dany produkt został opublikowany, możesz sprawdzić plik JSON produktu pod kątem właściwości published_at, która wyświetla datę i godzinę w formacie ISO 8601.

Ta tabela nie zawiera wszystkich możliwych zasobów lub właściwości JSON przechowywanych w panelu administracyjnym Shopify, dlatego definicje wszelkich nieujętych tu zasobów lub właściwości można znaleźć w dokumentacji dla programistów Shopify.

Zawiera listę przykładowych zasobów panelu administracyjnego i powiązanych z nimi popularnych właściwości, w tym definicje ich możliwego zastosowania podczas rozwiązywania problemów.
Zasób	Właściwość JSON	Definicja
Produkt	`"product": { "created_at"`	Data i godzina pierwotnego utworzenia produktu.
	`"product": { "published_at"`	Data i godzina ustawienia statusu produktu na Aktywny.
	`"product": { "updated_at"`	Najnowsza data i godzina aktualizacji produktu. Może to obejmować zmiany w opisie produktu, tytule lub informacjach SEO, a także automatyczne aktualizacje, takie jak zmiany w zapasach po zakupie produktu.
Wariant	`"product": { "variants": [ { "created_at"`	Data i godzina pierwotnego utworzenia wariantu. Mogą się one różnić od daty i godziny utworzenia całego produktu.
	`"product": { "variants": [ { "updated_at"`	Najnowsza data i godzina aktualizacji wariantu. Mogą się one różnić od daty i godziny ostatniej aktualizacji całego produktu.
	`"product": { "variants": [ { "inventory_quantity"`	Bieżąca wartość w bazie danych, dostępna dla klientów do zakupu. Może to być wartość ujemna, jeśli zapasy wariantu nie są śledzone lub jeśli ustawiono sprzedaż ponad zapas.
	`"product": { "variants": [ { "old_inventory_quantity"`	Wartość w bazie danych sprzed daty ostatniej aktualizacji wariantu (`updated_at`).
Zamówienie	`"order": { "line_items": [ { "requires_shipping"`	Wyświetla wartość `true` lub `false`. Wskazuje to ustawienia wysyłki produktu lub wariantu w momencie składania zamówienia.
	`"order": { "line_items": [ { "taxable"`	Wyświetla wartość `true` lub `false`. Wskazuje to, w jaki sposób skonfigurowano naliczanie podatków dla produktu lub wariantu w momencie składania zamówienia.
	`"order": { "line_items": [ { "variant_inventory_management"`	Wyświetla wartość `shopify`, `amazon_marketplace_web`, `null` lub wartość zewnętrzną, w zależności od tego, która usługa realizacji jest ustawiona do śledzenia zapasów produktu. Wartość `null` oznacza, że produkt nie był śledzony w momencie składania zamówienia.
	`"order": { "line_items": [ { "fulfillable_quantity"`	Wyświetla, ile zapasów jest nadal zarezerwowanych przez system w celu realizacji zamówienia. Wartość ta nie jest równa bieżącym zapasom wariantu.
	`"order": { "line_items": [ { "quantity"`	Liczba zakupionych produktów lub wariantów.
	`"order": { "line_items": [ { "tax_lines"`	W Stanach Zjednoczonych wyświetla wartości stanowe, hrabstwa i miejskie. Jeśli nie są wyświetlane żadne wiersze podatku, ale podatek został naliczony w zamówieniu, oznacza to, że został on naliczony od kosztu wysyłki.
Klient	`"customer": { "created_at"`	Data i godzina pierwotnego utworzenia klienta.
Klient	`"customer": { "updated_at"`	Najnowsza data i godzina aktualizacji profilu klienta.

Metapola w formacie JSON

Metapola to elastyczny sposób na dołączanie dodatkowych, niestandardowych informacji do zasobu Shopify, takiego jak produkty czy kolekcje. Przykłady danych przechowywanych za pomocą metapól obejmują specyfikacje produktów, tabele rozmiarów, dokumenty do pobrania, daty wydania, obrazy lub numery części. Dowiedz się więcej o używaniu metapól.

Możesz dodać /metafields.json na końcu adresu URL strony obsługiwanego zasobu, aby wyświetlić metapola powiązane z tym zasobem. W poniższej tabeli znajdziesz przykłady zasobów i formatów adresów URL, których można użyć do wyświetlania informacji z metapól w formacie JSON.

Lista przykładowych zasobów panelu administracyjnego wraz z przykładowym adresem URL pliku metapól JSON.
Przykładowy typ zasobu	Przykładowy adres URL
Inteligentna kolekcja	`https://admin.shopify.com/store/{your-store-name}/collections/{collection-id}/metafields.json`
Klient	`https://admin.shopify.com/store/{your-store-name}/customers/{customer-id}/metafields.json`
Zamówienie	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/metafields.json`
Strona	`https://admin.shopify.com/store/{your-store-name}/pages/{page-id}/metafields.json`
Produkt	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/metafields.json`
Wariant	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/variants/{variant-id}/metafields.json`
Obraz produktu	`https://admin.shopify.com/store/{your-store-name}/metafields.json?metafield[owner_id]={id}&metafield[owner_resource]=product_image` Uwaga: Metapola obrazów produktów można dodawać tylko za pośrednictwem API. Zastąp symbol zastępczy `{id}` i inne symbole zastępcze w adresie URL rzeczywistymi wartościami z zapytań API.
Sklep	`https://admin.shopify.com/store/{your-store-name}/metafields.json`

Pełną listę zasobów, które mogą mieć metapola, oraz określone typy właściwości, które są przechowywane dla każdego typu zasobu, można znaleźć w zasobie Metapole JSON w dokumentacji dla programistów Shopify.

Zdarzenia w formacie JSON

Zdarzenia są generowane przez niektóre zasoby Shopify po wykonaniu określonych czynności, takich jak utworzenie posta na blogu, realizacja zamówienia lub dodanie produktu.

Możesz dodać /events.json na końcu adresu URL strony obsługiwanego zasobu, aby wyświetlić zdarzenia powiązane z tym zasobem. W poniższej tabeli znajdziesz przykłady zasobów i formatów adresów URL, których można użyć do wyświetlania informacji o zdarzeniach w formacie JSON.

Lista przykładowych zasobów panelu administracyjnego wraz z przykładowym adresem URL pliku zdarzeń JSON.
Przykładowy typ zasobu	Przykładowy adres URL
Zamówienie	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.json` Ten plik zawiera listę autorów (`author`) zdarzeń, informując o tym, którzy użytkownicy wykonali określone czynności, np. kto lub co opublikowało produkt.
Produkt	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.json` Ten plik zawiera listę autorów (`author`) zdarzeń, informując o tym, którzy użytkownicy wykonali określone czynności, np. kto lub co oznaczyło płatność jako opłaconą.
Sklep	`https://admin.shopify.com/store/{your-store-name}/events.json?limit=250` Ten format adresu URL wyświetla 250 najnowszych zdarzeń, które miały miejsce w Twoim sklepie. Zdarzenia mogą obejmować m.in. tworzenie lub aktualizacje produktów, usuwanie stron i aktualizacje wariantów.

Pełną listę zasobów, które mogą tworzyć zdarzenia, oraz określone zdarzenia, które są tworzone dla każdego typu zasobu, można znaleźć w zasobie Zdarzenie JSON w dokumentacji dla programistów Shopify.