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:
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.
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
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' } }
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)
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.
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:- Insira o
merchantId
.
- Na seção Credenciais, selecione Google OAuth 2.0 e Chave de API.
- Clique no botão Executar.
- 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.
- Insira o
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.