- 개발자 계정에 등록합니다.
- Developer 앱을 생성하고 토큰을 안전하게 관리합니다.
- 각 Developer 앱별로 Ads API 액세스를 요청하려면 ads.x.com/help에서 요청을 제출합니다.
참고: 이미 X Developer Platform에서 개발 중이며 개발자 계정이 있다면 3단계로 건너뛰세요.
X의 API 제품에 요청을 보내려면 먼저 개발자 계정에 가입해야 합니다. 개발자 포털에서 Project와 Developer 앱을 생성하세요. 그러면 API에 대한 모든 요청을 인증하는 데 사용할 자격 증명 세트를 발급받게 됩니다.
2단계: App의 키와 토큰을 저장하고 안전하게 보관하세요
Developer 앱에서는 API 키 세트(Consumer 키라고도 함)가 제공됩니다. 또한 개인 X 계정을 대신해 요청을 수행할 수 있는 액세스 토큰 세트와, OAuth 2.0 베어러 토큰이 필요한 엔드포인트 인증에 사용할 수 있는 베어러 토큰을 생성할 수 있습니다. 이러한 키와 토큰은 재생성하지 않는 한 만료되지 않으므로 환경 변수를 사용하거나 신뢰할 수 있는 비밀번호 관리자를 사용하는 것을 권장합니다.
아울러 App 상세 페이지의 URL에서 확인할 수 있는 App ID도 기록해 두세요. 이는 다음 단계에서 Ads API 액세스를 요청할 때 과정을 더 원활하게 해 줍니다.
참고: 키와 토큰은 개발자 포털에서 한 번만 표시되므로, 생성 즉시 비밀번호 관리 시스템에 해당 자격 증명을 저장하는 것이 중요합니다.키와 토큰을 분실하거나 잊은 경우 재생성해야 하며, 이때 새 키와 토큰이 발급되고 기존 것은 무효화됩니다. 이는 이전 자격 증명으로 설정해 둔 모든 통합을 업데이트해야 함을 의미합니다.인증 모범 사례에 대해 자세히 알아보세요.
현재 X API의 기본 액세스는 보유하고 있지만, X Ads API의 특정 기능에는 접근할 수 없습니다. 다음으로 Ads API 액세스를 요청해 승인을 받아야 합니다. 각 Developer 앱마다 Ads API 액세스 요청을 제출하려면 ads.x.com/help을 방문하세요.
신청 과정의 일환으로 필요한 액세스 수준을 지정해야 합니다. 앱 수준 및 광고 계정 수준 권한에 대해 자세히 알아보세요.
읽기 및 쓰기 권한으로 모바일 및 웹 전환 엔드포인트에 접근할 수 있습니다.
읽기 및 쓰기 권한으로 Analytics, Campaign Management, Creatives, Custom Audiences, Conversion 엔드포인트에 접근할 수 있습니다.
참고: 2023년 7월 이전에 액세스를 요청한 Ads API 개발자는 액세스 및 권한 수준이 다를 수 있으며, OAuth 토큰이 최대 5개로 제한될 수 있습니다. 추가 엔드포인트에 대한 액세스를 받거나 기존 애플리케이션의 토큰 제한을 해제하려면
액세스 증가 가이드를 참조하세요.
Ads API에 대한 접근 권한을 테스트하려면 GET accounts 엔드포인트로 요청을 보내세요. 이 엔드포인트는 현재 인증된 사용자가 접근할 수 있는 광고 계정들을 반환합니다. 이후 특정 광고 계정의 데이터를 읽고 쓰기 위한 API 요청에서는 이 요청에서 받은 광고 계정 id를 사용하세요. 명령줄에서 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
}
]
}