API-toegang (AdWords)

Uit De Vliegende Brigade
Ga naar: navigatie, zoeken

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!'

  1. Verkrijg een Developer Token
  2. Maak een test manager- en test client-account aan via je Manager Account
  3. Configureer je ontwikkelomgeving
  4. Configureer OAuth2-authenticatie
  5. Configureer je client-applicatie
  6. 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 → Ik gebruik Sublime Editor
  • Download Maven Client Library voor Java. Deze bevat teven code-voorbeelden → Overeenkomstige Python-bibliotheek gedownload
  • Importeer de Maven-bibliotheek. Let op eventuele foutmeldingen en mogelijk additionele vereise bibliotheken → Zie hieronder
  • Configureer OAuth2-authenticatie → Zie hieronder.

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

Een mijlpaal: M'n eigen standalone-app wil toegang tot m'n AdWords-account

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-tokens genereren

  • 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
  • generate_refresh_token.py gedownload en in huidige werkmap geplaatst
  • python generate_refresh_token.py --client_id INSERT_CLIENT_ID --client_secret INSERT_CLIENT_SECRET (met uiteraard de juiste id's). Dit genereerde een URL, die vervolgens het authenticatie-scherm hiernaast genereerde. Vervolgens kreeg ik een code terug, die ik weer invoegde in de terminal. Die zei dat alles goed was + ik kreeg een access token en een refresh token

Tokens invoegen in googleads.yaml

Het gaat om deze dingen:

  • developer_token
  • client_id
  • client_secret
  • refresh_token.

Invullen spreekt verder voor zich.

TOT HIER GEKOMEN

Bronnen

Algemeen

https://developer-blog.net/en/programming/google-adwords-api-part-1/

Algemeen - Video's

Libraries

Authenticatie