Google Ads

Add search themes to an asset group

Adds search themes to a Performance Max asset group. A search theme is a phrase telling Google what customers look for; it is a hint, not a keyword, and Google may serve on plenty of queries you never listed. Use when: the campaign is new and has nothing to learn from, or the user knows terms the ads should cover. Do not use when: the user expects keyword-level control. Performance Max has none, and search themes do not add any. Say so rather than implying otherwise. An asset group holds at most 25 themes; the tool refuses if the addition would go over, and themes that are already there are skipped rather than duplicated. If you are unsure which account, campaign or period the user means, ask them — do not guess ids or dates.

post/api/v1/tools/google_add_search_themes/execute

Request

  • Base URL: https://adako.ai
  • URL: https://adako.ai/api/v1/tools/google_add_search_themes/execute
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Optional 8-128 character key. A successful envelope is cached for 24 hours; replaying the key with the same arguments returns it again with Idempotent-Replayed: true, and replaying it with different arguments answers 409.

Request body

Response

The tool ran. A write returns proposal_id and approve_url while the change waits for approval.

successunknown required
toolstring required
dataobject required

Machine-readable result.

markdownstring required

The same result written for a person or a model.

proposal_idstring

Present for writes. Nothing changes on the ad platform until it is approved.

approve_urlstring

Where a person approves the proposal.

request_idstring required

Changes

No recorded changes to this operation across all 1 revision of this API.