Pemrograman & Scripting

Pengantar Ebay API dengan Python The Trading API - Bagian 3

Pengantar Ebay API dengan Python The Trading API - Bagian 3

Ini adalah artikel ketiga dari seri yang didedikasikan untuk ebay API dan penggunaannya melalui Python. Pada artikel pertama kami melihat cara mengatur lingkungan kerja kami, menciptakan akun pengembang dan "tes" kotak pasir, menghasilkan kunci API kami dan menginstal Python SDK.

Pada artikel kedua kami mendekati Menemukan API, fokus pada findItemsbykeywords panggilan. Dalam artikel ini kami akan memperkenalkan API Perdagangan.

Dalam tutorial ini Anda akan belajar:

  • Apa saja panggilan "API perdagangan" yang paling berguna
  • Cara membuat item dengan menggunakan Tambahkan Barang Panggilan API
Pengantar Ebay API dengan Python: The Trading API - Bagian 3

Persyaratan dan konvensi perangkat lunak yang digunakan

Persyaratan Perangkat Lunak dan Konvensi Baris Perintah Linux
Kategori Persyaratan, konvensi atau versi perangkat lunak yang digunakan
Sistem Sistem Operasi Agnostik.
Perangkat lunak git dan python3
Lainnya Pengetahuan tentang Bahasa Pemrograman Python dan Konsep Berorientasi Objek Dasar.
Konvensi # - mensyaratkan perintah linux yang diberikan untuk dieksekusi dengan hak istimewa root baik secara langsung sebagai pengguna root atau dengan menggunakan sudo memerintah
$ - mensyaratkan perintah Linux yang diberikan untuk dieksekusi sebagai pengguna biasa

API perdagangan

Itu API Perdagangan adalah subjek artikel ketiga ini dalam seri ini yang didedikasikan untuk Python dan API eBay. API khusus ini mencakup banyak panggilan yang sangat berguna: dengan menggunakannya, kita dapat, antara lain, membuat atau mengakhiri item dan mengambil informasi tentang kategori, toko atau penjual.

Panggilan API Perdagangan

Daftar yang tersedia API Perdagangan Panggilan terlalu lama untuk disajikan di sini secara keseluruhan, namun, di sini kami menyajikan beberapa dari mereka dan tujuan yang dapat kami capai dengan penggunaannya:

  • AddItem - Dengan menggunakan panggilan ini, kita dapat mulai menjual barang baik dengan harga tetap atau dengan pelelangan
  • AddToWatchList - Dengan menggunakan panggilan ini, kami dapat menambahkan satu atau lebih item ke daftar jam tangan kami
  • EndItem - Dengan panggilan ini kita dapat berhenti menjual artikel sebelum tanggal kedaluwarsa yang ditetapkan
  • GetCategories - Gunakan panggilan ini untuk mendapatkan informasi tentang kategori eBay untuk situs tertentu
  • GetMyebayselling - ambil informasi tentang aktivitas penjualan kami
  • GetStore - Ambil informasi tentang toko eBay tertentu

Cara kami menggunakan panggilan ini adalah sama yang kami lihat di artikel sebelumnya: kami membuat dan mengirim permintaan bersama dengan nama panggilan. Untuk menemukan daftar lengkap panggilan yang tersedia, silakan baca
dokumentasi resmi.

Menghasilkan token

Sebelum melanjutkan, pastikan Anda telah membuat pengguna "tes" kotak pasir dan mengikuti langkah -langkah yang termasuk dalam artikel pertama dari seri ini. Di dalam akar proyek kami, kami menggunakan eBay.yaml file untuk menyimpan kredensial kami untuk berbagai domain. Untuk menggunakan API Perdagangan, dan berinteraksi dengan pengguna "tes" kotak pasir, kami harus menyediakan kami ID Aplikasi, ID DEV, Cert ID dan token yang sekarang akan kita hasilkan.

Memperoleh token cukup mudah. Mengakses situs web program pengembang ebay, dan menavigasi ke halaman Kunci Aplikasi; Di sini, di bagian kotak pasir (sisi kiri), di dalam ID Aplikasi bidang, klik pada Token Pengguna tautan. Anda akan dialihkan ke bagian ini:

Masuk ke Ebay Sandbox

Klik tombol "Masuk ke Sandbox" Biru dan Anda akan dikirim ke halaman Login Situs Sandbox. Di sini Anda harus menggunakan pengguna "tes" kotak pasir yang Anda buat sebelumnya. Setelah Anda masuk dengan sukses, Anda akan diminta untuk mengonfirmasi bahwa Anda ingin memberikan akses ke data akun Anda:

Akses aplikasi hibah

Klik tombol "Setuju", dan Anda akan diarahkan kembali ke halaman Generasi Token. Di sini Anda akan melihat token baru yang dihasilkan:

Mengambil token yang dihasilkan ebay API baru

Langkah selanjutnya adalah menyalin token dan kredensial lainnya di dalam eBay.yaml File, di bagian yang sesuai, seperti pada gambar di bawah ini:

eBay.yaml Konfigurasi dengan token yang baru ebay dan kredensial lainnya

Semua ada di tempat, mari kita buat item kita!

Membuat item dengan panggilan API additem

Di dalam akar proyek kami, mari kita buat skrip baru, dan sebut saja Tambahkan Barang.py. Di dalamnya kami akan menulis kode yang diperlukan untuk membuat item pertama kami. Seandainya kita ingin menjual keyboard mekanik, berikut adalah kode yang bisa kita tulis:

#!/usr/bin/env python3 dari ebaysdk.Trading Import Connection if __name__ == '__main__': API = koneksi (config_file = "ebay.yaml ", domain =" API.bak pasir.eBay.com ", debug = true) request = " item ": " title ":" Keyboard Mekanik Profesional "," Negara ":" US "," Lokasi ":" It "," Situs ":" Us "," ConditionId ":" 1000 "," Paymentmethods ":" PayPal "," PayPalemailAddress ":" No No. Gmail.com "," primarycategory ": " CategoryId ":" 33963 "," Deskripsi ":" keyboard mekanik yang sangat bagus!"," ListingDuration ":" Days_10 "," StartPrice ":" 150 "," Currency ":" USD "," ReturnPolicy ": " ReturnsceptedOption ":" Returnscepceped "," Refundoption ":" Moneyback "," Returnswithinoption " : "Days_30", "Deskripsi": "Jika Anda tidak puas, kembalikan keyboard."".mengeksekusi ("additem", permintaan)
Menyalin

Mari kita lihat kode di atas. Sebagai hal pertama, kami mengimpor Koneksi kelas dari Ebaysdk.jual beli modul. Kami adalah perpustakaan yang dibutuhkan di tempat, kami membuat instance baru dari Koneksi Kelas: Dalam konstruktornya kami menentukan lokasi file konfigurasi, seperti yang kami lakukan untuk API temuan, dan juga domain yang akan digunakan untuk permintaan, yang dalam hal ini adalah API.bak pasir.eBay.com.

Melakukan itu kami menyatakan bahwa permintaan kami akan
Dikirim ke Situs Sandbox: Kredensial kami akan dicari dalam file konfigurasi tergantung pada domain ini. Akhirnya, kami mengaktifkan mode debug: ini sangat berguna saat melakukan permintaan yang kompleks, karena kemungkinan kesalahan akan segera terdeteksi.

Langkah selanjutnya adalah penciptaan permintaan dan deskripsi kami Barang dalam bentuk kamus Python sederhana. Mari kita lihat secara singkat berbagai properti yang kami gunakan.

Lokasi dan Informasi Negara

Dengan menggunakan Judul Opsi Kami menentukan judul daftar kami: Saat menjual item di eBay, menemukan judul yang bagus sangat penting. Dengan Negara Kami mendeklarasikan negara dari alamat pendaftaran penjual: Nilai ini terdiri dari dua digit; Anda dapat berkonsultasi dengan daftar ini untuk menemukan semua nilai yang mungkin berlaku.

Kunci berikutnya yang kami gunakan adalah Lokasi: Ini diperlukan untuk menentukan lokasi geografis item, dalam hal ini Italia.

Dengan Lokasi, Sebagai gantinya, kami menentukan situs eBay di mana item tersebut akan muncul. Parameter ini memang mempengaruhi yang lain, seperti, misalnya, pengidentifikasi kategori yang tersedia, karena kategori yang sama dapat memiliki ID yang berbeda di situs web yang berbeda. Nilai ini harus konsisten dengan situs yang ditentukan dalam konstruktor Koneksi Kelas (standarnya adalah "eBay-US").

Mendeklarasikan kondisi item

Hal penting lainnya untuk didefinisikan adalah kondisi artikel. Artikel dapat menjadi baru atau digunakan misalnya, dan beberapa artikel tertentu memiliki kondisi khusus yang dapat digunakan, tergantung pada kategorinya. Dalam hal ini kami menggunakan "1000" yang merupakan kode yang sesuai dengan status "baru". Tabel kode yang tersedia dapat ditemukan di sini.

Mengatur metode pembayaran

Metode pembayaran yang bersedia kami terima dapat dipilih dari daftar semua metode pembayaran yang tersedia. Dalam hal ini kami menggunakan "paypal", dan kami juga memberikan alamat email yang akan digunakan untuk pembayaran, masing -masing dengan menggunakan Cara Pembayaran Dan Paypalemailaddress kunci.

Memilih kategori untuk item tersebut

Langkah selanjutnya adalah mendefinisikan kategori untuk barang yang kami jual: kami melakukannya dengan menggunakan Kategori primer kunci, yang sesuai dengan kamus di mana ID kategori aktual diidentifikasi oleh Kategoriid kunci. Setiap kategori diidentifikasi oleh ID unik dalam konteks situs tertentu, tetapi pengidentifikasi dapat berbeda di beberapa situs eBay. Menemukan kategori yang tepat bisa menjadi tugas yang membosankan. Untuk menemukan yang sesuai, Anda dapat menggunakan panggilan tertentu seperti GetsugededCategories Atau Anda dapat berkonsultasi dengan alat online seperti ini.

Hal penting lainnya untuk diperhatikan adalah bahwa, ketika memilih kategori untuk suatu item, eBay berharap Anda menggunakan salah satu segmen terakhir dari pohon kategori (kategori "daun"): Anda tidak dapat menggunakan yang umum. Dalam hal ini kami menggunakan 33963 yang sesuai dengan Keyboard & keypads dan merupakan salah satu segmen terakhir dari Komputer/Tablet & Jaringan Kategori, jalur lengkapnya adalah komputer/tablet & jaringan> keyboard, tikus & pointer> keyboard & keypads.

Mengatur deskripsi dan harga item

Deskripsi adalah bidang lain yang sangat penting: ini memungkinkan kami untuk menggambarkan item dengan tingkat detail yang lebih tinggi. Kami tidak terbatas pada teks biasa di sini, kami juga dapat menggunakan kode HTML dan CSS dasar, tetapi kami tidak diizinkan menggunakan konten aktif, sehingga penggunaan JavaScript, misalnya, dilarang. Jika kasus kami ingin memberikan tag HTML dan memanfaatkan fitur ini, kami harus menggunakan CDATA Sintaks khusus saat menggunakan Python SDK:

"Keterangan": ""

Dengan Daftar Daftar Kami menentukan interval waktu daftar harus tetap aktif. EBay menggunakan daftar jenis kode yang akan digunakan di bidang ini (beberapa jenis memiliki penggunaan terbatas). Dalam hal ini kami menggunakan "Days_10" yang menentukan durasi 10 hari.

Nilai yang kami sediakan Mulai Price ditafsirkan secara berbeda tergantung pada jenis daftar: jika itu adalah pelelangan, ini dianggap sebagai harga mulai lelang; Jika itu adalah daftar harga tetap, sebaliknya, itu dianggap sebagai harga konstan yang harus dibayar klien untuk membeli barang tersebut. Biaya keyboard kami 150 unit mata uang yang kami tentukan Mata uang. Nilai yang akan digunakan di sini harus dipilih dari daftar mata uang yang tersedia.

Membangun kebijakan pengembalian

Bagian selanjutnya yang kami definisikan adalah Kebijakan pengembalian bagian yang menjelaskan kebijakan kami tentang pengembalian. Bagian ini didefinisikan sebagai kamus itu sendiri, di dalamnya kami menggunakan kunci berikut:

ReturnacceptedOption mendefinisikan apakah penjual menerima pengembalian atau tidak: nilai yang berlaku Pengembalian diterima atau Returnsnotaccepted.

Pengembalian uang mendefinisikan bagaimana penjual mengembalikan pengembalian pembeli: di semua pasar eBay, nilai ini harus disetel Uang kembali, Saat berada di pasar AS, itu juga dapat diatur Moneybackorreplacement.

Itu Returnswithinoption Parameter cukup jelas: Dengan parameter ini kami menentukan jumlah waktu dari pengiriman pembeli untuk mengembalikan item kembali. Daftar nilai yang dapat digunakan di bagian ini tersedia di halaman ini. Dalam hal ini kami menggunakan "Days_30": Waktu 30 hari harus digunakan untuk memenuhi syarat sebagai daftar "teratas".

Itu Keterangan Bidang berisi penjelasan terperinci tentang kebijakan pengembalian penjual dan ditampilkan di bagian relatif dari halaman "Lihat item". Pesan yang ramah biasanya disediakan di sini.

Dengan ShippingCostPaidByOption Parameter dimungkinkan untuk menyatakan siapa, antara penjual dan pembeli harus membayar biaya pengiriman pengembalian; Nilai yang diterima adalah Penjual atau Pembeli.

Rincian pengiriman

Bagian lain yang sangat penting untuk didefinisikan adalah tentang kebijakan dan biaya pengiriman: Ini dapat dilakukan dengan menggunakan ShippingServiceOption kunci. Kunci ini dikaitkan dengan kamus di mana kita dapat mendefinisikan berbagai parameter. Dalam hal ini kami menetapkan kebijakan pengiriman gratis, dengan menggunakan Bebas biaya kirim kunci, dan menyediakan BENAR (string) sebagai nilainya, dan kami mendefinisikan layanan pengiriman dengan ShippingService. Konsultasikan dengan daftar ini untuk tinjauan lengkap nilai -nilai yang mungkin digunakan di sini.

Akhirnya, kami menggunakan DispatchTimemax Opsi, yang pada dasarnya mendefinisikan jumlah maksimum hari kerja yang dinyatakan oleh penjual akan digunakan untuk menyiapkan pengiriman setelah menerima pembayaran.

Mengirimkan permintaan kami dan verifikasi hasilnya

Kami menyiapkan permintaan kami dan memberikan informasi yang diperlukan tentang barang yang ingin kami jual; Sekarang kami dapat mengirimkan permintaan kami dengan menggunakan menjalankan metode, menyediakan, seperti yang kami lakukan untuk Menemukan API, nama panggilan, Tambahkan Barang sebagai argumen pertama, dan kamus permintaan sebagai yang kedua. Jika semuanya berjalan dengan baik setelah permintaan dikirim, item harus sekarang ada di situs Sandbox. Begitulah:

Item yang Dibuat Menggunakan Ebay dan Python API

Kesimpulan

Dalam artikel ini kami mendekati API Perdagangan. Di antara banyak panggilan yang tersedia, kami fokus pada Tambahkan Barang satu. Kami membuat item yang menyediakan bidang yang diperlukan untuk konfigurasi dasar dan mengirim permintaan kami dengan sukses ke akun Sandbox kami. Dalam artikel berikutnya dari seri ini kita akan berbicara tentang API Merchandising.

Daftar Isi

  • Bagian 0

    Perkenalan

  • Bagian i

    Mendapatkan kunci dan mengakses kotak pasir

  • BAGIAN II

    API temuan

  • Bagian III

    API perdagangan

  • Bagian IV

    API merchandising

Tutorial Linux Terkait:

  • Cara melacak panggilan sistem yang dilakukan oleh proses dengan strace di…
  • Cara membuat paket flatpak
  • Pengantar Otomatisasi Linux, Alat dan Teknik
  • Hal -hal yang harus diinstal pada ubuntu 20.04
  • Menguasai loop skrip bash
  • Mint 20: Lebih baik dari Ubuntu dan Microsoft Windows?
  • Tutorial debugging GDB untuk pemula
  • Sistem Linux Hung? Cara melarikan diri ke baris perintah dan…
  • Hal -hal yang harus dilakukan setelah menginstal ubuntu 20.04 FOSSA FOSSA Linux
  • Cara menggunakan ADB Android Debug Bridge untuk mengelola Android Anda…