API-toegang (AdWords)
Zie ook Python.
Het is mogelijk om via een API aan te koppelen bij Google's AdWords-servers, om zo te interacteren met AdWords-campagnes. No you're playing with power. De AdWords API gebruikt SOAP. Bibliotheken zijn beschikbaar voor Java, PHP, Python, .NET, Perl en Ruby. Daarnaast zijn er libraries beschikbaar voor diverse use cases.
Mijn interesse is primair Custom reporting (aka. as Automated reporting). Hier biedt Google oa. dashboard-libraries voor aan.
In zes stappen naar 'Hello, world!'
- Verkrijg een Developer Token
- Maak een test manager- en test client-account aan via je Manager Account
- Configureer je ontwikkelomgeving
- Configureer OAuth2-authenticatie
- Configureer je client-applicatie
- Maak je eerste API-call.
Verkrijg een Developer Token
- Om een Developer Token aan te vragen, heb je een Manager Account nodig
- Aanvraag van het token gaat via het Manager Account:
Gear-menu » Account settings » AdWords API Center
1:47 - In afwachting van de ontvangst van het token, kun je via een testaccount alvast testen ca. 2:00. Dat schijnt sowieso een goed idee te zijn.
Configureer je ontwikkelomgeving
Deze video, vanaf 2:55 (Java + Eclipse)
- Download Eclipse
- Download Maven Client Library voor Java. Deze bevat teven code-voorbeelden
- Importeer de Maven-bibliotheek. Let op eventuele foutmeldingen en mogelijk additionele vereise bibliotheken
- Configureer OAuth2-authenticatie
Download & configureer library
Installeer pip
pip is een tool voor installatie en configuratie van Python packages. Installatie:
sudo apt-get install -y python-pip
Installeer setuptools
pip install -U pip setuptools
Bijwerken pip
Nav. een waarschuwing:
pip install --upgrade pip
Download library
sudo -H pip install googleads
Opmerkingen:
sudo
gebruikt, anders foutmeldingen tav. bijwerken overige bestanden-H
gebruikt, zodat de bestanden van 'mij' zijn, en niet van de superuser, of zoiets.
Configureer authenticatie
Download googleads.yaml
Dit bestand wordt gebruikt om credentials in op te slaan. Download 't bestand vanaf hier en plaats 'm in je werkmap.
OAuth2 configureren
- App-type: Installed app
- Ga naar http://oauth.net/2/
- OAuth consent screen: Application-type: Other (?). Naam: Other client 1
- Maak een nieuw project aan » Create credentials » OAuth client ID » Een OAuth Client-ID & OAuth client secret aangemaakt
Bronnen
Algemeen
- https://developers.google.com/adwords/api/
- http://www.sagerock.com/blog/setting-google-adwords-api-access-first-time/ - Aardige handleiding voor PHP+Windows. Niet erg relevant voor Linux
https://developer-blog.net/en/programming/google-adwords-api-part-1/
Algemeen - Video's
- https://www.youtube.com/watch?v=80KOeuCNc0c - AdWords API DevBytes Episode 1: Why Use the AdWords API?
- https://www.youtube.com/watch?v=yaDlZMfYWkg - AdWords API DevBytes Episode 2: Getting to “Hello, World!”
Libraries
- https://developers.google.com/adwords/api/docs/clientlibraries
- https://github.com/googleads/googleads-python-lib#how-do-i-get-started