Fazer uma chamada de API

A expressão googleads/googleads-shopping-samples no GitHub, contém exemplos de código de operações comuns para cada cliente biblioteca. Por exemplo, as amostras googleads-shopping-samples/python/shopping/content/products/ fornecem o código para operações comuns usando o products com Python. Neste guia, você começa com um arquivo vazio e cria um exemplo que insere um novo produto, para que você possa ver o básico e os componentes necessários dos aplicativos que se integram API Content. O resultado final será semelhante ao exemplo da products/insert.py. Em seguida, use o APIs Explorer (em inglês) do método products.list para verificar se o produto foi adicionado.

Para fazer a primeira chamada, siga estas etapas:

  1. Na caixa googleads-shopping-samples/python/shopping/content/products/ crie um arquivo my-insert.py vazio. Adicione todo o código no etapas a seguir para este arquivo.

  2. Adicione as instruções de importação dos módulos necessários.

    No início de my-insert.py, adicione o seguinte código:

    from __future__ import print_function
    import sys

    # The common module provides setup functionality used by the samples,
    # such as authentication and unique id generation.
    from shopping.content import common

  3. Definir um ID do produto exclusivo e criar um dicionário com o produto definição.

    No final de my-insert.py, adicione o seguinte código:

    offer_id = 'book#%s' % common.get_unique_id()
    product     = {
             'offerId':
             offer_id    ,
             'title':
                 'A Tale of Two Cities',
             'description':
                 'A classic novel about the French Revolution',
             'link':
                 'http://my-book-shop.com/tale-of-two-cities.html',
             'imageLink':
                 'http://my-book-shop.com/tale-of-two-cities.jpg',
             'contentLanguage':
                 'en',
             'targetCountry':
                 'US',
             'channel':
                 'online',
             'availability':
                 'in stock',
             'condition':
                 'new',
             'googleProductCategory':
                 'Media > Books',
             'gtin':
                 '9780007350896',
             'price': {
                 'value': '2.50',
                 'currency': 'USD'
             },
             'shipping': [{
                 'country': 'US',
                 'service': 'Standard shipping',
                 'price': {
                     'value': '0.99',
                     'currency': 'USD'
                 }
             }],
             'shippingWeight': {
                 'value': '200',
                 'unit': 'grams'
             }
    }

  4. Criar uma função que será executada quando o script for executado na linha de comando. A constrói um objeto de serviço para interagir com a API Content, recebe a ID do comerciante do arquivo de configuração, cria a solicitação e executa a solicitação para fazer a chamada de API.

    No final de my-insert.py, adicione o seguinte código:

    def main(argv):
          # Construct the service object to interact with the Content API.
      service    , config, _ = common.init(argv, __doc__)

          # Get the merchant ID from merchant-info.json.
      merchant_id     = config['merchantId']

          # Create the request with the merchant ID and product object.
      request     = service.products().insert(merchantId=merchant_id, body=product)

          # Execute the request and print the result.
      result     = request.execute()
          print('Product with offerId "%s" was created.' % (result['offerId']))

    # Allow the function to be called with arguments passed from the command line.
    if __name__ == '__main__':
      main    (sys.argv)

  5. Para executar o script e a chamada de API, em uma janela de terminal, navegue em googleads-shopping-samples/python/ e execute:

    python -m shopping.content.products.my-insert

    Se a chamada for bem-sucedida, o serviço imprimirá a seguinte mensagem no terminal: Produto com o ID da oferta "offerId" foi criado.

  6. Para verificar se o produto foi adicionado, use o APIs Explorer para o método products.list para retornar todos os produtos do seu Merchant Center do Compute Engine.

    Na APIs Explorer para o método products.list, insira os seguintes valores:

    1. Insira seu merchantId.
    .
    1. Na seção Credenciais, selecione Google OAuth 2.0 e Chave de API.
    2. Clique em Execute.
    3. Se solicitado, faça login com a Conta do Google associada ao seu comerciante do Merchant Center.

    Se o produto for adicionado, os dados dele vão aparecer na API resposta do explorador.

Os comerciantes são responsáveis por obedecer à Política de preços anúncios e sem custo financeiro de fichas de empresas. Google O Shopping se reserva o direito de aplicar essas políticas e responder de maneira adequada. se encontrarmos conteúdo ou comportamento que viole essas políticas.

Anterior
Configurar uma biblioteca de cliente
Próxima
Conhecer a API Content