0.4.0 docs





    Jul 10, 2017


    Index of all namespaces

    The README below is fetched from the published project artifact. Some relative links may be broken.


    Clojure library to ease interacting with the Google AdWords API. It is built upon Google’s AdWords API Java Client Library.

    OAuth 2 Authentication

    Google’s APIs are moving towards requiring OAuth 2 authentication. To do this you need to:

    1. Visit and (if necessary create a project).
    2. Click on Credentials in the API & auth menu on the left.
    3. Ceate a new Client ID for a native application. The redirect URI should be: urn:ietf:wg:oauth:2.0:oob
    4. You’ll also need your AdWords API developer token.

    Once you’ve generated all the tokens and keys you can use adworj.credentials namespace to help generate the necessary credentials.

    Ultimately you need to retrieve the refresh token that is provided by the OAuth Credentials. Having retrieved this during the OAuth flow you can either create offline-credentials using the refresh token directly, or, store the refresh token in your

    The easiest way to configure Google’s client library is via a properties file. This should look something like:

    api.adwords.clientId=(from the developer console above)
    api.adwords.clientSecret=(from the developer console above)
    api.adwords.developerToken=(from the adwords console)

    Once you’ve authenticated you can add an entry for the refresh token:

    api.adwords.refreshToken=(from oauth authentication/authorization flow)

    Reporting API

    Having successfully authenticated, and updated the properties file with your configuration, you can run a report as follows:

    (ns reporter
      (:require [adworj.credentials :as ac]
                 [adworj.reporting :as ar]
                 [ :as io]))
    (def client-customer-id "123-456-7890")
    (def credentials        (ac/offline-credentials "./"))
    (def session            (ar/reporting-session "./" credentials
                                                  :client-customer-id client-customer-id
                                                  :include-zero-impressions false))
    (with-open [report (ar/run session ar/paid-and-organic-query "sample report" :range (ar/date-range :last-week))]
      (doseq [record (ar/record-seq report)]
        (println record)))))


    Copyright © 2015 uSwitch Limited.

    Distributed under the Eclipse Public License either version 1.0 or (at your option) any later version.