# 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 Game Center Leaderboard Set Localizations…
  version: 1.0.0
extends: openapi/ios-gamecenterleaderboardsetlocalizations-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/gameCenterLeaderboardSetLocalizations'].post
  update:
    x-apievangelist-phrasing:
      intent: Localize a leaderboard set (v1)
      effect: write
      questions:
      - How do I add a translated name for a Game Center leaderboard set using the original v1 endpoint?
      - Can I give a leaderboard set a display name in another language with the legacy API?
      instructions:
      - text: Add a v1 localization {localization} to my leaderboard set.
        slots:
          localization: requestBody.data
      - text: Using the older v1 endpoint, create a French name for a leaderboard set from {localization}.
        slots:
          localization: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboardSetLocalizations/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a leaderboard set localization (v1)
      effect: read
      questions:
      - Where can I read one v1 leaderboard set localization and its locale?
      - What name does a legacy leaderboard set localization show players?
      instructions:
      - text: Show v1 leaderboard set localization {id}.
        slots:
          id: path.id
      - text: Read the legacy leaderboard set translation {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboardSetLocalizations/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a leaderboard set localization (v1)
      effect: destructive
      questions:
      - Can I remove a language from a leaderboard set through the v1 API?
      - Is deleting an old v1 leaderboard set translation permanent?
      instructions:
      - text: Delete v1 leaderboard set localization {id}.
        slots:
          id: path.id
      - text: Drop the legacy leaderboard set translation {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboardSetLocalizations/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a leaderboard set localization (v1)
      effect: write
      questions:
      - How can I fix a typo in a leaderboard set's translated name via v1?
      - Can I edit an existing v1 leaderboard set localization?
      instructions:
      - text: Update v1 leaderboard set localization {id} with {changes}.
        slots:
          id: path.id
          changes: requestBody.data
      - text: Correct the name on legacy leaderboard set translation {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboardSetLocalizations'].post
  update:
    x-apievangelist-phrasing:
      intent: Localize a leaderboard set (v2)
      effect: write
      questions:
      - What's the newer v2 way to add a language to a Game Center leaderboard set?
      - Can I create a leaderboard set localization with the current v2 API?
      instructions:
      - text: Create a v2 leaderboard set localization from {localization}.
        slots:
          localization: requestBody.data
      - text: With the current v2 endpoint, add a Japanese name to a leaderboard set using {localization}.
        slots:
          localization: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboardSetLocalizations/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a leaderboard set localization (v2)
      effect: read
      questions:
      - How do I fetch one leaderboard set localization from the v2 API?
      - What locale and name does a current v2 leaderboard set localization hold?
      instructions:
      - text: Show v2 leaderboard set localization {id}.
        slots:
          id: path.id
      - text: Fetch the current-version set translation {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboardSetLocalizations/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a leaderboard set localization (v2)
      effect: destructive
      questions:
      - Can I delete a leaderboard set language using the v2 endpoint?
      - What does removing a current v2 set localization do to players in that locale?
      instructions:
      - text: Delete v2 leaderboard set localization {id}.
        slots:
          id: path.id
      - text: Remove current-version set translation {id} for good.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboardSetLocalizations/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a leaderboard set localization (v2)
      effect: write
      questions:
      - Can I rename a leaderboard set in one language through the v2 API?
      - Which v2 call edits an existing set localization?
      instructions:
      - text: Update v2 leaderboard set localization {id} with {changes}.
        slots:
          id: path.id
          changes: requestBody.data
      - text: Change the display name on current-version set translation {id} to {changes}.
        slots:
          id: path.id
          changes: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboardSetLocalizations/{id}/relationships/gameCenterLeaderboardSetImage'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the image ID of a v1 set localization
      effect: read
      questions:
      - Which image ID is attached to a v1 leaderboard set localization?
      - Can I get just the artwork identifier for a legacy set translation?
      instructions:
      - text: Get the leaderboard set image ID linked to v1 localization {id}.
        slots:
          id: path.id
      - text: Return only the artwork reference on legacy set translation {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/gameCenterLeaderboardSetLocalizations/{id}/gameCenterLeaderboardSetImage'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the image of a v1 set localization
      effect: read
      questions:
      - What image file is uploaded for a v1 leaderboard set localization?
      - Has the artwork for my legacy set translation finished uploading?
      instructions:
      - text: Show the full leaderboard set image for v1 localization {id}.
        slots:
          id: path.id
      - text: Check the upload state of the artwork on legacy set translation {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboardSetLocalizations/{id}/relationships/image'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the image ID of a v2 set localization
      effect: read
      questions:
      - Which image ID does a v2 leaderboard set localization point to?
      - Can I fetch only the image reference for a current v2 set translation?
      instructions:
      - text: Get the image ID linked to v2 set localization {id}.
        slots:
          id: path.id
      - text: Return just the picture identifier for current-version set translation {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/gameCenterLeaderboardSetLocalizations/{id}/image'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the image of a v2 set localization
      effect: read
      questions:
      - What does the artwork on a v2 leaderboard set localization look like?
      - Is the image for my current v2 set translation fully processed?
      instructions:
      - text: Show the full image record for v2 set localization {id}.
        slots:
          id: path.id
      - text: Check the asset delivery state for current-version set translation {id}'s picture.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'