Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ianks/awqlinator

Isomorphic AWQL query generator
https://github.com/ianks/awqlinator

adwords awql typescript

Last synced: 5 days ago
JSON representation

Isomorphic AWQL query generator

Awesome Lists containing this project

README

        

[![npm version](https://badge.fury.io/js/awqlinator.svg)](https://badge.fury.io/js/awqlinator)
[![Build Status](https://travis-ci.org/ianks/awqlinator.svg?branch=master)](https://travis-ci.org/ianks/awqlinator)

# AWQLinator

A package for Javascript which makes dealing with AWQL more friendly than
string interpolation. It offers a simple interface for querying Google AdWords.

## How does it look?

```js
import { AWQLinator } from "awqlinator";

const awql = new AWQLinator("ACCOUNT_PERFORMANCE_REPORT");

const report = awql
.select("Clicks", "Impressions")
.where("Clicks", ">", "20")
.during("TODAY")
.toAwql();

// => SELECT Clicks,Impressions FROM ACCOUNT_PERFORMANCE_REPORT WHERE Clicks > 20
```

## Features

1. Strongly typed with Typescript.
2. Compose queries easily
3. Simple and intuitive query API

## What it does not offer

- The ability to actually send the queries to AdWords.

Since this is very simple to do with any request library (`fetch`, `axios`,
etc.), I have decided to leave this as an exercise to the user.

## Installation

`$ npm install --save awqlinator`