Fazer uma chamada de API

O repositório googleads/googleads-shopping-samples no GitHub contém um exemplo de código para operações comuns em cada biblioteca de cliente. Por exemplo, as amostras em googleads-shopping-samples/python/shopping/content/products/ fornecem código para operações comuns usando o recurso products com Python. Neste guia, você começa com um arquivo vazio e cria um exemplo que insere um novo produto para que seja possível ver a estrutura básica e os componentes necessários de aplicativos que se integram à API Content. O resultado final será semelhante ao exemplo no arquivo de amostra products/insert.py. Em seguida, use o API Explorer para o método products.list para verificar se o produto foi adicionado.

Para fazer sua primeira chamada, siga estas etapas:

  1. No diretório googleads-shopping-samples/python/shopping/content/products/, crie um arquivo my-insert.py vazio. Adicione todo o código às etapas abaixo para esse arquivo.

  2. Adicione as instruções de importação para os módulos obrigató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. Defina um ID do produto exclusivo e crie um dicionário com a definição do produto.

    No final do arquivo 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. Crie uma função que seja executada quando o script for executado na linha de comando. A função cria um objeto de serviço para interagir com a API Content, recebe o 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 do arquivo 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, acesse googleads-shopping-samples/python/ em uma janela de terminal e execute:

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

    Se a chamada for bem-sucedida, o serviço vai mostrar a seguinte mensagem no terminal: Product with helpId "offerId" was created.

  6. Para verificar se o produto foi adicionado, use o API Explorer do método products.list para retornar todos os produtos em sua conta do Merchant Center.

    No API Explorer para o método products.list, insira os seguintes valores:

    1. Insira o merchantId.
    1. Na seção Credenciais, selecione Google OAuth 2.0 e Chave de API.
    2. Clique no botão Executar.
    3. Se solicitado, faça login com a Conta do Google associada à sua conta do Merchant Center.

    Se o produto tiver sido adicionado, os dados do produto vão aparecer na resposta do explorador de API.

Os comerciantes são responsáveis por obedecer às políticas de anúncios do Shopping e de listagens sem custo financeiro. O Google Shopping se reserva o direito de aplicar essas políticas e responder adequadamente caso encontremos conteúdo ou comportamento que viole essas políticas.