# 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'