Ana SayfaBelgelerKod ÖrnekleriAPI BaşvurusuDuyurularModellerSürüm NotlarıSSSGitHubVideolar
Geliştirici MerkeziAPI DurumuDestek
Belgeler
Geliştirici MerkeziAPI DurumuDestek

Eğitim: Python SDK Kullanarak SP-API Çağrılarınızı Otomatikleştirin

Amazon (LWA) token değişimi ve kimlik doğrulaması ile Oturum Açma ile SP-API çağrılarınızı otomatikleştirin.

Bu eğitim, uygulamanızı sorunsuz bir şekilde oluşturmak için Amazon (LWA) token değişimi ve kimlik doğrulaması ile Giriş özellikli bir Python SDK oluşturmak için gerekli tüm ayrıntıları sağlar. Python SDK'yı oluşturmak için gereken ön koşulları öğrenecek ve ayrıca Siparişler için Satış Ortağı API'sini ve Swagger Kod Oluşturucu'nu kullanarak bir örnek görüntüleyeceksiniz.

Ürün bilgilerine erişme, siparişleri yönetme, gönderileri işleme ve daha fazlası dahil olmak üzere Amazon pazar yeri özelliklerini uygulamalarınıza entegre etmek için bu SDK'yı kullanabilirsiniz.

Eğitim

Aşağıdaki eğitim, SP-API çağrılarını otomatikleştirmek için kendi Python SDK'nızı kurmanıza yardımcı olacaktır.

Ön koşullar

Bu eğitimi tamamlamak için aşağıdaki ön koşullara ihtiyacınız vardır:

  • Taslak veya yayınlanmış durumda bir hibrit veya SP-API uygulaması
  • Entegre geliştirme ortamı (IDE) yazılımı
  • Python (sürüm 3.6 veya üstü)
  • swagger-codegen-cli-2.3 (veya daha sonra) Bu araç, SP-API'nin Swagger tanımlarından Python istemci kodu oluşturmak için kullanılır.

Başvurunuzun Satış Ortağı API'sine bağlanabilmesi için, onu kaydetmeniz ve bir satış ortağı tarafından yetkilendirilmesi gerekir. Hibrit veya SP-API uygulamanız yoksa, aşağıdaki adımları izleyin geliştirici olarak kaydolun, başvurunuzu kaydedin, ve Satış Ortağı API uygulamalarını yetkilendirme. Ardından, bu eğitime geri dönün.

Ardından, eğitim için çalışma alanınızı ayarlayın.

Adım 1. Çalışma alanınızı ayarlayın

  1. Yerel sürücünüzde, bu proje için bir dizin oluşturun, adlandırın SPAPI_Python_SDKve yeni dizine gidin.

  2. Klonlayın müşteri deposu.

  3. Aşağıdaki araçları indirin.

    • IDE yazılımı (bu izlenecek yol kullanır Visual Studio (Windows işletim sisteminde IDE)
    • Python (sürüm 3.6 veya üstü). Bu yazılımı şuradan indirebilirsiniz: python.org.
  4. Swagger Code Jar'ı indirmek için terminalinizde aşağıdaki komutu çalıştırın:

    `wget https://repo1.maven.org/maven2/io/swagger/swagger-codegen-cli/2.4.13/swagger-codegen-cli-2.4.13.jar -O swagger-codegen-cli.jar`
  5. Kopyalama swagger-codegen-cli.jar yerel dizininize C:\\SPAPI_Python_SDK.

  6. Python'u yüklemek için terminalinizde aşağıdaki komutu çalıştırın backoff Çevrenizdeki kütüphane:

    pip install backoff
  7. GitHub'da şu adrese gidin https://github.com/amzn/selling-partner-api-models/tree/main/models ve klonlamak için aşağıdaki komutu çalıştırın selling-partner-api-models yerel dizininize depo C:\\SPAPI_Python_SDK.

    git clone https://github.com/amzn/selling-partner-api-models

Artık gerekli kurulumu tamamladığınıza göre, bir sonraki adım yerel dizininize indirilen kimlik doğrulama ve yetkilendirme sınıflarıyla Python SDK'yı oluşturmaktır. C:\\SPAPI_Python_SDK.

Adım 2. Swagger tanımlarından bir Python istemcisi oluşturun

  1. Swagger JSON dosyasını bulun SP-API API modeli yerel dizininizden kullanmak istediğiniz (örneğin, Siparişler API'si) C:\\SPAPI_Python_SDK.

  2. İstemci kodu oluşturmak için terminalinizde aşağıdaki komutu çalıştırın. Yolları ve API modelini ayarlarınızla değiştirdiğinizden emin olun.

    java -jar /[path_to_swagger_jar]/swagger-codegen-cli.jar generate -l python -t /[path_to_mustach_resources]/resources/ -D packageName=swagger_client -o /[path_to_client_folder]/client/[SP-API_NAME] -i /[path_to_model_folder]/models/[SP-API_NAME]/SP-API.json

Artık bir Python istemcisi oluşturduğunuza göre, kimlik doğrulama modelini entegre etmeniz gerekiyor.

Adım 3. Kimlik doğrulama modülünü entegre edin

  1. Bulun auth ve spapi istemci kodu klasörleri C:\\SPAPI_Python_SDK, SDK'nın indirildiği dizin.
  2. Aşağıdaki Python dosyalarındaki yolları güncelleyin: spapiclient.py ve LwaRequest.py. Her dosya neyin güncelleneceğine dair talimatlar içerir.

Kimlik doğrulama ayarlandığında artık Python SDK paketini kurmaya hazırsınız.

Adım 4. Python SDK paketini kurun

  1. Şuraya git C:\\SPAPI_Python_SDK SDK'nın oluşturulduğu dizin.
  2. Oluşturmak için aşağıdaki kodu kullanın setup.py dosya. Bu dosya SDK"nızı paketlemek için gereklidir. Örnekteki bilgileri paketiniz ve bağımlılıklarınız için bilgilerle değiştirdiğinizden emin olun.
from setuptools import setup, find_packages setup( name='SellingPartnerAPIAuthAndAuthPython', # Replace with your package's name version='1.0.0', # Replace with your package's version package_dir={'': 'src'}, # Replace 'src' as necessary packages=find_packages(where='src'), install_requires=[line.strip() for line in open("requirements.txt", "r")], description='A Python SDK for Amazon Selling Partner API', long_description=open('README.md').read(), long_description_content_type='text/markdown', url='TBD' )

Python SDK kurulumu ile artık Orders API'sinin bir örneğini oluşturmaya hazırsınız.

Adım 5. Siparişler API'sinin bir örneğini oluşturun ve bir işlemi çağırın

Aşağıda, Python SDK'nın Siparişler API'si ile nasıl kullanılacağına dair bir örnek verilmiştir. getOrders istek. Kodu bilgilerinizle güncelleyin ve ardından kodu terminalinizde çalıştırın.

if __name__ == "__main__": from auth.credentials import SPAPIConfig config = SPAPIConfig( client_id="Your client-id", client_secret="Your client-secret", refresh_token="Your refresh-token", region="NA", # Possible values NA, EU, FE, and SANDBOX scope = None # Required for grant_type='client_credentials' ; Possible values "sellingpartnerapi::notifications" and "sellingpartnerapi::migration" ) from spapi.spapiclient import SPAPIClient # Create the API Client print("Config and client initialized...") api_client = SPAPIClient(config) marketplace_ids = ["ATVPDKIKX0DER"] created_after = "2024-01-19T00:00:00" orders_api = api_client.get_api_client('OrdersV0Api') orders_response = orders_api.get_orders(marketplace_ids=marketplace_ids, created_after=created_after) print("Orders API Response:") print(orders_response)

🚧

Dikkat

Hassas bilgiler içerdiğinden bu dosyayı asla sürüm kontrol sisteminize teslim etmeyin. Bu LWA kimlik bilgilerinin şifreli bir biçimde güvenli bir şekilde saklandığından emin olun.

200 durum kodu, API çağrısının başarılı olduğu anlamına gelir.

Adım 6. Oluşturulan Python SDK'sını kullanarak Satış Ortağı API'sine bağlanın

SDK'nızı yerel olarak oluşturmak ve yüklemek için terminalinizde aşağıdaki komutları çalıştırın:

python3 setup.py sdist bdist_wheel
pip install dist/{YourPackageName}-1.0.0-py3-none-any.whl

Python SDK'yı test etmek için terminalinizde aşağıdaki test komut dosyasını çalıştırın:

python test.py

200 durum kodu, API çağrısının başarılı olduğu anlamına gelir.

Sonuç

Bu eğitimde, Python için bir SP-API SDK'sı kullanarak SP-API çağrılarınızı nasıl otomatikleştireceğinizi öğrendiniz. İzlenecek açıklamada, çalışma alanınızı nasıl kuracağınızı, Satış Ortağı API'si için bir Python SDK'sı oluşturacağınızı, Siparişler API'sine nasıl bağlanacağınızı ve ilk API çağrınızı nasıl yapacağınızı öğrendiniz.


Bu sayfa size yardımcı oldu mu?