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

# ステップバイステップガイド

> X Ads API を使い始めるためのステップバイステップガイド。開発者アカウントの登録、アプリ作成、認証トークンの管理、Ads API アクセス申請から最初のリクエストまでの流れを順を追って解説します。

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>;
};

## Ads API へのアクセス方法

1. [開発者アカウント](https://developer.x.com/en/apply-for-access)にサインアップします。
2. [開発者アプリ](https://developer.x.com/app)を作成し、トークンを安全に保管します。
3. [ads.x.com/help](https://ads.x.com/help) にアクセスし、開発者アプリごとに Ads API アクセスのリクエストを送信します。

<Note>**注:** すでに X Developer Platform を利用しており、開発者アカウントをお持ちの場合は、ステップ 3 に進んでください。</Note>

### ステップ 1: 開発者アカウントにサインアップする

X のいずれかの API プロダクトにリクエストを送るには、まず開発者アカウントにサインアップする必要があります。Developer Console 内で、App と開発者 App を作成します。これにより、API へのすべてのリクエストの認証に使用する一連の認証情報が提供されます。

<Button href="https://console.x.com">
  開発者アカウントにサインアップ
</Button>

### ステップ 2: App のキーとトークンを保存し、安全に管理する

開発者 App 内で、一連の API キー(コンシューマーキーとも呼ばれます)が提供されます。また、ご自身の X アカウントの代理でリクエストを行うために使用できる Access Token のセットと、OAuth 2.0 Bearer Token を必要とするエンドポイントを認証するために使用できる Bearer Token を生成する機会もあります。これらのキーとトークンは再生成しない限り期限切れにならないため、環境変数を作成するか、安全なパスワードマネージャーを使用することをお勧めします。

また、App の詳細の URL に表示される App ID もメモしておいてください。これにより、次のステップで Ads API へのアクセスをリクエストする際に役立ちます。

<Note>
  **注:** キーとトークンは Developer Console に一度しか表示されないため、生成したらすぐにパスワード管理システムに保管することが重要です。

  キーとトークンを紛失または忘れた場合は、再生成する必要があります。再生成すると新しいキーとトークンが作成され、古いものは無効になります。これは、以前の認証情報で設定したインテグレーションを更新する必要があることを意味します。

  [認証のベストプラクティス](/fundamentals/authentication/guides/authentication-best-practices)について詳しく学べます。
</Note>

### ステップ 3: Ads API へのアクセスを申請する

この時点で X API への基本的なアクセスはありますが、X Ads API 固有の機能にはアクセスできません。次に、Ads API アクセスをリクエストし、承認される必要があります。[ads.x.com/help](https://ads.x.com/help) にアクセスし、開発者アプリごとに Ads API アクセスのリクエストを送信してください。

### アクセスティア

申請プロセスの一環として、必要なアクセスレベルを指定する必要があります。[App レベルおよび広告アカウントレベルの権限](/x-ads-api/fundamentals/accessing-ads-accounts#levels-of-access)について詳しく学べます。

#### Conversion Only

Mobile および Web Conversion エンドポイントへの読み取りおよび書き込みアクセス。

#### Standard Access

Analytics、Campaign Management、Creatives、Custom Audiences、および Conversion エンドポイントへの読み取りおよび書き込みアクセス。

<Note>**注:** App が Ads API アクセスの承認を受けた後、適切に[認証された Ads API リクエスト](/x-ads-api/fundamentals/making-authenticated-requests)を行うために、[ユーザーアクセストークンを再生成](/fundamentals/authentication/oauth-1-0a/obtaining-user-access-tokens)する必要があります。</Note>

<Note>**注:** 2023 年 7 月以前にアクセスを申請した Ads API 開発者は、異なるアクセスレベルや権限を持つ場合があり、OAuth トークンが 5 つに制限されることがあります。既存のアプリケーションで追加のエンドポイントにアクセスしたり、トークンの制限を解除したりするには、[アクセスの拡大](/x-ads-api/getting-started/increasing-access)に関するガイドをご覧ください。</Note>

## 最初のリクエストを行う

Ads API へのアクセスをテストするには、[GET accounts](/x-ads-api/campaign-management/reference#get-accounts) エンドポイントにリクエストを送信します。このエンドポイントは、現在認証されているユーザーがアクセス権を持つ広告アカウントを返します。このリクエストで取得した広告アカウント ID を、特定の広告アカウントのデータを読み書きする後続の API リクエストで使用します。コマンドラインで [Twurl](https://github.com/twitter/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
     }
   ]
}
```

## 次のステップ . . .

* [Ads API ドキュメント](/x-ads-api/introduction)を読み、[バージョニング](/x-ads-api/fundamentals/versioning)や[階層](/x-ads-api/fundamentals/hierarchy-and-terminology)などの基本事項を確認してください。
* Ads API 連携を支援するさまざまな [Ads API ツール & ライブラリ](/x-ads-api/tools-and-libraries)をご確認ください。
* [Ads API アクセスを拡大する](/x-ads-api/getting-started/increasing-access)手順を理解してください。
* 利用可能な[サポートリソース](/support)に慣れておきましょう。
* API の変更、サービスの問題、X プロモートプロダクトの機能強化に関するライブアップデートについては、[@API](https://x.com/API) をフォローしてください。