| title | 단계별 가이드 | ||||||
|---|---|---|---|---|---|---|---|
| keywords |
|
||||||
| description | import { Button } from "/snippets/button.mdx"; |
import { Button } from "/snippets/button.mdx";
- 개발자 계정에 가입합니다.
- developer App](/fundamentals/developer-apps)을 생성하고 토큰을 안전하게 보관합니다.
- ads.x.com/help에 접속하여 각 developer App에 대해 Ads API 접근 권한을 요청합니다.
참고: 이미 X Developer Platform에서 개발 중이며 개발자 계정이 있다면 3단계로 건너뛰세요.
X의 API 제품에 요청을 보내려면 먼저 개발자 계정에 가입해야 합니다. Developer Console에서 App과 developer App을 생성하세요. 이를 통해 API에 대한 모든 요청을 인증하는 데 사용할 자격 증명 세트를 받게 됩니다.
개발자 계정 가입developer App 내에서 API Keys(Consumer Keys라고도 함) 세트를 받게 됩니다. 또한 자신의 X 계정을 대신하여 요청을 보내는 데 사용할 수 있는 Access Tokens 세트와 OAuth 2.0 Bearer Token이 필요한 엔드포인트를 인증하는 데 사용할 수 있는 Bearer Token을 생성할 수 있습니다. 이러한 키와 토큰은 재생성하지 않는 한 만료되지 않으므로, 환경 변수를 만들거나 안전한 비밀번호 관리자를 사용하는 것이 좋습니다.
App ID도 메모해 두시기 바랍니다. App 세부 정보의 URL에서 확인할 수 있습니다. 이는 다음 단계에서 Ads API 접근 권한을 요청할 때 도움이 됩니다.
**참고:** 키와 토큰은 Developer Console에 한 번만 표시되므로, 생성하는 즉시 비밀번호 관리 시스템에 이러한 자격 증명을 저장하는 것이 중요합니다.키와 토큰을 분실하거나 잊어버린 경우 재생성해야 하며, 이는 새 키와 토큰을 생성하고 이전 것은 무효화됩니다. 즉, 이전 자격 증명으로 설정한 모든 통합을 업데이트해야 합니다.
인증 모범 사례에 대해 자세히 알아보세요.
이 시점에서 X API에 대한 기본 접근 권한은 있지만 X Ads API 특정 기능에는 접근할 수 없습니다. 다음으로 Ads API 접근 권한을 요청하고 승인을 받아야 합니다. ads.x.com/help에 접속하여 각 developer App에 대해 Ads API 접근 권한 요청을 제출하세요.
신청 과정의 일부로, 필요한 접근 수준을 지정해야 합니다. App 수준 및 Ad Account 수준 권한에 대해 자세히 알아보세요.
Mobile 및 Web Conversion 엔드포인트에 대한 읽기 및 쓰기 접근 권한.
Analytics, Campaign Management, Creatives, Custom Audiences 및 Conversion 엔드포인트에 대한 읽기 및 쓰기 접근 권한.
참고: 앱이 Ads API 접근 승인을 받은 후, 인증된 Ads API 요청을 적절히 수행하려면 user access tokens를 재생성해야 합니다.
참고: 2023년 7월 이전에 접근을 요청한 Ads API 개발자는 다른 수준의 접근 권한과 권한을 가질 수 있으며, OAuth 토큰이 5개로 제한될 수 있습니다. 기존 애플리케이션의 추가 엔드포인트 접근 또는 토큰 한도 해제에 대해서는 접근 권한 확대 가이드를 참조하세요.
Ads API에 대한 접근을 테스트하려면 GET accounts 엔드포인트에 요청을 보내세요. 이 엔드포인트는 현재 인증된 사용자가 접근할 수 있는 광고 계정을 반환합니다. 이 요청에서 받은 광고 계정 ID를 이후 API 요청에서 사용하여 특정 광고 계정의 데이터를 읽고 쓰세요. 명령줄에서 Twurl을 사용하면 요청은 다음과 같습니다.
요청 예시
twurl -H ads-api.x.com "/11/accounts"응답 예시
{
"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
}
]
}- 버전 관리 및 계층 구조와 같은 기본 사항에 대한 Ads API 문서를 읽어보세요.
- Ads API 통합에 도움이 되는 다양한 Ads API 도구 및 라이브러리를 확인하세요.
- Ads API 접근 권한 확대 단계를 이해하세요.
- 사용 가능한 지원 리소스에 익숙해지세요.
- X 프로모트 상품에 대한 API 변경, 서비스 문제 및 개선 사항에 대한 실시간 업데이트를 받으려면 @API를 팔로우하세요.