# アプリケーション API

> アプリケーション API を使用してアプリケーションを取得、作成、更新、削除することで、AIR アプリケーションのライフサイクルを管理します。

この API を使用して、Ironsource のダッシュボードでアプリケーションを取得および作成します。

## アプリの取得

### 説明

この API を使用して、すべてのアプリケーションのリストを取得します。反応には、上の表で説明した詳細なパラメーターが含まれます。

### Authenticationタイプ

[Bearer API 認証](/grow/levelplay/platform/api/authentication.md.md)

## メソッド

GET:

```text
platform.ironsrc.com/partners/publisher/applications/v6?
```

必須パラメーター: なし
リクエスト例 URL: [https://platform.ironsrc.com/partners/publisher/applications/v6](https://platform.ironsrc.com/partners/publisher/applications/v6)?

### オプションのパラメーター

反応で返されるアプリケーションの数を減らすには、以下のパラメーターを追加して結果をフィルター処理します。

| **フィルター パラメーター** | **説明**               | **値**         |
| ---------------- | -------------------- | ------------- |
| `platform`       | 操作システム               | iOS / Android |
| `appStatus`      | アプリケーション アクティベーション状態 | アクティブ/アーカイブ   |

### リクエスト例 URL

```xml
https://platform.ironsrc.com/partners/publisher/applications/v6?appStatus=active
```

### 反応パラメータ

| **名前**                | **説明**                                |
| --------------------- | ------------------------------------- |
| `appKey`              | アプリケーションキー (プラットフォーム上に表示されるもの)        |
| `appName`             | アプリケーション名                             |
| `appStatus`           | アプリケーション状態はアクティブまたは非アクティブ             |
| `platform`            | iOS または Android                       |
| `bundleId`            | ストアバンドル ID                            |
| `trackId`             | アプリケーションストアのトラック ID (iOS のみ)          |
| `taxonomy`            | アプリケーションサブジャンル。                       |
| `creationDate`        | アプリケーションが Ironsource プラットフォームに追加された日付 |
| `icon`                | アプリケーション アイコン (ストアからの取得)              |
| `adUnits`             | 広告単位ごとのアクティブな広告ネットワーク名が含まれます。         |
| `networkReportingApi` | アクティブな広告ネットワークのレポートAPI状態を含みます。        |
| `coppa`               | アプリケーションの COPPA 設定（true＝1/false＝0）    |
| `ccpa`                | アプリケーションの CCPA 設定（true＝1/false＝0）     |

### JSON 反応例

```json
 [
    {
        "appKey":"6be7c3bd",
        "appName": "puzzl2999",
        "appStatus": "active",
        "platform":"Android",
        "bundleId": "unknown",
        "taxonomy":"ビンゴ"
        "creationDate":"01/01/2020",
        "icon": "https://local.supersonicads.com/ssastatic/partners/assets/images/appDefaultIcon.v3.png",
        "adUnits": {
            "rewardedVideo": {
                "activeNetworks": [
                    "ironSource"
                ]
            },
            "offerWall": {
                "activeNetworks": [
                    "ironSource"
                ]
            },
            "interstitial": {
                "activeNetworks": [
                    "ironSource"
                ]
            },
            "banner": {
                "activeNetworks": [
                    "ironSource"
                ]
            }
        },
        "networkReportingApi": {
            "ironSource": "verified"
        },
        "bundleRefId":0,
        "coppa":1,
        "ccpa":1
    },
    {
        "appKey":"6be7e081",
        "appName": "puzzl2999666",
        "appStatus": "active",
        "platform":"Android",
        "bundleId": "unknown",
        "taxonomy":"ビンゴ"
        "creationDate":"01/01/2020",
        "icon": "https://local.supersonicads.com/ssastatic/partners/assets/images/appDefaultIcon.v3.png",
        "adUnits": {
            "rewardedVideo": {
                "activeNetworks": [
                    "ironSource"
                ]
            },
            "offerWall": {
                "activeNetworks": [
                    "ironSource"
                ]
            },
            "interstitial": {
                "activeNetworks": [
                    "ironSource"
                ]
            },
            "banner": {
                "activeNetworks": [
                    "ironSource"
                ]
            }
        },
        "networkReportingApi": {
            "ironSource": "verified"
        },
        "bundleRefId":0,
        "coppa":1,
        "ccpa":0
    }
]
```

## アプリケーションの作成

### 説明

この API を使用して、Ironsource プラットフォームでアプリケーションを作成します。アプリケーション作成APIを使用してアプリケーションを作成すると、サポートされている各広告ユニット(リワード型ビデオ、インタースティシャル、バナー、オファーウォール)が「オフ」状態で自動的に作成されます(特にリクエストがない限り)。

### Authenticationタイプ

[Bearer API 認証](/grow/levelplay/platform/api/authentication.md.md)

### メソッド

POST

```text
platform.ironsrc.com/partners/publisher/applications/v6?
```

### ライブアアプリケーションの作成に必要なパラメーター

| **名前**     | **型** | **説明**                               |
| ---------- | ----- | ------------------------------------ |
| `storeUrl` | 文字列   | アプリケーションのストア URL                     |
| `taxonomy` | 文字列   | アプリケーションサブジャンル。                      |
| `coppa`    | 整数    | アプリケーションのコッパ状態（true ＝ 1 / false ＝ 0） |

### ストアに公開されていないアプリケーションを作成するために必要なパラメーター

| **名前**     | **型** | **説明**                               |
| ---------- | ----- | ------------------------------------ |
| `appName`  | 文字列   | アプリケーション名                            |
| `platform` | 文字列   | iOS または Android                      |
| `coppa`    | 整数    | アプリケーションのコッパ状態（true ＝ 1 / false ＝ 0） |

### オプションのパラメーター

| **名前**          | **型** | **説明**                                  |
| --------------- | ----- | --------------------------------------- |
| `adUnit:status` | 文字列   | "RewardedVideo":ライブ                     |
| `ccpa`          | 整数    | アプリケーションの ccpa 状態（true ＝ 1 / false ＝ 0） |

### リクエスト例URL\*\*

```text
https://platform.ironsrc.com/partners/publisher/applications/v6?
```

### ライブアアプリケーションを作成するためのサンプルボディのリクエスト

```json
{
  "storeUrl": "https://apps.apple.com/us/app/time-gap-hidden-objects/id661173158",
  "taxonomy": "puzzle",
  "appName": "puzzleApp",
  "coppa":1,
  "ccpa":0,
  "adUnits": {
    "RewardedVideo":"ライブ",
    "Interstitial":"ライブ",
    "OfferWall":"オフ",
    "Banner":"ライブ",
    "NativeAd":ライブ
  }
}
```

### Store に公開されていないアプリケーションを作成するためのリクエストサンプルボディ

```json
{
 "appName":"MyTestAppiOS",
 "platform": "iOS"
}
```