> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 단계별 가이드

export const Button = ({href, children}) => {
  return <div className="not-prose group">
    <a href={href}>
      <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-full group-hover:opacity-[0.9] font-medium">
        <span>
          {children}
        </span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

<div id="how-to-get-access-to-the-ads-api">
  ## Ads API 액세스 권한을 얻는 방법
</div>

1. [개발자 계정](https://developer.x.com/en/apply-for-access)에 등록하세요.
2. [개발자 App](https://developer.x.com/app)을 생성하고 토큰을 안전하게 관리하세요.
3. 각 개발자 App에 대해 Ads API 액세스 권한을 요청하려면 [ads.x.com/help](https://ads.x.com/help)에 방문해 요청을 제출하세요.

<Note>**참고:** 이미 X Developer Platform을 사용해 개발 중이며 개발자 계정이 있다면, 3단계로 건너뛰세요.</Note>

<div id="step-one-signup-for-a-developer-account">
  ### 1단계: 개발자 계정 신청
</div>

X의 API 제품에 요청을 보내려면 먼저 개발자 계정을 신청해야 합니다. 개발자 콘솔에서 App과 개발자용 App을 생성하세요. 그러면 API에 대한 모든 요청을 인증하는 데 사용할 자격 증명 세트를 발급받게 됩니다.

<Button href="https://developer.x.com/en/apply-for-access">
  개발자 계정 신청
</Button>

<div id="step-two-save-your-apps-key-and-tokens-and-keep-them-secure">
  ### 2단계: App의 키와 토큰을 저장하고 안전하게 보호하기
</div>

개발자 App에서 API 키(Consumer Key라고도 함) 세트를 발급받게 됩니다. 또한 개인 X 계정을 대신해 요청을 보낼 수 있는 Access Token 세트와, OAuth 2.0 Bearer Token이 필요한 엔드포인트를 인증하는 데 사용할 수 있는 Bearer 토큰을 생성할 수 있습니다. 이러한 키와 토큰은 재생성하지 않는 한 만료되지 않으므로, 환경 변수를 사용하거나 신뢰할 수 있는 비밀번호 관리 도구(패스워드 매니저)를 사용하는 것을 권장합니다.

또한 App 세부 정보 페이지의 URL에서 확인할 수 있는 App ID도 반드시 기록해 두세요. 이렇게 하면 다음 단계에서 Ads API 액세스를 요청하는 과정이 더 수월해집니다.

<Note>
  **참고:** 키와 토큰은 개발자 콘솔에서 한 번만 표시되므로, 생성하자마자 비밀번호 관리 도구에 이 자격 증명을 저장하는 것이 매우 중요합니다.

  키와 토큰을 분실하거나 잊어버린 경우, 다시 생성해야 하며, 이때 새로운 키와 토큰이 생성되고 기존 키와 토큰은 무효화됩니다. 이는 이전 자격 증명을 사용해 구성해 둔 모든 연동을 업데이트해야 함을 의미합니다.

  [인증 모범 사례](https://developer.x.com/en/docs/authentication/guides/authentication-best-practices)에 대해 더 알아보세요.
</Note>

<div id="step-three-apply-for-access-to-the-ads-api">
  ### 3단계: Ads API 액세스 신청
</div>

이 시점에서 여러분은 [기본 X API 액세스](https://developer.x.com/en/docs/twitter-api/v1)는 갖고 있지만, X Ads API의 특정 기능에는 아직 접근할 수 없습니다. 다음으로 Ads API 액세스를 요청하고 승인을 받아야 합니다. 각 개발자 App에 대해 Ads API 액세스를 요청하려면 [ads.x.com/help](https://ads.x.com/help)에 방문해 요청을 제출하세요.

<div id="access-tiers">
  ### 액세스 티어
</div>

신청 과정에서 필요한 액세스 수준을 지정해야 합니다. 자세한 내용은 [App 수준 및 광고 계정 수준 권한](https://developer.x.com/en/docs/twitter-ads-api/obtaining-ads-account-access#levels-of-access)을 참고하세요.

<div id="conversion-only">
  #### Conversion 전용
</div>

모바일 및 웹 Conversion 엔드포인트에 대한 읽기/쓰기 권한이 제공됩니다.

<div id="standard-access">
  #### Standard Access
</div>

Analytics, Campaign Management, Creatives, Custom Audiences, Conversion 엔드포인트에 대한 읽기 및 쓰기 권한을 제공합니다.

<Note>**참고:** App이 Ads API 액세스를 승인받은 후에는, 정상적으로 [인증된 Ads API 요청](https://developer.x.com/en/docs/twitter-ads-api/making-authenticated-requests)을 보내기 위해 [모든 사용자 액세스 토큰을 다시 생성](https://developer.x.com/resources/fundamentals/authentication/obtaining-user-access-tokens)해야 합니다.</Note>

<Note>**참고:** 2023년 7월 이전에 액세스를 요청한 Ads API 개발자는 서로 다른 수준의 액세스 권한을 가질 수 있으며, OAuth 토큰이 5개로 제한될 수 있습니다. 추가 엔드포인트에 대한 액세스를 얻거나 기존 애플리케이션의 토큰 제한을 해제하려면 [액세스 확대](https://developer.x.com/en/docs/twitter-ads-api/increasing-access) 가이드를 참조하세요.</Note>

<div id="make-your-first-request">
  ## 첫 번째 요청 보내기
</div>

Ads API에 대한 접근 권한을 테스트하려면 [GET accounts](https://developer.x.com/en/docs/twitter-ads-api/campaign-management/api-reference/accounts) 엔드포인트에 요청을 보내세요. 이 엔드포인트는 현재 인증된 사용자가 액세스할 수 있는 광고 계정을 반환합니다. 이 요청의 응답에서 반환된 광고 계정 ID를 이후 API 요청에서 사용하여 특정 광고 계정의 데이터를 읽고 쓸 수 있습니다. 명령줄에서 [Twurl](https://developer.x.com/en/docs/tutorials/using-twurl)을 사용할 경우 요청은 다음과 같습니다.

**요청 예시**

```bash theme={null}
twurl -H ads-api.x.com "/11/accounts"
```

**응답 예시**

```json theme={null}
{
  "request": {
    "params": {}
  },
  "data": [
   {
    "name": "Furni",
    "business_name": null,
    "timezone": "America/Los_Angeles",
    "timezone_switch_at": "2016-04-06T07:00:00Z",
    "id": "18ce54ayf0z",
    "created_at": "2016-04-07T14:40:15Z",
    "salt": "b88939e5cabbca720159cb3659d73c06",
    "updated_at": "2017-02-08T08:49:53Z",
    "business_id": null,
    "approval_status": "ACCEPTED",
    "deleted": false
     }
   ]
}
```

<div id="up-next">
  ## 다음 단계 . . .
</div>

* [Ads API 문서](https://developer.x.com/en/docs/twitter-ads-api)에서 [버전 관리](https://developer.x.com/en/docs/twitter-ads-api/versioning)와 [계층 구조 및 용어](https://developer.x.com/en/docs/twitter-ads-api/hierarchy-terminology)와 같은 기초 개념을 읽어 보세요.
* Ads API 통합에 도움이 되는 다양한 [Ads API 도구 및 라이브러리](https://developer.x.com/en/docs/twitter-ads-api/tools-and-libraries)를 살펴보세요.
* [Ads API 액세스 확대](https://developer.x.com/en/docs/twitter-ads-api/increasing-access)를 위한 단계를 파악하세요.
* 사용 가능한 [지원 리소스](https://developer.x.com/en/support/twitter-ads-api)를 확인하세요.
* API 변경 사항, 서비스 장애 및 문제, X 프로모션 제품 개선에 대한 실시간 업데이트를 받으려면 [@API](https://x.com/API)를 팔로우하세요.