Pengaturcaraan & skrip

Pengenalan kepada API eBay dengan Python API Perdagangan - Bahagian 3

Pengenalan kepada API eBay dengan Python API Perdagangan - Bahagian 3

Ini adalah artikel ketiga siri yang didedikasikan untuk Ebay API dan penggunaannya melalui Python. Dalam artikel pertama kami melihat bagaimana untuk menyediakan persekitaran kerja kami, mewujudkan pemaju dan akaun "ujian" kotak pasir, menghasilkan kunci API kami dan memasang SDK Python.

Dalam artikel kedua kami menghampiri Mencari API, memberi tumpuan kepada findItemsbykeywords Panggilan. Dalam artikel ini kita akan memperkenalkan API perdagangan.

Dalam tutorial ini anda akan belajar:

  • Apa panggilan "API Perdagangan" yang paling berguna
  • Cara membuat item dengan menggunakan Additem Panggilan API
Pengenalan kepada API eBay dengan Python: API Perdagangan - Bahagian 3

Keperluan perisian dan konvensyen yang digunakan

Keperluan Perisian dan Konvensyen Talian Perintah Linux
Kategori Keperluan, konvensyen atau versi perisian yang digunakan
Sistem Sistem operasi agnostik.
Perisian git dan python3
Yang lain Pengetahuan mengenai bahasa pengaturcaraan python dan konsep berorientasikan objek asas.
Konvensyen # - Memerlukan arahan Linux yang diberikan untuk dilaksanakan dengan keistimewaan akar sama ada secara langsung sebagai pengguna root atau dengan menggunakan sudo perintah
$ - Memerlukan arahan Linux yang diberikan sebagai pengguna yang tidak layak

API perdagangan

The API perdagangan adalah subjek artikel ketiga ini dalam siri ini yang didedikasikan untuk Python dan Ebay API. API khusus ini merangkumi banyak panggilan yang sangat berguna: dengan menggunakannya, kami dapat, antara lain, membuat atau mengakhiri item dan mendapatkan maklumat mengenai kategori, kedai atau penjual.

Panggilan API perdagangan

Senarai yang ada API perdagangan Panggilan terlalu lama untuk dibentangkan di sini secara keseluruhan, bagaimanapun, di sini kami membentangkan sebahagian daripada mereka dan matlamat yang dapat kami capai dengan penggunaannya:

  • AddItem - Dengan menggunakan panggilan ini, kita boleh mula menjual item dengan harga tetap atau dengan lelongan
  • Addtowatchlist - dengan menggunakan panggilan ini, kami dapat menambahkan satu atau lebih item ke senarai pengawasan kami
  • EndItem - Dengan panggilan ini kita boleh berhenti menjual artikel sebelum tarikh tamat tempoh yang ditetapkan
  • GetCategories - Gunakan panggilan ini untuk mendapatkan maklumat mengenai kategori eBay untuk laman web tertentu
  • Getmyebayselling - Ambil maklumat mengenai aktiviti jualan kami
  • GetStore - Dapatkan maklumat mengenai kedai eBay tertentu

Cara kami menggunakan panggilan ini adalah sama yang kita lihat dalam artikel sebelumnya: kami membuat dan menghantar permintaan bersama dengan nama panggilan. Untuk mencari senarai lengkap panggilan yang ada, sila baca
dokumentasi rasmi.

Menjana tanda

Sebelum meneruskan, pastikan anda telah membuat pengguna "ujian" kotak pasir dan mengikuti langkah -langkah yang dimasukkan dalam artikel pertama siri ini. Di dalam akar projek kami, kami menggunakan eBay.yaml fail untuk menyimpan kelayakan kami untuk pelbagai domain. Untuk menggunakan API perdagangan, Dan berinteraksi dengan pengguna "ujian" kotak pasir, kami mesti menyediakan kami ID App, Id dev, ID CERT Dan token kita sekarang akan menjana.

Mendapatkan token agak mudah. Akses laman web Program Pemaju Ebay, dan navigasi ke halaman Kekunci Aplikasi; di sini, di bahagian kotak pasir (sebelah kiri), di dalam ID App medan, klik pada Token pengguna pautan. Anda akan dialihkan ke bahagian ini:

Log masuk ke kotak pasir eBay

Klik pada butang biru "Log Masuk ke Sandbox" dan anda akan dihantar ke halaman Log Masuk Tapak Sandbox. Di sini anda mesti menggunakan pengguna "ujian" kotak pasir yang anda buat sebelumnya. Sebaik sahaja anda masuk dengan jayanya, anda akan diminta untuk mengesahkan bahawa anda ingin memberikan akses kepada data akaun anda:

Akses permohonan pemberian

Klik pada butang "Setuju", dan anda akan diarahkan kembali ke halaman Generasi Token. Di sini anda akan melihat token yang dijana baru:

Ambil API eBay baru yang dijana token

Langkah seterusnya ialah menyalin token dan kelayakan lain di dalam eBay.yaml Fail, di bahagian yang sepadan, seperti dalam gambar di bawah:

eBay.yaml Konfigurasi dengan token yang baru dijana dan kelayakan lain

Semuanya ada, mari buat barang kami!

Membuat item dengan panggilan API Additem

Di dalam akar projek kami, mari buat skrip baru, dan panggilnya additem.py. Di dalamnya kita akan menulis kod yang diperlukan untuk membuat item pertama kami. Sekiranya kita ingin menjual papan kekunci mekanikal, inilah kod yang boleh kita tulis:

#!/usr/bin/env python3 dari ebaysdk.Sambungan import perdagangan jika __name__ == '__main__': api = sambungan (config_file = "eBay.yaml ", domain =" API.Kotak pasir.eBay.com ", debug = true) permintaan = " item ": " tajuk ":" papan kekunci mekanikal profesional "," negara ":" us "," lokasi ":" it "," site ":" us "," ConditionId ":" 1000 "," PembayaranMethods ":" PayPal "," PayPalemailaddress ":" Tiada [email protected] "," primarycategory ": " kategoriId ":" 33963 "," Description ":" Papan kekunci mekanikal yang sangat bagus!"," Penyenaraian ":" days_10 "," startprice ":" 150 "," mata wang ":" usd "," returnpolicy ": " returnsacceptedOption ":" returnscepted "," featuroption ":" Moneyback "," ReturnSwithinOption " : "Hari_30", "keterangan": "Jika anda tidak berpuas hati, kembalikan papan kekunci."," ShippingCostpaidByOption ":" Pembeli "," ShippingDetails ": " ShippingServiceOptions ": " freeshipping ":" true "," shippingservice ":" uspsmedia "," DispatchTimemax ":" 3 ".Jalankan ("AddItem", Permintaan)
Salinan

Mari lihat kod di atas. Sebagai perkara pertama, kami mengimport Sambungan kelas dari Ebaysdk.perdagangan modul. Kami perpustakaan yang diperlukan, kami mencipta contoh baru Sambungan Kelas: Di dalam pembina kami, kami menentukan lokasi fail konfigurasi, seperti yang kami lakukan untuk API Penemuan, dan juga domain yang akan digunakan untuk permintaan, yang dalam kes ini API.Kotak pasir.eBay.com.

Berbuat demikian kami menyatakan bahawa permintaan kami akan
Dihantar ke tapak kotak pasir: kelayakan kami akan dicari dalam fail konfigurasi bergantung pada domain ini. Akhir.

Langkah seterusnya ialah penciptaan permintaan dan keterangan kami Item Dalam bentuk kamus python yang mudah. Mari kita lihat secara ringkas pelbagai sifat yang kami gunakan.

Maklumat lokasi dan negara

Dengan menggunakan Tajuk Pilihan Kami Menentukan Tajuk Penyenaraian Kami: Semasa Menjual Item di Ebay, Mencari Tajuk Baik Sangat Penting. Dengan Negara Kami mengisytiharkan negara alamat pendaftaran penjual: Nilai ini terdiri daripada dua digit; Anda boleh merujuk senarai ini untuk mencari semua nilai yang mungkin berlaku.

Kunci seterusnya yang kami gunakan ialah Lokasi: ini diperlukan untuk menentukan lokasi geografi item, dalam hal ini Itali.

Dengan Tapak, Sebaliknya, kami menetapkan tapak eBay di mana item itu akan muncul. Parameter ini mempengaruhi yang lain, seperti, sebagai contoh, pengenalpastian kategori yang ada, kerana kategori yang sama boleh mempunyai ID yang berbeza di laman web yang berbeza. Nilai ini mesti selaras dengan tapak yang dinyatakan dalam pembina Sambungan Kelas (lalai adalah "ebay-us").

Mengisytiharkan syarat item

Satu lagi perkara penting untuk ditentukan ialah keadaan artikel. Artikel boleh menjadi baru atau digunakan sebagai contoh, dan beberapa artikel tertentu mempunyai keadaan khusus yang boleh digunakan, bergantung pada kategori mereka. Dalam kes ini kita gunakan "1000" yang merupakan kod yang sepadan dengan status "baru". Jadual kod yang ada boleh didapati di sini.

Menetapkan kaedah pembayaran

Kaedah pembayaran yang kami sanggup terima dapat dipilih dari senarai semua kaedah pembayaran yang ada. Dalam kes ini kami menggunakan "PayPal", dan kami juga menyediakan alamat e -mel untuk digunakan untuk pembayaran, masing -masing dengan menggunakan Cara bayaran dan Paypalemailaddress Kunci.

Memilih kategori untuk item tersebut

Langkah seterusnya ialah menentukan kategori untuk item yang kami jual: kami melakukannya dengan menggunakan PrimaryCategory kunci, yang sepadan dengan kamus di mana ID kategori sebenar dikenal pasti oleh KategoriId kunci. Setiap kategori dikenal pasti oleh ID unik dalam konteks tapak tertentu, tetapi pengenal pasti boleh berbeza di beberapa tapak eBay. Mencari kategori yang betul boleh menjadi tugas yang membosankan. Untuk mencari yang sesuai, anda boleh menggunakan panggilan tertentu seperti GetsuggestedCategories atau anda boleh berunding dengan alat dalam talian seperti ini.

Satu lagi perkara penting untuk diperhatikan ialah, apabila memilih kategori untuk item, eBay menjangkakan bahawa anda menggunakan salah satu segmen terakhir pokok kategori (kategori "daun"): anda tidak boleh menggunakan generik. Dalam kes ini kita gunakan 33963 yang sepadan dengan Papan kekunci & papan kekunci dan merupakan salah satu segmen terakhir dari Komputer/tablet & rangkaian kategori, laluan penuhnya ialah Komputer/Tablet & Rangkaian> Papan Kekunci, Tikus & Pointers> Papan Kekunci & Papan Kayu.

Menetapkan Penerangan dan Harga Item

Keterangannya adalah satu lagi bidang yang sangat penting: ini membolehkan kita menerangkan item dengan tahap perincian yang lebih tinggi. Kami tidak terhad kepada teks biasa di sini, kami juga boleh menggunakan kod asas HTML dan CSS, tetapi kami tidak dibenarkan menggunakan kandungan aktif, jadi penggunaan JavaScript, misalnya, dilarang. Sekiranya kes kami ingin memberikan tag HTML dan memanfaatkan ciri ini, kami mesti menggunakan Cdata Sintaks khusus semasa menggunakan Python SDK:

"Penerangan": ""

Dengan Penyenaraian Kami menetapkan selang waktu penyenaraian harus tetap aktif. EBay menggunakan senarai jenis kod yang akan digunakan dalam bidang ini (beberapa jenis mempunyai penggunaan terhad). Dalam kes ini kita gunakan "Hari_10" yang menentukan tempoh 10 hari.

Nilai yang kami sediakan untuk Startprice ditafsirkan secara berbeza bergantung kepada jenis penyenaraian: jika ia adalah lelongan, ini dianggap sebagai harga permulaan lelongan; Sekiranya ia adalah penyenaraian harga tetap, sebaliknya, ia dianggap sebagai harga malar yang mesti dibayar oleh pelanggan untuk membeli barang tersebut. Kos papan kekunci kami 150 unit mata wang yang kami tentukan Mata wang. Nilai yang akan digunakan di sini mesti dipilih dari senarai mata wang yang ada.

Mewujudkan Polisi Pulangan

Bahagian seterusnya yang kami tentukan adalah Syarat pengembalian bahagian yang menggambarkan dasar kami mengenai pulangan. Bahagian ini ditakrifkan sebagai kamus itu sendiri, di mana kita menggunakan kunci berikut:

ReturnAcceptedOption mentakrifkan sama ada penjual menerima pulangan atau tidak: nilai yang berkenaan adalah Pulangan diterima atau Returnsnotacepted.

Pengembalian semula mentakrifkan bagaimana penjual mengembalikan pembeli atas pulangan: Di semua pasaran eBay Nilai ini mesti ditetapkan ke Wang balik, Semasa di pasaran AS, ia juga boleh ditetapkan MoneyBackorReplacement.

The ReturnSwithinOption Parameter cukup penjelasan diri: dengan parameter ini kita menentukan jumlah masa dari menyampaikan pembeli harus mengembalikan barang tersebut. Senarai nilai yang boleh digunakan dalam bahagian ini boleh didapati di halaman ini. Dalam kes ini kita gunakan "Hari_30": masa 30 hari mesti digunakan untuk memenuhi syarat sebagai penyenaraian "tertinggi".

The Penerangan medan mengandungi penjelasan terperinci mengenai dasar pulangan penjual dan dipaparkan di bahagian relatif halaman "Lihat Item". Mesej yang mesra biasanya disediakan di sini.

Dengan ShippingCostpaidByOption Parameter Adalah mungkin untuk mengisytiharkan siapa, antara penjual dan pembeli harus membayar caj penghantaran balik; nilai yang diterima adalah Penjual atau Pembeli.

Perincian penghantaran

Bahagian lain yang sangat penting untuk ditentukan adalah mengenai dasar dan kos perkapalan: ini boleh dilakukan dengan menggunakan Shippingserviceoption kunci. Kunci ini dikaitkan dengan kamus di mana kita dapat menentukan pelbagai parameter. Dalam kes ini, kami menetapkan dasar penghantaran percuma, dengan menggunakan Penghantaran percuma kunci, dan menyediakan Benar (rentetan) sebagai nilai, dan kami menentukan perkhidmatan perkapalan dengan Penjelasan. Rujuk senarai ini untuk gambaran keseluruhan nilai yang mungkin digunakan di sini.

Akhirnya, kami menggunakan DispatchTimemax pilihan, yang pada dasarnya mentakrifkan bilangan maksimum hari perniagaan yang diisytiharkan penjual akan digunakan untuk menyediakan penghantaran setelah menerima pembayaran.

Menghantar permintaan kami dan sahkan hasilnya

Kami menyediakan permintaan kami dan memberikan maklumat yang diperlukan mengenai item yang ingin kami jual; Sekarang kami dapat menghantar permintaan kami dengan menggunakan melaksanakan kaedah, menyediakan, seperti yang kita lakukan untuk Mencari API, Nama panggilan, Additem sebagai hujah pertama, dan kamus permintaan sebagai yang kedua. Sekiranya semuanya berjalan lancar setelah permintaan dihantar, item itu harus hadir di laman kotak pasir. Jadi itu:

Barang yang dibuat menggunakan ebay dan python api

Kesimpulan

Dalam artikel ini kita menghampiri API perdagangan. Di antara banyak panggilan yang ada, kami memberi tumpuan kepada Additem satu. Kami membuat item yang menyediakan medan yang diperlukan untuk konfigurasi asas dan menghantar permintaan kami dengan jayanya ke akaun kotak pasir kami. Dalam artikel seterusnya siri ini kita akan bercakap mengenai Merchandising API.

Jadual kandungan

  • Bahagian 0

    Pengenalan

  • Bahagian I

    Mendapatkan kunci dan mengakses kotak pasir

  • Bahagian II

    API Penemuan

  • Bahagian III

    API perdagangan

  • Bahagian IV

    API Merchandising

Tutorial Linux Berkaitan:

  • Cara Mengesan Sistem Panggilan yang Dibuat oleh Proses Dengan Strace On ..
  • Cara membuat pakej flatpak
  • Pengenalan kepada Automasi, Alat dan Teknik Linux
  • Perkara yang hendak dipasang di Ubuntu 20.04
  • Menguasai Gelung Skrip Bash
  • Mint 20: Lebih baik daripada Ubuntu dan Microsoft Windows?
  • Tutorial Debugging GDB untuk Pemula
  • Sistem Hung Linux? Cara melarikan diri ke baris arahan dan ..
  • Perkara yang perlu dilakukan setelah memasang ubuntu 20.04 Focal Fossa Linux
  • Cara Menggunakan Adb Android Debug Bridge untuk Mengurus Android Anda ..