すべてのプロモーションリストを取得

Digital Distribution Hub API

In-Game Store API

概要

API定義をダウンロードする

ユーザー属性

管理者

個人用カタログ

バンドル

管理者

カタログ

カート＆決済

カート（クライアント側）

カート（サーバー側）

決済（クライアント側）

決済（サーバー側）

注文

無料アイテム

通常

ウェブフック

先行予約

マーチャント

カタログ

共通地域

ゲームキー

カタログ

資格

管理者

プロモーション

通常

get

すべてのプロモーションリストを取得

get

コードで引き換え可能なプロモーションを入手する

仮想アイテム & 仮想通貨

管理者

カタログ

仮想決済

NFTアイテム

管理者

カタログ

制限

管理

リワードチェーン & バリューポイント

管理者

クライアント

クランクライアント

UPSELL

管理者

クライアント

CONNECTOR

管理者

Pay Station API

Subscriptions API

Webhooks

すべてのプロモーションリストを取得Server-sideAdmin

get/v2/project/{project_id}/admin/promotion

プロジェクトのプロモーションリストを取得します。

SecuritybasicAuth

Request

path Parameters

project_id

required

integer

プロジェクトID。このパラメータは、ドメインページのプロジェクト名の横にあります。

Example: 44056

query Parameters

limit	integer Limit for the number of elements on the page. Example: limit=50
offset	integer リストが生成される要素番号（カウントは0から始まります）。 Example: offset=0
enabled	integer Filter elements by `is_enabled` flag.

Responses

200

プロモーションのリストが正常に受信されました。

401

基本認証が不合格または不正です。基本認証または正しい認証情報を使用したことを確認してください。

Request samples

Response samples

application/json

{"active_promotions_count": 3,
"inactive_promotions_count": 2,
"promotions": [{"bonus": [{"item": {"bundle_type": "virtual_currency_package",
"content": [ ],
"description": null,
"image_url": null,
"name": {"en-US": "Diamonds pack",
"ru-RU": "Пак кристаллов"
},
"sku": "diamonds_pack",
"type": "bundle"
},
"quantity": 1
}
],
"condition": [{"item": {"description": null,
"image_url": null,
"inventory_options": {"consumable": true,
"expiration_period": null
},
"name": {"en-US": "VG name",
"ru-RU": "Название VG"
},
"sku": "virtual_good_bonus_2",
"type": "virtual_good"
}
}
],
"date_end": null,
"date_start": "2020-01-01T00:00",
"discount": null,
"id": 1,
"is_enabled": true,
"name": "promotion_1",
"type": "item_bonus"
},
{"bonus": null,
"condition": [{"item": {"description": null,
"image_url": null,
"inventory_options": {"consumable": true,
"expiration_period": null
},
"name": {"en-US": "VG name",
"ru-RU": "Название VG"
},
"sku": "virtual_good_bonus_2",
"type": "virtual_good"
}
}
],
"date_end": "2030-01-01T00:00",
"date_start": "2020-01-01T00:00",
"discount": {"percent": "10.99"
},
"id": 2,
"is_enabled": false,
"name": "promotion_2",
"type": "item_discount"
},
{"bonus": [{"item": {"description": null,
"image_url": null,
"inventory_options": {"consumable": true,
"expiration_period": null
},
"name": {"en-US": "VG name",
"ru-RU": "Название VG"
},
"sku": "virtual_good_bonus_2",
"type": "virtual_good"
},
"quantity": 2
}
],
"condition": [{"item": {"external_id": "coupon_2",
"is_enabled": true,
"name": {"en-US": "Coupon name",
"ru-RU": "Название купона"
},
"redeem_code_limit": 1,
"redeem_total_limit": null,
"redeem_user_limit": null
}
}
],
"date_end": "2030-01-01T00:00",
"date_start": "2022-01-01T00:00",
"discount": null,
"id": 3,
"is_enabled": true,
"name": "promotion_3",
"type": "coupon_bonus"
},
{"bonus": [{"item": {"description": null,
"image_url": null,
"inventory_options": {"consumable": true,
"expiration_period": null
},
"name": {"en-US": "VG name",
"ru-RU": "Название VG"
},
"sku": "virtual_good_bonus_2",
"type": "virtual_good"
},
"quantity": 2
}
],
"condition": [{"item": {"external_id": "coupon_3",
"is_enabled": true,
"name": {"en-US": "Coupon name",
"ru-RU": "Название купона"
},
"redeem_code_limit": 1,
"redeem_total_limit": null,
"redeem_user_limit": null
}
}
],
"date_end": "2031-01-01T00:00",
"date_start": "2018-01-01T00:00",
"discount": {"percent": "12.99"
},
"id": 4,
"is_enabled": false,
"name": "promotion_4",
"type": "promocode_bonus_discount"
},
{"bonus": [{"item": {"description": null,
"image_url": null,
"name": {"en-US": "VG name",
"ru-RU": "Название VG"
},
"sku": "virtual_good_bonus_4",
"type": "virtual_good"
},
"quantity": 1
}
],
"condition": null,
"date_end": null,
"date_start": "2020-01-01T00:00",
"discount": null,
"id": 5,
"is_enabled": true,
"name": "promotion_5",
"type": "cart_bonus"
}
],
"total_promotions_count": 5
}