Fazer uma chamada de API

O repositório googleads/googleads-shopping-samples no GitHub contém exemplos de código para operações comuns de 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 você possa 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 APIs Explorer para o método products.list e verifique se o produto foi adicionado corretamente.

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 das etapas a seguir a esse arquivo.

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

   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. 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 a executa 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 fazer a chamada de API, em uma janela de terminal, navegue até googleads-shopping-samples/python/ e execute:

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

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

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

   No API 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 necessário, faça login com a Conta do Google associada à sua conta do Merchant Center.

   Se o produto foi adicionado, os dados dele vão aparecer na resposta do explorador de APIs.

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