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