# 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.recommendations API
  version: 1.0.0
extends: openapi/google-ads-customers-recommendations-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}/recommendations:apply'].post
  update:
    x-apievangelist-phrasing:
      intent: Apply recommendations
      effect: write
      questions:
      - How do I accept the optimization recommendations for my account?
      - Can I apply several recommendations at once and let some fail?
      instructions:
      - text: Apply recommendations {operations} in account {customer}.
        slots:
          operations: requestBody.operations
          customer: path.customersId
      - text: Accept the listed recommendations {operations} for account {customer}, allowing partial failure.
        slots:
          operations: requestBody.operations
          customer: path.customersId
      method: generated
      generated: '2026-10-02'
- target: $.paths['/v25/customers/{customersId}/recommendations:generate'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate recommendations for a campaign setup
      effect: read
      questions:
      - What recommendations would I get for a campaign I haven't launched yet?
      - Can I ask only for certain recommendation types, like keyword or budget?
      - Which settings, such as country or bidding info, shape generated recommendations?
      instructions:
      - text: Generate recommendations of types {types} for account {customer}.
        slots:
          types: requestBody.recommendationTypes
          customer: path.customersId
      - text: Generate {types} recommendations for a {channel} campaign in account {customer}.
        slots:
          types: requestBody.recommendationTypes
          channel: requestBody.advertisingChannelType
          customer: path.customersId
      method: generated
      generated: '2026-10-02'
- target: $.paths['/v25/customers/{customersId}/recommendations:dismiss'].post
  update:
    x-apievangelist-phrasing:
      intent: Dismiss recommendations
      effect: write
      questions:
      - Can I hide recommendations I don't want to act on?
      - What happens if one of several dismissals fails?
      instructions:
      - text: Dismiss recommendations {operations} in account {customer}.
        slots:
          operations: requestBody.operations
          customer: path.customersId
      - text: Clear away the recommendations {operations} for account {customer} without applying them.
        slots:
          operations: requestBody.operations
          customer: path.customersId
      method: generated
      generated: '2026-10-02'