Programação e script

Introdução à API do eBay com Python A API de negociação - Parte 3

Introdução à API do eBay com Python A API de negociação - Parte 3

Este é o terceiro artigo da série dedicado às APIs do eBay e seu uso via Python. No primeiro artigo, vimos como configurar nosso ambiente de trabalho, criando um desenvolvedor e uma conta de "teste" de sandbox, gerando nossas chaves da API e instalando o Python SDK.

No segundo artigo, abordamos o Encontrando API, focando no FindItemsByKeywords chamar. Neste artigo, apresentaremos o API de negociação.

Neste tutorial, você aprenderá:

  • Quais são algumas das chamadas mais úteis de "negociação" de negociação
  • Como criar um item usando o Adicionar Item Chamada da API
Introdução à API do eBay com Python: The Trading API - Parte 3

Requisitos de software e convenções usadas

Requisitos de software e convenções de linha de comando Linux
Categoria Requisitos, convenções ou versão de software usada
Sistema Sistema Operacional Agnóstico.
Programas Git e Python3
Outro Conhecimento da linguagem de programação python e dos conceitos básicos orientados a objetos.
Convenções # - requer que os comandos Linux sejam executados com privilégios root diretamente como usuário root ou por uso de sudo comando
$ - Requer que os comandos do Linux sejam executados como um usuário não privilegiado regular

A API de negociação

O API de negociação é o assunto deste terceiro artigo nesta série dedicada ao Python e às APIs do eBay. Esta API específica inclui muitas chamadas muito úteis: usando, podemos, entre outras coisas, criar ou financiar itens e recuperar informações sobre categorias, lojas ou vendedores.

As chamadas de API de negociação

A lista do disponível API de negociação As chamadas são muito longas para serem apresentadas aqui na íntegra, no entanto, aqui apresentamos alguns deles e o objetivo que podemos alcançar com o uso deles:

  • Additem - usando esta chamada, podemos começar a vender um item com preço fixo ou com um leilão
  • AddTowatchList - Ao usar esta chamada, podemos adicionar um ou mais itens à nossa lista de observação
  • Enditem - Com esta chamada, podemos parar de vender um artigo antes da data de vencimento do conjunto
  • GetCategories - use esta chamada para obter informações sobre as categorias do eBay para um site específico
  • GetMyebaySellEarling - Recupere informações sobre nossa atividade de venda
  • Getstore - Recupere informações sobre uma loja ebay específica

A maneira como usamos essas chamadas é a mesma que vimos no artigo anterior: criamos e enviamos uma solicitação junto com o nome da chamada. Para encontrar a lista completa das chamadas disponíveis, leia o
documentação oficial.

Gerando um token

Antes de prosseguir, verifique se você criou um usuário de "teste" de Sandbox e seguiu as etapas incluídas no primeiro artigo desta série. Dentro da raiz do nosso projeto, usamos o eBay.Yaml arquivo para armazenar nossas credenciais para os vários domínios. Para usar o API de negociação, e interagir com o usuário do "teste" da caixa de areia, devemos fornecer nosso ID do aplicativo, Dev id, Cert ID e um token que agora geraremos.

Obter um token é muito fácil. Acesse o site do Programa de Desenvolvedores do eBay e navegue até a página das chaves do aplicativo; Aqui, na seção da caixa de areia (lado esquerdo), dentro do ID do aplicativo campo, clique no Tokens de usuário link. Você será redirecionado para esta seção:

Entrar no eBay Sandbox

Clique no botão azul "Entrar no Sandbox" e você será enviado para a página de login do site Sandbox. Aqui você deve usar o usuário do Sandbox "Teste" que você criou anteriormente. Depois de efetuar login com sucesso, você solicitou a confirmar que deseja conceder acesso aos dados da sua conta:

Acesso ao pedido de concessão

Clique no botão "Concordo" e você será redirecionado de volta para a página de geração de token. Aqui você verá o novo token gerado:

Recuperar um novo token gerado pela API do eBay

O próximo passo é copiar o token e as outras credenciais dentro do eBay.Yaml arquivo, na seção correspondente, assim como na figura abaixo:

eBay.Yaml Configuração com token gerado pelo eBay recém -

Tudo está no lugar, vamos criar nosso item!

Criando um item com a chamada da API additem

Dentro da raiz do nosso projeto, vamos criar um novo script e chamá -lo adicionar Item.py. Dentro dele, escreveremos o código necessário para criar nosso primeiro item. Supondo que queremos vender um teclado mecânico, aqui está o código que poderíamos escrever:

#!/usr/bin/Env python3 de ebaysdk.Negociação de importação de importação se __name__ == '__main__': api = conexão (config_file = "ebay.yaml ", domain =" API.caixa de areia.eBay.com ", DEBUG = true) solicitação = " item ": " title ":" teclado mecânico profissional "," country ":" nós "," localização ":" it "," site ":" nós "," CondicionId ":" 1000 "," PaymentMethods ":" PayPal "," PayPalemailAddress ":" ningué[email protected] "," PrimarCategory ": " categoryId ":" 33963 "," Descrição ":" Um teclado mecânico muito bom!"," ListingDuration ":" Days_10 "," StartPrice ":" 150 "," Moeda ":" USD "," ReturnPolicy ": " ReturnSacceptOption ":" ReturnSaccepted "," Referência ":" Moneyback "," ReturnSwinOption " : "Days_30", "Descrição": "Se você não estiver satisfeito, devolva o teclado."," ShippingCostPaidByoption ":" Buyer "," ShippingDetails ": " ShippingServiceOptions ": " FreShipping ":" True "," ShippingService ":" USPSMedia "," DispatchTimemAx ":" 3 " API",.execute ("additem", solicitação)
cópia de

Vamos dar uma olhada no código acima. Como primeira coisa, importamos o Conexão classe do Ebaysdk.negociação módulo. Nós, a biblioteca necessária, criamos uma nova instância do Conexão Classe: em seu construtor, especificamos a localização do arquivo de configuração, assim como fizemos para a API de busca e também o domínio a ser usado para a solicitação, que neste caso é API.caixa de areia.eBay.com.

Fazendo isso declaramos que nosso pedido irá
ser enviado para o site de sandbox: nossas credenciais serão pesquisadas no arquivo de configuração, dependendo deste domínio. Por fim, permitimos o modo de depuração: isso é muito útil ao fazer uma solicitação complexa, porque possíveis erros serão detectados imediatamente.

O próximo passo foi a criação do pedido e a descrição de nosso Item na forma de um simples dicionário de Python. Vamos ver brevemente as várias propriedades que usamos.

Localização e informação do país

Usando o Título Opção, especificamos o título de nossa listagem: ao vender um item no eBay, encontrar um bom título é muito importante. Com País Declaramos o país do endereço de registro do vendedor: este valor consiste em dois dígitos; Você pode consultar esta lista para encontrar todos os valores possíveis aplicáveis.

A próxima chave que usamos é Localização: Isso é necessário para especificar a localização geográfica do item, neste caso a Itália.

Com Site, Em vez disso, especificamos o site do eBay no qual o item deve aparecer. Este parâmetro afeta outros, como, por exemplo, os identificadores das categorias disponíveis, pois a mesma categoria pode ter IDs diferentes nos sites diferentes. Este valor deve ser consistente com o site especificado no construtor do Conexão classe (o padrão é "ebay-us").

Declarando as condições do item

Outra coisa importante a definir é a condição do artigo. Um artigo pode ser novo ou usado, por exemplo, e alguns artigos específicos têm condição dedicada que pode ser usada, dependendo de sua categoria. Nesse caso, usamos "1000" qual é o código que corresponde ao status "novo". Uma tabela dos códigos disponíveis pode ser encontrada aqui.

Definindo um método de pagamento

O método de pagamento que estamos dispostos a aceitar pode ser escolhido na lista de todos os métodos de pagamento disponíveis. Nesse caso, usamos "PayPal" e também fornecemos o endereço de email a ser usado para o pagamento, respectivamente usando o Métodos de Pagamento e Endereço de email do Paypal chaves.

Escolhendo uma categoria para o item

O próximo passo foi definir uma categoria para o item que estamos vendendo: fizemos isso usando o Categoria primária chave, que corresponde a um dicionário no qual o ID da categoria real é identificado pelo Categoria ID chave. Cada categoria é identificada por um ID exclusivo no contexto de um site específico, mas os identificadores podem ser diferentes nos vários sites do eBay. Encontrar a categoria certa pode ser uma tarefa tediosa. Para encontrar o apropriado, você pode usar chamadas específicas como GetsGergestestedCategorias ou você pode consultar ferramentas on -line como esta.

Outra coisa importante a perceber é que, ao escolher uma categoria para um item, o eBay espera que você use um dos últimos segmentos de uma árvore de categoria (uma categoria "folha"): você não pode usar um genérico. Nesse caso, usamos 33963 que corresponde a Teclados e teclados e é um dos últimos segmentos do Computadores/tablets e redes categoria, seu caminho completo sendo computadores/tablets e redes> teclados, ratos e ponteiros> teclados e teclados.

Definindo a descrição e o preço do item

A descrição é outro campo muito importante: isso nos permite descrever o item com um nível mais alto de detalhes. Não nos limitamos ao texto simples aqui, também podemos usar o código HTML e CSS básico, mas não podemos usar o conteúdo ativo; portanto, o uso de JavaScript, por exemplo, é proibido. Se o caso queremos fornecer tags HTML e aproveitar esse recurso, devemos usar CDATA Sintaxe específica ao usar o Python SDK:

"Descrição": ""

Com ListingDuration Especificamos o intervalo de tempo em que a listagem deve permanecer ativa. O eBay usa uma lista de tipos de código a serem usados ​​neste campo (alguns tipos têm um uso restrito). Nesse caso, usamos "Days_10" que especificam uma duração de 10 dias.

O valor que fornecemos StartPRICE é interpretado de maneira diferente, dependendo do tipo de listagem: se for um leilão, esse é considerado o preço inicial do leilão; Se for uma listagem de preço fixo, é considerado o preço constante que o cliente deve pagar para comprar o item. Nossos custos do teclado 150 unidade da moeda com a qual especificamos Moeda. O valor a ser usado aqui deve ser escolhido na lista de moedas disponíveis.

Estabelecendo uma política de retorno

A próxima seção que definimos foi o Política de devolução Seção que descreve nossa política sobre devoluções. Esta seção é definida como um próprio dicionário, dentro do qual usamos as seguintes teclas:

ReturnACeceptEdOption define se o vendedor aceita devoluções ou não: valores aplicáveis ​​são Retorno aceito ou Retorna não aceita.

Reembolso define como os vendedores reembols Moneyback, Enquanto estiver no mercado dos EUA, ele também pode ser definido como MoneyBackRorReplacement.

O ReturnSwithinOption O parâmetro é bastante auto -explicativo: com este parâmetro, especificamos a quantidade de tempo da entrega que o comprador precisa devolver o item de volta. A lista dos valores utilizáveis ​​nesta seção está disponível nesta página. Nesse caso, usamos "Days_30": Um tempo de 30 dias deve ser usado para se qualificar como uma listagem "com melhor classificação".

O Descrição O campo contém uma explicação detalhada da política de devolução do vendedor e sua exibição na seção relativa da página "Exibir item". Uma mensagem amigável é geralmente fornecida aqui.

Com o ShippingCost PaidByOption Parâmetro É possível declarar quem, entre o vendedor e o comprador, deve pagar as despesas de remessa de retorno; Os valores aceitos são Vendedor ou Comprador.

Detalhes de envio

Outra seção muito importante a ser definida é aquela sobre a política de envio e os custos: isso pode ser feito usando o ShippingServiceOption chave. Esta chave está associada a um dicionário no qual podemos definir vários parâmetros. Nesse caso, estabelecemos uma política de frete grátis, usando o Frete grátis chave, e fornecendo Verdadeiro (string) como o valor, e definimos o serviço de remessa com Serviço de entrega. Consulte esta lista para obter uma visão geral completa dos possíveis valores a serem usados ​​aqui.

Finalmente, usamos o DispatchTimemax opção, que basicamente define o número máximo de dias úteis que um vendedor declara será usado para preparar o frete depois de receber um pagamento.

Enviando nossa solicitação e verifique o resultado

Preparamos nossa solicitação e fornecemos as informações necessárias sobre o item que queremos vender; agora podemos enviar nossa solicitação usando o executar método, fornecendo, assim como fizemos para o Encontrando API, o nome da chamada, Adicionar Item como seu primeiro argumento e o dicionário de solicitação como o segundo. Se tudo correr bem depois que a solicitação for enviada, o item deve estar presente no site da Sandbox. Então é:

Item criado usando a API do eBay e Python

Conclusões

Neste artigo, abordamos o API de negociação. Entre as muitas chamadas disponíveis, focamos no Adicionar Item um. Criamos um item que fornece os campos necessários para uma configuração básica e enviamos nossa solicitação com sucesso para nossa conta de sandbox. No próximo artigo desta série, falaremos sobre o API de merchandising.

Tabela de conteúdo

  • Parte 0

    Introdução

  • Parte I

    Obtendo chaves e acesso à caixa de areia

  • PARTE II

    A API de descoberta

  • Parte III

    A API de negociação

  • Parte IV

    A API de merchandising

Tutoriais do Linux relacionados:

  • Como rastrear chamadas de sistema feitas por um processo com Strace em…
  • Como criar um pacote Flatpak
  • Uma introdução à automação, ferramentas e técnicas do Linux
  • Coisas para instalar no Ubuntu 20.04
  • Mastering Bash Script Loops
  • Mint 20: Melhor que o Ubuntu e o Microsoft Windows?
  • Tutorial de depuração do GDB para iniciantes
  • Sistema Linux Hung? Como escapar para a linha de comando e…
  • Coisas para fazer depois de instalar o Ubuntu 20.04 fossa focal linux
  • Como usar o ADB Android Debug Bridge para gerenciar seu Android…