Digital Platform API - Carrier サービス

[アーティクル]
01/16/2025

携帯電話会社は、ワイヤレス通信事業者またはモバイルネットワークオペレーターとも呼ばれ、モバイルデバイスのユーザーにワイヤレス通信サービスを販売および提供するために必要なすべての要素を所有または制御します。読み取り専用の携帯電話会社サービスを使用すると、当社のシステムに登録されている携帯電話会社を確認できます。このサービスを使用すると、モバイルキャンペーンでターゲット設定を行う通信事業者の ID を取得できます。

注:

モバイルデバイスの作成とモデルに基づいて、モバイルキャンペーンをターゲットにすることもできます。詳細については、「 Device Make Service 」および「 Device Model Service」を参照してください。

REST API

HTTP メソッド	エンドポイント	説明
`GET`	https://api.appnexus.com/carrier	すべての通信事業者を表示します。
`GET`	https://api.appnexus.com/carrier?country_code=COUNTRY_CODE	特定の国または地域のすべての運送業者を表示します。
`GET`	https://api.appnexus.com/carrier?id=CARRIER_ID	特定の通信事業者を表示します。
`GET`	https://api.appnexus.com/carrier/meta	フィルター処理および並べ替えの対象となるフィールドを確認します。

JSON フィールド

フィールド	種類	説明
`id`	int	携帯電話会社の ID。
`name`	string	携帯電話会社の名前。
`country_code`	列挙	運送業者が動作する国または地域の ISO コード。
`country_name`	string	運送業者が運営する国または地域の名前。
`codes`	オブジェクトの配列	携帯電話会社のサードパーティの表現。詳細については、以下のコードオブジェクトに関するページを参照してください。

Codes オブジェクト

codes配列内の各オブジェクトには、次のフィールドが含まれています。

フィールド	種類	説明
`id`	int	運送業者コードの ID。
`code`	string	運送業者のサードパーティの表現。
`notes`	string	第三者に関する識別情報。
`carrier_id`	int	通信事業者の ID。 (これは、上記の `id` フィールドと同じです)。

例

すべての携帯電話会社を表示する

{code}$ curl -b cookies -c cookies 'https://api.appnexus.com/carrier'
{
    "response": {
        "status": "OK",
        "count": 143,
        "start_element": null,
        "num_elements": 10,
        "carriers": [
            {
                "id": 1,
                "name": "WIFI",
                "country_code": "",
                "is_aggregated": false,
                "codes": null
            },
            {
                "id": 2,
                "name": "Verizon - AR",
                "country_code": "AR",
                "is_aggregated": true,
                "codes": null
            },
            {
                "id": 3,
                "name": "Verizon - AU",
                "country_code": "AU",
                "is_aggregated": true,
                "codes": null
            },
            {
                "id": 4,
                "name": "Verizon - CA",
                "country_code": "CA",
                "is_aggregated": true,
                "codes": null
            },
            {
                "id": 5,
                "name": "Verizon - DE",
                "country_code": "DE",
                "is_aggregated": true,
                "codes": null
            },
            {
                "id": 6,
                "name": "Verizon - FR",
                "country_code": "FR",
                "is_aggregated": true,
                "codes": null
            },
            {
                "id": 7,
                "name": "Verizon - GB",
                "country_code": "GB",
                "is_aggregated": true,
                "codes": null
            },
            ...
        ],
        
    }
}
{code}

米国のすべての携帯電話会社を表示する

{code}$ curl -b cookies -c cookies 'https://api.appnexus.com/carrier?country_code=US'
{
    "response": {
        "status": "OK",
        "count": 7,
        "start_element": null,
        "num_elements": null,
        "carriers": [
            {
                "id": 14,
                "name": "Verizon - US",
                "country_code": "US",
                "is_aggregated": true,
                "codes": null
            },
            {
                "id": 26,
                "name": "Sprint - US",
                "country_code": "US",
                "is_aggregated": true,
                "codes": null
            },
            {
                "id": 40,
                "name": "Orange - US",
                "country_code": "US",
                "is_aggregated": true,
                "codes": null
            },
            {
                "id": 55,
                "name": "T-Mobile - US",
                "country_code": "US",
                "is_aggregated": true,
                "codes": null
            },
            {
                "id": 60,
                "name": "AT&T - US",
                "country_code": "US",
                "is_aggregated": true,
                "codes": null
            },
            {
                "id": 90,
                "name": "Vodafone - US",
                "country_code": "US",
                "is_aggregated": true,
                "codes": null
            },
            {
                "id": 108,
                "name": "Telefonica - US",
                "country_code": "US",
                "is_aggregated": true,
                "codes": null
            }
        ]
    }
}
{code}

特定の携帯電話会社を表示する

{code}
$ curl -b cookies -c cookies 'https://api.appnexus.com/carrier?id=1'
{
    "response": {
        "status": "OK",
        "count": 1,
        "start_element": null,
        "num_elements": null,
        "carriers": [
            {
                "id": 1,
                "name": "WIFI",
                "country_code": null,
                "codes": null
            }
        ]
    }
}
{code}

次の方法で共有