Attach campaign assets

curl --request POST \
  --url https://api.aisa.one/apis/v1/ads/campaigns/{campaignId}/assets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

import requests

url = "https://api.aisa.one/apis/v1/ads/campaigns/{campaignId}/assets"

payload = {}
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({})
};

fetch('https://api.aisa.one/apis/v1/ads/campaigns/{campaignId}/assets', 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.aisa.one/apis/v1/ads/campaigns/{campaignId}/assets",
  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([
    
  ]),
  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.aisa.one/apis/v1/ads/campaigns/{campaignId}/assets"

	payload := strings.NewReader("{}")

	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.aisa.one/apis/v1/ads/campaigns/{campaignId}/assets")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/ads/campaigns/{campaignId}/assets")

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 = "{}"

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

{
  "calloutAssetResourceNames": [
    "<string>"
  ],
  "campaignId": "<string>",
  "imageAssetResourceNames": [
    "<string>"
  ],
  "sitelinkAssetResourceNames": [
    "<string>"
  ],
  "structuredSnippetAssetResourceNames": [
    "<string>"
  ]
}

{
  "error": {
    "code": "<string>",
    "details": {},
    "message": "<string>",
    "param": "<string>",
    "retryHint": "<string>",
    "retryable": true,
    "type": "<string>"
  }
}

AIsa Ads

Attach campaign assets

Ad Campaigns. Changes the ad account without starting or raising spend; audited. Adds sitelinks, callouts, structured snippets and images to a Google campaign in one step. Creates and attaches sitelinks, callouts, structured snippets and image assets in one Google mutation. Google shows images only on accounts it deems eligible (account age, policy history, vertical).  A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ.

POST

https://api.aisa.one

apis

ads

campaigns

{campaignId}

assets

Attach campaign assets

curl --request POST \
  --url https://api.aisa.one/apis/v1/ads/campaigns/{campaignId}/assets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

import requests

url = "https://api.aisa.one/apis/v1/ads/campaigns/{campaignId}/assets"

payload = {}
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({})
};

fetch('https://api.aisa.one/apis/v1/ads/campaigns/{campaignId}/assets', 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.aisa.one/apis/v1/ads/campaigns/{campaignId}/assets",
  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([
    
  ]),
  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.aisa.one/apis/v1/ads/campaigns/{campaignId}/assets"

	payload := strings.NewReader("{}")

	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.aisa.one/apis/v1/ads/campaigns/{campaignId}/assets")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/ads/campaigns/{campaignId}/assets")

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 = "{}"

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

{
  "calloutAssetResourceNames": [
    "<string>"
  ],
  "campaignId": "<string>",
  "imageAssetResourceNames": [
    "<string>"
  ],
  "sitelinkAssetResourceNames": [
    "<string>"
  ],
  "structuredSnippetAssetResourceNames": [
    "<string>"
  ]
}

{
  "error": {
    "code": "<string>",
    "details": {},
    "message": "<string>",
    "param": "<string>",
    "retryHint": "<string>",
    "retryable": true,
    "type": "<string>"
  }
}

Request contract

Method and path: POST /apis/v1/ads/campaigns/{campaignId}/assets
Availability: enabled
Request URL template: https://api.aisa.one/apis/v1/ads/campaigns/{campaignId}/assets
campaignId: path; required
connectionId: query; required
Runtime facts: fe60122939c67dc98a3a6ac6b97bd5c326b526105150c8959304dd2160d4dd09

Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

{
  "operationId": "post_aisa_ads_apis_v1_ads_campaigns_campaignid_assets",
  "method": "POST",
  "path": "/apis/v1/ads/campaigns/{campaignId}/assets",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [
    {
      "description": "Numeric Google platform id.",
      "in": "path",
      "name": "campaignId",
      "required": true,
      "schema": {
        "pattern": "^\\d+$",
        "type": "string"
      }
    },
    {
      "description": "The ads connection (adc_...) the request runs on: one of yours, from GET /apis/v1/ads/connections. On a request with a JSON body it may be sent as a top-level body member instead.",
      "in": "query",
      "name": "connectionId",
      "required": true,
      "schema": {
        "pattern": "^adc_[0-9A-Za-z]+$",
        "type": "string"
      }
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "example": {
          "adAccountId": "1234567890",
          "callouts": [
            "Fast setup"
          ],
          "connectionId": "adc_7f3k2m9q",
          "sitelinks": [
            {
              "linkUrl": "https://example.com/landing",
              "text": "Pricing"
            },
            {
              "linkUrl": "https://example.com/landing",
              "text": "Documentation"
            }
          ],
          "structuredSnippets": [
            {
              "header": "Types",
              "values": [
                "Scheduling",
                "Analytics",
                "Messaging"
              ]
            }
          ]
        },
        "schema": {
          "additionalProperties": true,
          "description": "Provide at least one of sitelinks, callouts, structuredSnippets or images. Sitelink description1 and description2 must be supplied together.",
          "properties": {
            "adAccountId": {
              "description": "Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple customers.",
              "pattern": "^\\d+$",
              "type": "string"
            },
            "callouts": {
              "items": {
                "maxLength": 25,
                "minLength": 1,
                "type": "string"
              },
              "maxItems": 20,
              "minItems": 1,
              "type": "array"
            },
            "connectionId": {
              "description": "The ads connection (adc_...), when not sent as the connectionId query parameter.",
              "pattern": "^adc_[0-9A-Za-z]+$",
              "type": "string"
            },
            "customerId": {
              "description": "Alias of adAccountId, kept for existing callers",
              "pattern": "^\\d+$",
              "type": "string"
            },
            "images": {
              "description": "Public image URLs, uploaded to Google as image assets. Landscape 1.91:1 (min 600x314) or square 1:1 (min 300x300), up to 5 MB each.",
              "items": {
                "format": "uri",
                "type": "string"
              },
              "maxItems": 20,
              "minItems": 1,
              "type": "array"
            },
            "sitelinks": {
              "items": {
                "properties": {
                  "description1": {
                    "maxLength": 35,
                    "minLength": 1,
                    "type": "string"
                  },
                  "description2": {
                    "maxLength": 35,
                    "minLength": 1,
                    "type": "string"
                  },
                  "linkUrl": {
                    "format": "uri",
                    "type": "string"
                  },
                  "text": {
                    "maxLength": 25,
                    "minLength": 1,
                    "type": "string"
                  }
                },
                "required": [
                  "linkUrl",
                  "text"
                ],
                "type": "object"
              },
              "maxItems": 20,
              "minItems": 2,
              "type": "array"
            },
            "structuredSnippets": {
              "items": {
                "properties": {
                  "header": {
                    "enum": [
                      "Amenities",
                      "Brands",
                      "Courses",
                      "Degree programs",
                      "Destinations",
                      "Featured hotels",
                      "Insurance coverage",
                      "Models",
                      "Neighborhoods",
                      "Service catalog",
                      "Shows",
                      "Styles",
                      "Types"
                    ],
                    "type": "string"
                  },
                  "values": {
                    "items": {
                      "maxLength": 25,
                      "minLength": 1,
                      "type": "string"
                    },
                    "maxItems": 10,
                    "minItems": 3,
                    "type": "array"
                  }
                },
                "required": [
                  "header",
                  "values"
                ],
                "type": "object"
              },
              "maxItems": 20,
              "minItems": 1,
              "type": "array"
            }
          },
          "type": "object"
        }
      }
    },
    "required": true
  },
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "description": "Ads operations are free. Ad spend is billed by the ad platform to the connected ad account, never by AIsa.",
    "kind": "no_customer_charge"
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

Cost and request rules

A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

campaignId

string

required

Numeric Google platform id.

Pattern: ^\d+$

Query Parameters

connectionId

string

required

The ads connection (adc_...) the request runs on: one of yours, from GET /apis/v1/ads/connections. On a request with a JSON body it may be sent as a top-level body member instead.

Pattern: ^adc_[0-9A-Za-z]+$

Body

application/json

Provide at least one of sitelinks, callouts, structuredSnippets or images. Sitelink description1 and description2 must be supplied together.

adAccountId

string

Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple customers.

Pattern: ^\d+$

callouts

string[]

Required array length: 1 - 20 elements

Required string length: 1 - 25

connectionId

string

The ads connection (adc_...), when not sent as the connectionId query parameter.

Pattern: ^adc_[0-9A-Za-z]+$

customerId

string

Alias of adAccountId, kept for existing callers

Pattern: ^\d+$

images

string<uri>[]

Public image URLs, uploaded to Google as image assets. Landscape 1.91:1 (min 600x314) or square 1:1 (min 300x300), up to 5 MB each.

Required array length: 1 - 20 elements

sitelinks

object[]

Required array length: 2 - 20 elements

Show child attributes

structuredSnippets

object[]

Required array length: 1 - 20 elements

Show child attributes

Response

Assets created and attached.

calloutAssetResourceNames

string[]

campaignId

string

imageAssetResourceNames

string[]

sitelinkAssetResourceNames

string[]

structuredSnippetAssetResourceNames

string[]

​Request contract

​Cost and request rules

Authorizations

Path Parameters

Query Parameters

Body

Response

Request contract

Cost and request rules