Generated by API Evangelist
Written by API Evangelist tooling for Google Ads's API. It is a proposal applied on top of the contract, not a document Google Ads publishes.
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
title: API Evangelist conversational phrasing for Google Ads Customers.data Links API
version: 1.0.0
extends: openapi/google-ads-customers-datalinks-api-openapi.yml
actions:
- target: $.info
update:
x-apievangelist-phrasing:
method: generated
generated: '2026-10-02'
generator: build-phrasing.py
label: Generated by API Evangelist
operations: 3
- target: $.paths['/v25/customers/{customersId}/dataLinks:update'].post
update:
x-apievangelist-phrasing:
intent: Change the status of a data link
effect: write
questions:
- Can I change the status of an existing data link, such as a YouTube video link?
- Which field do I send to update a data link?
instructions:
- text: Set data link {link} in account {customer} to status {status}.
slots:
link: requestBody.resourceName
customer: path.customersId
status: requestBody.dataLinkStatus
- text: Update the status of data link {link} for account {customer}.
slots:
link: requestBody.resourceName
customer: path.customersId
method: generated
generated: '2026-10-02'
- target: $.paths['/v25/customers/{customersId}/dataLinks:create'].post
update:
x-apievangelist-phrasing:
intent: Create a data link with a third party
effect: write
questions:
- How do I link my account to a YouTube creator's videos?
- What account information is shared with the third party when I create a data link?
instructions:
- text: Create data link {link} for account {customer}.
slots:
link: requestBody.dataLink
customer: path.customersId
- text: Link account {customer} to a third party with data link {link}.
slots:
customer: path.customersId
link: requestBody.dataLink
method: generated
generated: '2026-10-02'
- target: $.paths['/v25/customers/{customersId}/dataLinks:remove'].post
update:
x-apievangelist-phrasing:
intent: Remove a data link
effect: destructive
questions:
- Can I disconnect a data link I set up earlier?
- What do I pass to delete a data link?
instructions:
- text: Remove data link {link} from account {customer}.
slots:
link: requestBody.resourceName
customer: path.customersId
- text: Disconnect the data link {link} in account {customer}.
slots:
link: requestBody.resourceName
customer: path.customersId
method: generated
generated: '2026-10-02'
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.