API Evangelist conversational phrasing for DoorDash Ads Ad Groups API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for DoorDash Ads Ad Groups API
  version: 1.0.0
extends: openapi/doordash-ad-groups-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/ads/api/v1/{campaignType}/adGroups'].get
  update:
    x-apievangelist-phrasing:
      intent: List ad groups in my campaigns
      effect: read
      questions:
      - Which ad groups are running under my sponsored product campaigns?
      - Can I filter the ad group list down to specific campaign IDs?
      instructions:
      - text: List ad groups for {campaignType} campaigns.
        slots:
          campaignType: path.campaignType
      - text: List the ad groups in campaign {campaignIds} for {campaignType}.
        slots:
          campaignIds: query.campaignIdFilter
          campaignType: path.campaignType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ads/api/v1/{campaignType}/adGroups'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an ad group's bids, dates or status
      effect: write
      questions:
      - How do I pause an ad group that is already live?
      - Can I change the end date or automatic bid of an existing ad group?
      instructions:
      - text: Pause ad group {adGroupId} in campaign {campaignId} for {campaignType}.
        slots:
          adGroupId: requestBody.adGroupId
          campaignId: requestBody.campaignId
          campaignType: path.campaignType
      - text: Rename existing ad group {adGroupId} in campaign {campaignId} ({campaignType}) to {name}.
        slots:
          adGroupId: requestBody.adGroupId
          campaignId: requestBody.campaignId
          campaignType: path.campaignType
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ads/api/v1/{campaignType}/adGroups'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new ad group in a campaign
      effect: write
      questions:
      - What do I need to set up a new ad group, such as dates and manual targets?
      - Can a new ad group target specific businesses or dayparts?
      instructions:
      - text: Create an ad group named {name} in campaign {campaignId} for {campaignType} from {startDate} to {endDate}.
        slots:
          name: requestBody.name
          campaignId: requestBody.campaignId
          campaignType: path.campaignType
          startDate: requestBody.startDate
          endDate: requestBody.endDate
      - text: Add a new {campaignType} ad group called {name} to campaign {campaignId}.
        slots:
          campaignType: path.campaignType
          name: requestBody.name
          campaignId: requestBody.campaignId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ads/api/v1/{campaignType}/adGroups/{adGroupId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one ad group by its ID
      effect: read
      questions:
      - What are the settings of one specific ad group?
      - How do I look up a single ad group's targeting and bid details by its ID?
      instructions:
      - text: Show ad group {adGroupId} for {campaignType}.
        slots:
          adGroupId: path.adGroupId
          campaignType: path.campaignType
      - text: Get the bidding and targeting of ad group {adGroupId} ({campaignType}).
        slots:
          adGroupId: path.adGroupId
          campaignType: path.campaignType
      method: generated
      generated: '2026-09-26'