Google Ads

Add structured snippet extensions

Creates a structured snippet asset — a fixed header such as "Types" or "Brands" followed by 3–10 values — and links it to the account, a campaign or an ad group. Use when: the user has a list that genuinely fits one of Google's headers. Do not use when: no header fits. Google only accepts its own header list (Amenities, Brands, Courses, Degree programs, Destinations, Featured hotels, Insurance coverage, Models, Neighborhoods, Service catalog, Shows, Styles, Types); inventing one fails. Callouts are the right tool for free-form selling points. The header must be Google's exact translation for the language of the ads. Pass header in English and, when the ads are not in English, language as Google's locale code (for example "de", "fr", "ja", "pt-BR", "zh-TW"): the tool sends Google's translated header, and refuses a header Google has not translated for that locale. When language is left out the header is sent in English and the preview warns if the campaign targets other languages. If you do not know the language of the ads, ask. Each value is 25 characters or fewer (12 in Chinese, Japanese or Korean) and at least three values are required. An identical header+values snippet already linked at the same level is skipped. 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_structured_snippets/execute

Request

  • Base URL: https://adako.ai
  • URL: https://adako.ai/api/v1/tools/google_add_structured_snippets/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.