Add criteria to Google Ads campaign

curl --request POST \
  --url https://api.sapt.ai/projects/{projectId}/google-ads/customers/{customerId}/campaigns/{campaignId}/criteria \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "locations": [
    "<string>"
  ],
  "languages": [
    "<string>"
  ],
  "negativeKeywords": [
    {
      "text": "<string>"
    }
  ],
  "loginCustomerId": "<string>",
  "validateOnly": true
}
'

import requests

url = "https://api.sapt.ai/projects/{projectId}/google-ads/customers/{customerId}/campaigns/{campaignId}/criteria"

payload = {
    "locations": ["<string>"],
    "languages": ["<string>"],
    "negativeKeywords": [{ "text": "<string>" }],
    "loginCustomerId": "<string>",
    "validateOnly": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    locations: ['<string>'],
    languages: ['<string>'],
    negativeKeywords: [{text: '<string>'}],
    loginCustomerId: '<string>',
    validateOnly: true
  })
};

fetch('https://api.sapt.ai/projects/{projectId}/google-ads/customers/{customerId}/campaigns/{campaignId}/criteria', 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://api.sapt.ai/projects/{projectId}/google-ads/customers/{customerId}/campaigns/{campaignId}/criteria",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'locations' => [
        '<string>'
    ],
    'languages' => [
        '<string>'
    ],
    'negativeKeywords' => [
        [
                'text' => '<string>'
        ]
    ],
    'loginCustomerId' => '<string>',
    'validateOnly' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sapt.ai/projects/{projectId}/google-ads/customers/{customerId}/campaigns/{campaignId}/criteria"

	payload := strings.NewReader("{\n  \"locations\": [\n    \"<string>\"\n  ],\n  \"languages\": [\n    \"<string>\"\n  ],\n  \"negativeKeywords\": [\n    {\n      \"text\": \"<string>\"\n    }\n  ],\n  \"loginCustomerId\": \"<string>\",\n  \"validateOnly\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.sapt.ai/projects/{projectId}/google-ads/customers/{customerId}/campaigns/{campaignId}/criteria")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"locations\": [\n    \"<string>\"\n  ],\n  \"languages\": [\n    \"<string>\"\n  ],\n  \"negativeKeywords\": [\n    {\n      \"text\": \"<string>\"\n    }\n  ],\n  \"loginCustomerId\": \"<string>\",\n  \"validateOnly\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sapt.ai/projects/{projectId}/google-ads/customers/{customerId}/campaigns/{campaignId}/criteria")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"locations\": [\n    \"<string>\"\n  ],\n  \"languages\": [\n    \"<string>\"\n  ],\n  \"negativeKeywords\": [\n    {\n      \"text\": \"<string>\"\n    }\n  ],\n  \"loginCustomerId\": \"<string>\",\n  \"validateOnly\": true\n}"

response = http.request(request)
puts response.read_body

{
  "addedCount": 123,
  "resourceNames": [
    "<string>"
  ],
  "validateOnly": true
}

{
  "message": "<string>",
  "code": "<string>"
}

{
  "message": "<string>",
  "code": "<string>"
}

{
  "message": "<string>",
  "code": "<string>"
}

{
  "message": "<string>",
  "code": "<string>"
}

{
  "message": "<string>",
  "code": "<string>"
}

POST

projects

{projectId}

google-ads

customers

{customerId}

campaigns

{campaignId}

criteria

Add criteria to Google Ads campaign

curl --request POST \
  --url https://api.sapt.ai/projects/{projectId}/google-ads/customers/{customerId}/campaigns/{campaignId}/criteria \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "locations": [
    "<string>"
  ],
  "languages": [
    "<string>"
  ],
  "negativeKeywords": [
    {
      "text": "<string>"
    }
  ],
  "loginCustomerId": "<string>",
  "validateOnly": true
}
'

import requests

url = "https://api.sapt.ai/projects/{projectId}/google-ads/customers/{customerId}/campaigns/{campaignId}/criteria"

payload = {
    "locations": ["<string>"],
    "languages": ["<string>"],
    "negativeKeywords": [{ "text": "<string>" }],
    "loginCustomerId": "<string>",
    "validateOnly": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    locations: ['<string>'],
    languages: ['<string>'],
    negativeKeywords: [{text: '<string>'}],
    loginCustomerId: '<string>',
    validateOnly: true
  })
};

fetch('https://api.sapt.ai/projects/{projectId}/google-ads/customers/{customerId}/campaigns/{campaignId}/criteria', 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://api.sapt.ai/projects/{projectId}/google-ads/customers/{customerId}/campaigns/{campaignId}/criteria",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'locations' => [
        '<string>'
    ],
    'languages' => [
        '<string>'
    ],
    'negativeKeywords' => [
        [
                'text' => '<string>'
        ]
    ],
    'loginCustomerId' => '<string>',
    'validateOnly' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sapt.ai/projects/{projectId}/google-ads/customers/{customerId}/campaigns/{campaignId}/criteria"

	payload := strings.NewReader("{\n  \"locations\": [\n    \"<string>\"\n  ],\n  \"languages\": [\n    \"<string>\"\n  ],\n  \"negativeKeywords\": [\n    {\n      \"text\": \"<string>\"\n    }\n  ],\n  \"loginCustomerId\": \"<string>\",\n  \"validateOnly\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.sapt.ai/projects/{projectId}/google-ads/customers/{customerId}/campaigns/{campaignId}/criteria")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"locations\": [\n    \"<string>\"\n  ],\n  \"languages\": [\n    \"<string>\"\n  ],\n  \"negativeKeywords\": [\n    {\n      \"text\": \"<string>\"\n    }\n  ],\n  \"loginCustomerId\": \"<string>\",\n  \"validateOnly\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sapt.ai/projects/{projectId}/google-ads/customers/{customerId}/campaigns/{campaignId}/criteria")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"locations\": [\n    \"<string>\"\n  ],\n  \"languages\": [\n    \"<string>\"\n  ],\n  \"negativeKeywords\": [\n    {\n      \"text\": \"<string>\"\n    }\n  ],\n  \"loginCustomerId\": \"<string>\",\n  \"validateOnly\": true\n}"

response = http.request(request)
puts response.read_body

{
  "addedCount": 123,
  "resourceNames": [
    "<string>"
  ],
  "validateOnly": true
}

{
  "message": "<string>",
  "code": "<string>"
}

{
  "message": "<string>",
  "code": "<string>"
}

{
  "message": "<string>",
  "code": "<string>"
}

{
  "message": "<string>",
  "code": "<string>"
}

{
  "message": "<string>",
  "code": "<string>"
}

Authorizations

Authorization

string

header

required

JWT token obtained from /api/auth/token endpoint. Token is verified using JWKS and must include a valid user identifier.

Path Parameters

projectId

string<uuid>

required

customerId

string

required

Minimum string length: 1

campaignId

string

required

Minimum string length: 1

Body

application/json

locations

string[]

Minimum string length: 1

languages

string[]

Minimum string length: 1

negativeKeywords

object[]

Show child attributes

Minimum string length: 1

validateOnly

boolean

Response

Success

addedCount

number

required

resourceNames

string[]

required

validateOnly

boolean

required

Agents

Auth

CMS

Assets

Memory

Actions

Schedules

Contracts

Emails

Invitations

Projects

Integrations

Conversions

CRM

Calendar

Google Ads

Geo

Workflows

OAuth Clients

Project Roles

Project Templates

Dashboard Sidebar

Service Accounts

Google Analytics

Google Business

Socials

Ads

Team

Users

Web Analytics

Add criteria to Google Ads campaign

Authorizations

Path Parameters

Body

Response