메인 콘텐츠로 건너뛰기

Ads API 액세스 방법

  1. 개발자 계정에 등록합니다.
  2. Developer 앱을 생성하고 토큰을 안전하게 관리합니다.
  3. 각 Developer 앱별로 Ads API 액세스를 요청하려면 ads.x.com/help에서 요청을 제출합니다.
참고: 이미 X Developer Platform에서 개발 중이며 개발자 계정이 있다면 3단계로 건너뛰세요.

1단계: 개발자 계정 가입

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

2단계: App의 키와 토큰을 저장하고 안전하게 보관하세요

Developer 앱에서는 API 키 세트(Consumer 키라고도 함)가 제공됩니다. 또한 개인 X 계정을 대신해 요청을 수행할 수 있는 액세스 토큰 세트와, OAuth 2.0 베어러 토큰이 필요한 엔드포인트 인증에 사용할 수 있는 베어러 토큰을 생성할 수 있습니다. 이러한 키와 토큰은 재생성하지 않는 한 만료되지 않으므로 환경 변수를 사용하거나 신뢰할 수 있는 비밀번호 관리자를 사용하는 것을 권장합니다. 아울러 App 상세 페이지의 URL에서 확인할 수 있는 App ID도 기록해 두세요. 이는 다음 단계에서 Ads API 액세스를 요청할 때 과정을 더 원활하게 해 줍니다.
참고: 키와 토큰은 개발자 포털에서 한 번만 표시되므로, 생성 즉시 비밀번호 관리 시스템에 해당 자격 증명을 저장하는 것이 중요합니다.키와 토큰을 분실하거나 잊은 경우 재생성해야 하며, 이때 새 키와 토큰이 발급되고 기존 것은 무효화됩니다. 이는 이전 자격 증명으로 설정해 둔 모든 통합을 업데이트해야 함을 의미합니다.인증 모범 사례에 대해 자세히 알아보세요.

3단계: Ads API 액세스 신청

현재 X API의 기본 액세스는 보유하고 있지만, X Ads API의 특정 기능에는 접근할 수 없습니다. 다음으로 Ads API 액세스를 요청해 승인을 받아야 합니다. 각 Developer 앱마다 Ads API 액세스 요청을 제출하려면 ads.x.com/help을 방문하세요.

액세스 등급

신청 과정의 일환으로 필요한 액세스 수준을 지정해야 합니다. 앱 수준 및 광고 계정 수준 권한에 대해 자세히 알아보세요.

Conversion Only

읽기 및 쓰기 권한으로 모바일 및 웹 전환 엔드포인트에 접근할 수 있습니다.

표준 액세스

읽기 및 쓰기 권한으로 Analytics, Campaign Management, Creatives, Custom Audiences, Conversion 엔드포인트에 접근할 수 있습니다.
참고: 앱이 Ads API 액세스로 승인된 후, 인증된 Ads API 요청을 올바르게 수행하려면 사용자 액세스 토큰을 다시 발급해야 합니다.
참고: 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
     }
   ]
}

다음 단계 …