Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.x.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Ads API 액세스 권한을 얻는 방법

  1. 개발자 계정에 가입하세요.
  2. 개발자 App을 생성하고 토큰을 안전하게 보관하세요.
  3. ads.x.com/help을 방문하여 각 개발자 App에 대한 Ads API 액세스 요청을 제출하세요.
참고: 이미 X Developer Platform에서 개발 중이며 개발자 계정이 있는 경우 3단계로 건너뛰세요.

​
1단계: 개발자 계정에 가입하기

X의 어떤 API 제품에든 요청을 보내려면 먼저 개발자 계정에 가입해야 합니다. Developer Console 내에서 App과 개발자 App을 생성하세요. 이를 통해 API에 대한 모든 요청을 인증하는 데 사용할 자격 증명 세트를 얻을 수 있습니다.

​
2단계: App의 키와 토큰을 저장하고 안전하게 관리하기

개발자 App 내에서 API 키 세트(Consumer Key라고도 함)를 받게 됩니다. 또한 개인 X 계정을 대신하여 요청을 보내는 데 사용할 수 있는 Access Token 세트와 OAuth 2.0 Bearer Token이 필요한 엔드포인트를 인증하는 데 사용할 수 있는 Bearer Token을 생성할 수 있는 기회도 있습니다. 이러한 키와 토큰은 재생성하지 않는 한 만료되지 않으므로 환경 변수를 생성하거나 안전한 비밀번호 관리자를 사용하는 것이 좋습니다. 또한 App 세부 정보의 URL에서 찾을 수 있는 App ID도 기록해 두세요. 이렇게 하면 다음 단계에서 Ads API 액세스를 요청하기가 더 쉬워집니다.
참고: 키와 토큰은 Developer Console에서 한 번만 표시되므로 생성 즉시 비밀번호 관리 시스템에 저장하는 것이 중요합니다.키와 토큰을 분실하거나 잊어버린 경우 재생성해야 하며, 이 경우 새 키와 토큰이 생성되고 이전 것은 무효화됩니다. 이는 이전 자격 증명으로 설정한 통합을 모두 업데이트해야 함을 의미합니다.자세한 내용은 인증 모범 사례를 참고하세요.

​
3단계: Ads API 액세스 신청하기

이 시점에서는 X API에 대한 기본 액세스 권한은 있지만 X Ads API 전용 기능에는 액세스할 수 없습니다. 다음으로 Ads API 액세스를 요청하고 승인을 받아야 합니다. ads.x.com/help을 방문하여 각 개발자 App에 대한 Ads API 액세스 요청을 제출하세요.

​
액세스 등급

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

​
Conversion Only

Mobile 및 Web Conversion 엔드포인트에 대한 읽기/쓰기 액세스.

​
Standard Access

Analytics, Campaign Management, Creatives, Custom Audiences 및 Conversion 엔드포인트에 대한 읽기/쓰기 액세스.
참고: App이 Ads API 액세스 승인을 받은 후에는 올바르게 인증된 Ads API 요청을 보내기 위해 사용자 액세스 토큰을 재생성해야 합니다.
참고: 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
     }
   ]
}

​
다음 단계 …