დახმარება
შესვლა

Shopify-ს ადმინში დეტალურ მონაცემებზე წვდომა JSON-ის გამოყენებით

JSON, JavaScript Object Notation-ის შემოკლებული ფორმა, არის მონაცემების შენახვისა და გადაცემის ფორმატი, რომელიც ხშირად გამოიყენება სერვერებიდან ვებგვერდებზე მონაცემების გაგზავნისას. Shopify-ს ადმინის რესურსების გვერდების უმეტესობაში, როგორებიცაა შეკვეთები, პროდუქტები ან მომხმარებლები, შეგიძლია JSON-ის გამოყენებით უფრო დეტალურ მონაცემებზე წვდომა.

მიუხედავად იმისა, რომ JSON-ის გამოყენებით დეველოპმენტის რთული ამოცანების შესრულება არ მოგეთხოვება, შენს Shopify-ს ადმინში კონკრეტული რესურსის JSON ფაილზე წვდომის ქონა დაგეხმარება უფრო დეტალური ინფორმაციის შეგროვებაში, ან პრობლემების დამოუკიდებლად გამოკვლევასა და ხარვეზების აღმოფხვრაში. მაგალითად, შეგიძლია გადახედო პროდუქტის JSON ფაილს მისი ვარიანტის ID-ის საპოვნელად, რაც შეიძლება საჭირო იყოს მონაცემთა მიგრაციის კონკრეტული ამოცანებისთვის ან თემის კოდის მორგებისთვის. კიდევ ერთი მაგალითისთვის, შეგიძლია მიმართო შეკვეთის JSON ფაილს იმ მონაცემთა ცვლადის დასადასტურებლად, რომლის გამოყენებაც გსურს Shopify Flow-ში ავტომატიზებული სამუშაო პროცესის შექმნისას.

JSON-ს ყველაზე ხშირად დეველოპერები იყენებენ, მაგრამ კოდირების შეზღუდული ცოდნის მქონე მომხმარებლებსაც კი შეუძლიათ მიიღონ სარგებელი იმის სწავლით, თუ როგორ იპოვონ და გაანალიზონ ზოგიერთი გავრცელებული JSON ინფორმაცია თავიანთ Shopify-ს ადმინში.

ამ გვერდზე

JSON ფაილის რეფორმატირება

დაუმუშავებელი JSON მონაცემები ნაჩვენებია, როგორც ჩაშენებული ცვლადებისა და ფრჩხილების გრძელი მიმდევრობა, რაც ადამიანისთვის რთული წასაკითხია.

JSON ფორმატირების უფრო კითხვადი სახით წარმოსადგენად, განიხილე ქვემოთ მოცემული ნებისმიერი ვარიანტი:

  • დააინსტალირე JSON viewer-ის გაფართოება შენს ბრაუზერში.
  • გამოიყენე pretty-print შესაძლებლობა, რომელიც თანამედროვე ვებ-ბრაუზერების უმეტესობაში ნაგულისხმევად არის ხელმისაწვდომი:

Screenshot of a JSON product file with example product information displayed. The

JSON ფაილებზე წვდომა შენს Shopify-ს ადმინში

Shopify-ს ადმინი არის ცენტრალური ჰაბი შენი ბიზნესის ყველა ასპექტის სამართავად და შექმნილია იმისთვის, რომ ნაგულისხმევად აჩვენოს მხოლოდ ყველაზე სასარგებლო და შესაბამისი ინფორმაცია. დამატებითი ინფორმაცია, რომელიც გროვდება ადმინში ქმედებების შესრულებისას, ინახება სხვადასხვა რესურსის გვერდის .json ფაილებში. ეს დამატებითი დეტალები ნაგულისხმევად არ გიჩვენდება, რადგან ამ რაოდენობის ინფორმაცია გადამეტებული და გამოუსადეგარი იქნებოდა, რაც შენი ადმინის გამოყენებას გაართულებდა.

ბიზნეს ამოცანების უმეტესობისთვის შეგიძლია გამოიყენო Shopify-ს არსებული ხელსაწყოები შენი მაღაზიის ინფორმაციაზე წვდომისა და მისი გაანალიზებისთვის. თუმცა, ხანდახან შეიძლება სასარგებლო იყოს კონკრეტული რესურსების შესახებ სპეციფიკური ინფორმაციის გადახედვა, როგორიცაა პროდუქტები ან შეკვეთები, რათა აღმოფხვრა ხარვეზი და გაარკვიო რატომ ან როდის მოხდა რაიმე.

მაგალითი: წვდომა შეკვეთის JSON ფაილზე

ამ მაგალითში შენ შეძლებ წვდომას შეკვეთის JSON ფაილზე შენს Shopify-ს ადმინში.

ნაბიჯები:

  1. შენი Shopify-ს ადმინიდან გადადი შეკვეთებში.

  2. დააწკაპუნე ნებისმიერ შეკვეთას შეკვეთების სიაში.

  3. ბრაუზერის მისამართების ზოლში დაამატე .json URL მისამართის ბოლოს. ის ამ მაგალითის მსგავსი იქნება:

https://admin.shopify.com/store/{example-shop-name}/orders/12345678901234.json
  1. დააჭირე Enter-ს გვერდის JSON ფორმატში თავიდან ჩასატვირთად.
  2. არასავალდებულო: თუ შენს ბრაუზერში JSON viewer-ის გაფართოება არ არის დაინსტალირებული, მაშინ გააქტიურე Pretty-print პარამეტრი შენს ბრაუზერში, რათა JSON ფაილი უფრო მარტივად გამოსაყენებელი გახდეს. შეიტყვე მეტი JSON ფაილის რეფორმატირების შესახებ.

შენ შეამჩნევ, რომ ნაჩვენებია შეკვეთის შესახებ მოსალოდნელი ბევრი ინფორმაცია, როგორიცაა შეკვეთასთან დაკავშირებული "currency" და "line_items", მაგრამ ასევე შედის ბევრი სხვა დეტალური ინფორმაცია, როგორიცაა "client_details" მომხმარებლის ბრაუზერის სესიიდან, როდესაც მათ შეკვეთა განათავსეს. მსგავსი ინფორმაცია სასარგებლოა სესიის საერთო თვალყურის დევნებისა და მარკეტინგული პლატფორმის ანალიტიკისთვის, მაგრამ არ არის აუცილებელი შეკვეთის დასამუშავებლად და შესასრულებლად.

კონკრეტული ველების ჩვენება JSON ფაილში

შეგიძლია JSON ფაილებში მხოლოდ კონკრეტული ველების ჩვენება მოითხოვო, რაც ინფორმაციის გაანალიზებას გაგიადვილებს, როცა იცი ის კონკრეტული თვისებები, რომელთა ჩართვაც გსურს. ნებისმიერი JSON ფაილის URL-ის ბოლოს ბრაუზერის მისამართების ზოლში, დაამატე ?fields= და შემდეგ მიუთითე იმ თვისებების სახელები, რომელთა ჩვენებაც გსურს, ნებისმიერი თანმიმდევრობით, მძიმით გამოყოფილი.

მაგალითად, შეკვეთის ID-ის, მომხმარებლის ინფორმაციის, ჯამური ფასისა და თეგების საჩვენებლად, JSON ფაილის URL-ის ბოლოს დაამატე ?fields=id,customer,total_price,tags, როგორც ეს შემდეგ მაგალითშია მოცემული:

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

სხვა JSON რესურსების გამოყენება

შეგიძლია გამოიყენო შემდეგი JSON რესურსები კონკრეტული ინფორმაციის საჩვენებლად შენს Shopify-ს ადმინში:

  • პროდუქტების რაოდენობა: დაამატე /count.json პროდუქტების სიის URL-ის ბოლოს პროდუქტების ჯამური რაოდენობის საჩვენებლად. სრული URL ასეთი უნდა იყოს:
https://admin.shopify.com/store/{example-shop-name}/products/count.json
  • ტრანზაქციები: დაამატე /transactions.json შეკვეთის გვერდის URL-ის ბოლოს მხოლოდ შეკვეთის ტრანზაქციის ინფორმაციის საჩვენებლად. შეიტყვე მეტი ტრანზაქციების რესურსის შესახებ.
  • შეკვეთის შესრულებები: დაამატე /fulfillments.json შეკვეთის გვერდის URL-ის ბოლოს მხოლოდ შეკვეთის შესრულების ინფორმაციის საჩვენებლად. შეიტყვე მეტი შეკვეთის შესრულების რესურსის შესახებ.
  • მიტოვებული გადახდები: დაამატე .json მიტოვებული გადახდის URL-ის ბოლოს მიტოვებული გადახდის შესახებ დეტალური ინფორმაციის საჩვენებლად. შეიტყვე მეტი მიტოვებული გადახდის რესურსის შესახებ.

გავრცელებული JSON თვისებები ხარვეზების აღმოსაფხვრელად

ქვემოთ მოცემულ ცხრილში ჩამოთვლილია ის JSON თვისებები, რომლებსაც შეგიძლია მიმართო სხვადასხვა ტიპის რესურსებთან დაკავშირებული ხარვეზების აღმოსაფხვრელად. მაგალითად, თუ გსურს დაადასტურო, როდის გამოქვეყნდა კონკრეტული პროდუქტი, შეგიძლია გადახედო პროდუქტის JSON ფაილს published_at თვისებისთვის, რომელიც აჩვენებს თარიღსა და დროს ISO 8601 ფორმატში.

ეს ცხრილი არ შეიცავს Shopify-ს ადმინში შენახულ ყველა შესაძლო JSON რესურსს ან თვისებას, ამიტომ მიმართე Shopify-ს დეველოპერის დოკუმენტაციას ნებისმიერი იმ რესურსის ან თვისების განმარტებისთვის, რომელიც აქ არ არის მითითებული.

ჩამოთვლის ადმინ პანელის რესურსების ზოგიერთ მაგალითს და მათთან დაკავშირებულ საერთო თვისებებს, მათ შორის განმარტებებს, თუ რისთვის შეიძლება მათი გამოყენება ხარვეზების აღმოფხვრისას.
რესურსიJSON თვისებაგანმარტება
პროდუქტი
"product": {
  "created_at"
დრო და თარიღი, როდესაც პროდუქტი თავდაპირველად შეიქმნა.
"product": {
  "published_at"
დრო და თარიღი, როდესაც პროდუქტის სტატუსი განისაზღვრა, როგორც აქტიური.
"product": {
  "updated_at"
დრო და თარიღი, როდესაც პროდუქტი ბოლოს განახლდა. ეს შეიძლება მოიცავდეს ცვლილებებს პროდუქტის აღწერაში, სათაურში ან SEO-ს ინფორმაციაში, აგრეთვე ავტომატურ განახლებებს, როგორიცაა ცვლილებები მარაგში პროდუქტის შეძენისას.
ვარიანტი
"product": {
  "variants": [
    {
    "created_at"
დრო და თარიღი, როდესაც ვარიანტი თავდაპირველად შეიქმნა. ეს შეიძლება განსხვავდებოდეს ძირითადი პროდუქტის შექმნის თარიღისა და დროისგან.
"product": {
  "variants": [
    {
    "updated_at"
დრო და თარიღი, როდესაც ვარიანტი ბოლოს განახლდა. ეს შეიძლება განსხვავდებოდეს ძირითადი პროდუქტის ბოლო განახლების თარიღისა და დროისგან.
"product": {
  "variants": [
    {
    "inventory_quantity"
მონაცემთა ბაზის მიმდინარე მნიშვნელობა და ის, რაც მომხმარებლებისთვის ხელმისაწვდომია შესასყიდად. ეს შეიძლება იყოს უარყოფითი მნიშვნელობა, თუ ვარიანტის მარაგს თვალი არ ედევნება ან თუ ის დაყენებულია მარაგზე მეტის გაყიდვაზე.
"product": {
  "variants": [
    {
    "old_inventory_quantity"
მონაცემთა ბაზის მნიშვნელობა ვარიანტის ბოლო updated_at თარიღამდე.
შეკვეთა
"order": {
   "line_items": [
    {
    "requires_shipping"
გამოისახება როგორც true ან false. ეს მიუთითებს პროდუქტის ან ვარიანტის მიწოდების პარამეტრებზე შეკვეთის განთავსების დროს.
"order": {
   "line_items": [
    {
    "taxable"
გამოისახება როგორც true ან false. ეს მიუთითებს, თუ როგორ იყო დაყენებული გადასახადების დარიცხვა პროდუქტზე ან ვარიანტზე შეკვეთის განთავსების დროს.
"order": {
   "line_items": [
    {
    "variant_inventory_management"
გამოისახება როგორც shopify, amazon_marketplace_web, null ან მესამე მხარის მნიშვნელობა იმის მიხედვით, თუ შეკვეთის შესრულების რომელი სერვისია დაყენებული პროდუქტის მარაგისთვის თვალის სადევნებლად. მნიშვნელობა null ნიშნავს, რომ შეკვეთის დროს პროდუქტს თვალი არ ედევნებოდა.
"order": {
   "line_items": [
    {
    "fulfillable_quantity"
აჩვენებს, თუ რამდენი მარაგია კვლავ დაჯავშნილი სისტემის მიერ შეკვეთის დასასრულებლად. ეს არ უდრის ვარიანტის მიმდინარე მარაგს.
"order": {
   "line_items": [
    {
    "quantity"
შეძენილი პროდუქტების ან ვარიანტების რაოდენობა.
"order": {
   "line_items": [
    {
    "tax_lines"
შეერთებულ შტატებში, ეს აჩვენებს შტატის, ოლქისა და მუნიციპალიტეტის მნიშვნელობებს. თუ გადასახადის ხაზები არ ჩანს, მაგრამ შეკვეთაზე გადასახადი დარიცხულია, ეს ნიშნავს, რომ გადასახადი დაირიცხა ტრანსპორტირების ღირებულებაზე.
მომხმარებელი
"customer": {
  "created_at"
დრო და თარიღი, როდესაც მომხმარებელი თავდაპირველად შეიქმნა.
"customer": {
  "updated_at"
დრო და თარიღი, როდესაც მომხმარებლის პროფილი ბოლოს განახლდა.

მეტაველები JSON-ში

მეტაველები მოქნილი გზაა Shopify-ის რესურსზე, მაგალითად, პროდუქტებსა თუ კოლექციებზე, დამატებითი მორგებული ინფორმაციის მისამაგრებლად. მეტაველების გამოყენებით შენახული მონაცემების მაგალითები მოიცავს პროდუქტის მახასიათებლებს, ზომების ცხრილებს, ჩამოსატვირთ დოკუმენტებს, გამოსვლის თარიღებს, სურათებს ან ნაწილების ნომრებს. შეიტყვეთ მეტი მეტაველების გამოყენების შესახებ.

მხარდაჭერილი რესურსის გვერდის URL-ის ბოლოში შეგიძლია დაამატო /metafields.json, რათა აჩვენო ამ რესურსთან დაკავშირებული მეტაველები. იხილე შემდეგი ცხრილი რესურსებისა და URL ფორმატების მაგალითებისთვის, რომლებიც გამოიყენება მეტაველების ინფორმაციის საჩვენებლად JSON-ის მეშვეობით.

ჩამოთვლის ადმინ პანელის რესურსების ზოგიერთ მაგალითს JSON მეტაველების ფაილის URL-ის მაგალითთან ერთად.
რესურსის ტიპის მაგალითიURL-ის მაგალითი
კოლექციაhttps://admin.shopify.com/store/{your-store-name}/collections/{collection-id}/metafields.json
მომხმარებელიhttps://admin.shopify.com/store/{your-store-name}/customers/{customer-id}/metafields.json
შეკვეთაhttps://admin.shopify.com/store/{your-store-name}/orders/{order-id}/metafields.json
გვერდიhttps://admin.shopify.com/store/{your-store-name}/pages/{page-id}/metafields.json
პროდუქტიhttps://admin.shopify.com/store/{your-store-name}/products/{product-id}/metafields.json
ვარიანტიhttps://admin.shopify.com/store/{your-store-name}/products/{product-id}/variants/{variant-id}/metafields.json
პროდუქტის სურათიhttps://admin.shopify.com/store/{your-store-name}/metafields.json?metafield[owner_id]={id}&metafield[owner_resource]=product_image

შენიშვნა: პროდუქტის სურათის მეტაველების დამატება მხოლოდ API-ის მეშვეობითაა შესაძლებელი. შეცვალე {id} და სხვა ადგილის მანიშნებლები URL-ში შენი API-ის მოთხოვნებიდან აღებული რეალური მნიშვნელობებით.

მაღაზიაhttps://admin.shopify.com/store/{your-store-name}/metafields.json

რესურსების სრული სიისთვის, რომლებსაც შეიძლება ჰქონდეთ მეტაველები და თვისებების კონკრეტული ტიპებისთვის, რომლებიც ინახება თითოეული ტიპის რესურსისთვის, იხილე მეტაველის JSON რესურსი Shopify-ის დეველოპერის დოკუმენტაციაში.

მოვლენები JSON-ში

მოვლენები გენერირდება ზოგიერთი Shopify რესურსის მიერ გარკვეული ქმედებების დასრულებისას, როგორიცაა ბლოგპოსტის შექმნა, შეკვეთის შესრულება ან პროდუქტის დამატება.

მხარდაჭერილი რესურსის გვერდის URL-ის ბოლოში შეგიძლია დაამატო /events.json, რათა აჩვენო ამ რესურსთან დაკავშირებული მოვლენები. იხილე შემდეგი ცხრილი რესურსებისა და URL ფორმატების მაგალითებისთვის, რომლებიც გამოიყენება მოვლენის ინფორმაციის საჩვენებლად JSON-ის მეშვეობით.

ჩამოთვლის ადმინ პანელის რესურსების ზოგიერთ მაგალითს JSON მოვლენების ფაილის URL-ის მაგალითთან ერთად.
რესურსის ტიპის მაგალითიURL-ის მაგალითი
შეკვეთაhttps://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.json

ეს ფაილი ჩამოთვლის მოვლენების author-ს, რაც გატყობინებს, რომელმა მომხმარებლებმა შეასრულეს გარკვეული ქმედებები, მაგალითად, ვინ ან რამ გამოაქვეყნა პროდუქტი.

პროდუქტიhttps://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.json

ეს ფაილი ჩამოთვლის მოვლენების author-ს, რაც გატყობინებს, რომელმა მომხმარებლებმა შეასრულეს გარკვეული ქმედებები, მაგალითად, ვინ ან რამ მონიშნა გადახდა გადახდილად.

მაღაზიაhttps://admin.shopify.com/store/{your-store-name}/events.json?limit=250

ეს URL ფორმატი აჩვენებს 250 ყველაზე ახალ მოვლენას, რომლებიც შენს მაღაზიაში განხორციელდა. მოვლენები შეიძლება მოიცავდეს (მაგრამ არ შემოიფარგლებოდეს) პროდუქტის შექმნას ან განახლებებს, გვერდის წაშლასა და ვარიანტის განახლებებს.

რესურსების სრული სიისთვის, რომლებსაც შეუძლიათ მოვლენების შექმნა, და კონკრეტული მოვლენებისთვის, რომლებიც იქმნება თითოეული ტიპის რესურსისთვის, იხილე მოვლენის JSON რესურსი Shopify-ის დეველოპერის დოკუმენტაციაში.