# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for App Store Connect App Custom Product Page Localizations API
  version: 1.0.0
extends: openapi/ios-appcustomproductpagelocalizations-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 12
- target: $.paths['/v1/appCustomProductPageLocalizations'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a localization to a custom product page
      effect: write
      questions:
      - How do I add a new language to an App Store custom product page?
      - Can I set localized promotional text for a custom product page?
      instructions:
      - text: Create a custom product page localization with {details}.
        slots:
          details: requestBody.data
      - text: 'Add a new language to my custom product page: {details}.'
        slots:
          details: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appCustomProductPageLocalizations/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a custom product page localization
      effect: read
      questions:
      - What's in one localization of my custom product page?
      - Can I check the promotional text for a specific custom page language?
      instructions:
      - text: Show custom product page localization {id}.
        slots:
          id: path.id
      - text: Get the localized content of custom page localization {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appCustomProductPageLocalizations/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a custom product page localization
      effect: destructive
      questions:
      - How do I drop a language from a custom product page?
      - Can I remove one localization without deleting the whole custom page?
      instructions:
      - text: Delete custom product page localization {id}.
        slots:
          id: path.id
      - text: Remove the localization {id} from its custom product page.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appCustomProductPageLocalizations/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a custom product page localization
      effect: write
      questions:
      - Can I change the promotional text of a localized custom product page?
      - How do I edit an existing custom page localization?
      instructions:
      - text: Update custom product page localization {id} with {details}.
        slots:
          id: path.id
          details: requestBody.data
      - text: Edit the localized text of custom page localization {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appCustomProductPageLocalizations/{id}/relationships/appPreviewSets'].get
  update:
    x-apievangelist-phrasing:
      intent: List preview set IDs of a custom page localization
      effect: read
      questions:
      - Can I get just the app preview set IDs for a custom page localization?
      - Which preview set identifiers are attached to this localization?
      instructions:
      - text: List only the preview set IDs for custom page localization {id}.
        slots:
          id: path.id
      - text: Return up to {limit} preview set linkages for localization {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appCustomProductPageLocalizations/{id}/appPreviewSets'].get
  update:
    x-apievangelist-phrasing:
      intent: List app preview sets of a custom page localization
      effect: read
      questions:
      - What app preview videos are on a localized custom product page?
      - Can I filter a custom page's preview sets by device preview type?
      instructions:
      - text: Show the app preview sets for custom page localization {id}.
        slots:
          id: path.id
      - text: List preview sets of localization {id} for preview type {previewType}.
        slots:
          id: path.id
          previewType: query.filter[previewType]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appCustomProductPageLocalizations/{id}/relationships/appScreenshotSets'].get
  update:
    x-apievangelist-phrasing:
      intent: List screenshot set IDs of a custom page localization
      effect: read
      questions:
      - Can I get only the screenshot set IDs for a custom page localization?
      - Which screenshot set identifiers does this localization reference?
      instructions:
      - text: List only the screenshot set IDs for custom page localization {id}.
        slots:
          id: path.id
      - text: Return up to {limit} screenshot set linkages for localization {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appCustomProductPageLocalizations/{id}/appScreenshotSets'].get
  update:
    x-apievangelist-phrasing:
      intent: List screenshot sets of a custom page localization
      effect: read
      questions:
      - What screenshots are shown on a localized custom product page?
      - Can I filter a custom page's screenshot sets by display type, like iPhone 6.7 inch?
      instructions:
      - text: Show the screenshot sets for custom page localization {id}.
        slots:
          id: path.id
      - text: List screenshot sets of localization {id} for display type {displayType}.
        slots:
          id: path.id
          displayType: query.filter[screenshotDisplayType]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appCustomProductPageLocalizations/{id}/relationships/searchKeywords'].get
  update:
    x-apievangelist-phrasing:
      intent: List search keyword IDs of a custom page localization
      effect: read
      questions:
      - Can I get just the keyword IDs linked to a custom page localization?
      - Which search keyword identifiers are attached to a localization?
      instructions:
      - text: List only the search keyword IDs for custom page localization {id}.
        slots:
          id: path.id
      - text: Return up to {limit} keyword linkages for localization {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appCustomProductPageLocalizations/{id}/relationships/searchKeywords'].post
  update:
    x-apievangelist-phrasing:
      intent: Add search keywords to a custom page localization
      effect: write
      questions:
      - How do I attach search keywords to a custom product page so it shows in search?
      - Can I add several keywords to a localized custom page at once?
      instructions:
      - text: Add keywords {keywords} to custom page localization {id}.
        slots:
          keywords: requestBody.data
          id: path.id
      - text: 'Attach these search keywords to localization {id}: {keywords}.'
        slots:
          id: path.id
          keywords: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appCustomProductPageLocalizations/{id}/relationships/searchKeywords'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove search keywords from a custom page localization
      effect: destructive
      questions:
      - How do I detach keywords from a localized custom product page?
      - Can I remove just a few search keywords from a custom page?
      instructions:
      - text: Remove keywords {keywords} from custom page localization {id}.
        slots:
          keywords: requestBody.data
          id: path.id
      - text: 'Detach these search keywords from localization {id}: {keywords}.'
        slots:
          id: path.id
          keywords: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appCustomProductPageLocalizations/{id}/searchKeywords'].get
  update:
    x-apievangelist-phrasing:
      intent: List search keywords of a custom page localization
      effect: read
      questions:
      - What search keywords are tied to a localized custom product page?
      - Can I filter a custom page's keywords by locale or platform?
      instructions:
      - text: Show the search keywords for custom page localization {id}.
        slots:
          id: path.id
      - text: List keywords of localization {id} for locale {locale}.
        slots:
          id: path.id
          locale: query.filter[locale]
      method: generated
      generated: '2026-10-01'