Fazer uma chamada de API

O repositório googleads/googleads-shopping-samples (em inglês) no GitHub contém exemplos de código de operações comuns para cada biblioteca de cliente. Por exemplo, as amostras em googleads-shopping-samples/python/shopping/content/products/ fornecem o 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, mostrando a estrutura básica e os componentes necessários dos aplicativos que se integram à API Content. O resultado final será semelhante ao exemplo no arquivo de amostra products/insert.py. Depois, use o APIs Explorer no método products.list para verificar se o produto foi adicionado.

Para fazer a 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 próximas etapas a esse 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. Defina um ID do produto exclusivo 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. Criar uma função que será 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 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 imprimirá a seguinte mensagem no terminal: Product with offerId "offerId" was created.

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

    No 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 à sua conta do Merchant Center.

    Se o produto tiver sido adicionado corretamente, os dados dele vão aparecer na resposta do APIs Explorer.

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 se encontrar conteúdo ou comportamento que viole essas políticas.

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