curl --request GET \
--url https://app.base44.com/api/apps/{app_id}/google-ads/incentives \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.base44.com/api/apps/{app_id}/google-ads/incentives"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.base44.com/api/apps/{app_id}/google-ads/incentives', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/google-ads/incentives",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.base44.com/api/apps/{app_id}/google-ads/incentives"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.base44.com/api/apps/{app_id}/google-ads/incentives")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.base44.com/api/apps/{app_id}/google-ads/incentives")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"id": "1234567",
"code": "SELECTED:1234567:USD",
"currency_code": "USD",
"approximate": false,
"reward_amount_micros": 500000000,
"required_min_spend_micros": 500000000,
"terms_url": "https://ads.google.com/intl/en/home/terms-and-conditions/incentives/"
}
]List Google Ads incentives
Returns the promotional offers Google Ads has for the app’s account. Each one grants ad credit once the account’s spend reaches a set amount.
The offers are personal to you. Google picks them from your email address, so another member of the workspace can see different ones.
Pass account_id once the app has a Google Ads account, so the offers are quoted in its currency. Before then, leave it out and the offers are quoted in the currency a new account would be created in, which depends on where the request comes from. If the account ends up in a different currency, applying an offer read that way is rejected.
An empty list is a normal answer. It comes back when the account already holds an incentive, when incentives aren’t offered in the account’s currency, which today means anything other than USD or ILS, and when Google has nothing for you.
Take an offer with Apply a Google Ads incentive.
curl --request GET \
--url https://app.base44.com/api/apps/{app_id}/google-ads/incentives \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.base44.com/api/apps/{app_id}/google-ads/incentives"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.base44.com/api/apps/{app_id}/google-ads/incentives', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/google-ads/incentives",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.base44.com/api/apps/{app_id}/google-ads/incentives"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.base44.com/api/apps/{app_id}/google-ads/incentives")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.base44.com/api/apps/{app_id}/google-ads/incentives")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"id": "1234567",
"code": "SELECTED:1234567:USD",
"currency_code": "USD",
"approximate": false,
"reward_amount_micros": 500000000,
"required_min_spend_micros": 500000000,
"terms_url": "https://ads.google.com/intl/en/home/terms-and-conditions/incentives/"
}
]Authorizations
Personal access token, sent as Authorization: Bearer <token>.
Path Parameters
ID of the app whose Google Ads campaigns to manage.
Query Parameters
ID of the app's Google Ads account, as returned in id by Get Google Ads account. Leave it out before the app has an account. Defaults to empty, which quotes the offers for a new account.
Response
The offers you can apply, or an empty list when there are none.
Google's ID for the offer.
"1234567"
Token to send as coupon_code to Apply a Google Ads incentive. Treat it as opaque. It's bound to the currency the offer was quoted in.
"SELECTED:1234567:USD"
Currency of reward_amount_micros and required_min_spend_micros, as an ISO 4217 code. It's the account's currency, or the currency a new account would be created in when you left out account_id.
"USD"
Whether the amounts were converted from the currency Google quoted the offer in (true) or are Google's own figures (false). Google converts again at its own rate when it grants the reward, so a converted amount can differ slightly from the credit granted.
false
Ad credit Google grants once the spend requirement is met, in micros of currency_code, so 500000000 is 500.00.
500000000
Ad spend the account has to reach to earn the reward, in micros of currency_code.
500000000
Google's terms and conditions for the offer. Empty when Google didn't return a link.
"https://ads.google.com/intl/en/home/terms-and-conditions/incentives/"
Was this page helpful?