Skip to content

ASA settings: link to Apple's OAuth setup docs#7

Merged
bootuz merged 1 commit into
mainfrom
docs/asa-settings-oauth-link
May 24, 2026
Merged

ASA settings: link to Apple's OAuth setup docs#7
bootuz merged 1 commit into
mainfrom
docs/asa-settings-oauth-link

Conversation

@bootuz
Copy link
Copy Markdown
Owner

@bootuz bootuz commented May 24, 2026

What

In the Apple Search Ads API section of the Settings panel (web/src/components/SettingsPanel.svelte):

  • Add a link to Apple's Implementing OAuth for the Apple Search Ads API docs.
  • Drop the (free, no budget required), then Settings → API → Create New Client aside since Apple's docs now cover the credential-generation steps in more detail.

After:

Used for keyword suggestions for any app. Create a Search Ads account at searchads.apple.com. See Apple's OAuth setup guide ↗ for the Client ID / Client Secret details.

Why

Following the OAuth wire-shape fix in #6, users who hit credential issues now have one authoritative source to consult. Apple's console UI for creating API clients changes occasionally — pointing at their docs keeps our help text from drifting stale, and the docs page itself covers the JWT generation steps we don't (and shouldn't) document inline.

Reviewer notes

  • First <a href> in this file, so I introduced target="_blank" rel="noopener noreferrer" as the convention for any future external links here.
  • Used the existing text-amber-400 hover:underline palette (matches the "Replace" button in the same form) rather than introducing a blue link color — keeps the new element in-palette.
  • Used &nbsp; between "guide" and the glyph so a line wrap can't orphan the arrow.

Verification

  • npm run check — 0 errors, 0 warnings across 144 files
  • Manually verified the rendered text and that the link opens Apple's docs in a new tab

Add an external link to Apple's 'Implementing OAuth for the Apple Search
Ads API' page right under the Search Ads section description so users have
an authoritative reference for generating their Client ID / Client Secret.

Also tighten the surrounding copy: drop the '(free, no budget required),
then Settings -> API -> Create New Client' aside since the linked Apple
docs cover those steps in more detail and stay up to date as Apple's
console UI evolves.
@bootuz bootuz merged commit 4344712 into main May 24, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant