English 中文TürkçeРусскийEspañol日本語Tiếng Việt
POST /api/v2/web-api/paywall/

ペイウォールを取得する

Copy as Markdown

指定されたプレースメントからペイウォールを取得します。

Request body

storestringrequired

プロダクトが購入されたストア。指定可能な値: app_store、play_store、stripe、またはカスタムストアの Store ID。

localestring

ペイウォールロケールの識別子。"-" 文字で区切られた 1 つ以上のサブタグで構成される言語コードを指定します。最初のサブタグは言語、2 番目のサブタグは地域を示します。

placement_idstringrequired

プレースメントの識別子。Adapty ダッシュボードでプレースメントを作成する際に指定した値です。

customer_user_idstring

customer_user_id または profile_id のいずれかが必須です。アプリでユーザーを識別するために使用するユーザー ID（例：ユーザーの UUID、メールアドレス、その他の ID）。

profile_idstring

customer_user_id または profile_id のいずれかが必須です。Adapty におけるユーザーの識別子。

Responses

成功レスポンスにはペイウォールオブジェクトが含まれます。

Schema
placement_idstringrequired

このペイウォールが表示されるプレースメントの ID。Adapty ダッシュボードでプレースメントを作成する際に設定した値です。

variation_idstringrequired

この特定のペイウォールに紐付けられた購入を追跡するためのバリエーション ID。

paywall_idstringrequired

ペイウォールの一意識別子。

ab_test_namestring

親 A/B テストの名前。

paywall_namestringrequired

Adapty ダッシュボードで定義されたペイウォールの名前。

productsarray of objectrequired

ペイウォールのプロダクト情報を含むプロダクトオブジェクトの配列。

titlestring

Adapty ダッシュボードのプロダクトセクションに設定されたプロダクト名。

is_consumablebooleanrequired

プロダクトが消耗型アイテムかどうかを示します。

adapty_product_idstring

Adapty で使用される内部プロダクト ID。

vendor_product_idstringrequired

アプリストアにおけるプロダクト ID。

introductory_offer_eligibilityboolean

ユーザーが iOS の初回オファーの対象かどうかを示します。

promotional_offer_eligibilityboolean

ユーザーがプロモーションオファーの対象かどうかを示します。

base_plan_idstring

Google Play のベースプラン ID、または Stripe の価格 ID。 Google Play については Base plan ID、 Stripe については price ID を参照してください。

offerallOf

JSON 形式の Offer オブジェクト。

categorystring

適用されたオファーのカテゴリ。

One of: "introductory", "promotional", "offer_code", "win_back"

typestring

アクティブなオファーの種別。null でない場合、現在のサブスクリプション期間にオファーが適用されていることを意味します。

One of: "free_trial", "pay_as_you_go", "pay_up_front", "unknown"

idstring

適用されたオファーの ID。

remote_configobject

ペイウォールのリモートコンフィグ全体を含む RemoteConfig オブジェクト。

langstringrequired

ペイウォールローカライズのロケールコード。ハイフン (-) で区切られた言語および地域サブタグを使用します。 例：英語の場合は en、ブラジルポルトガル語の場合は pt-br。

datastringrequired

ペイウォールのリモートコンフィグをシリアライズした JSON 文字列。 Adapty ダッシュボードの特定のペイウォールの [Remote Config] タブで確認できます。

Example 
{
  "placement_id": "onboarding",
  "variation_id": "d76feea0-c0cf-4942-bef5-84ed701fc6db",
  "paywall_id": "9a93fe6f-9162-4dc0-b4b7-73079ed95c34",
  "ab_test_name": "1 week + 1 month | apple picture",
  "paywall_name": "1 week + 1 month | apple picture",
  "products": [
    {
      "title": "1 week",
      "is_consumable": false,
      "adapty_product_id": "1c3e03e1-9c43-4f94-aeb5-c7ae2f73d0c2",
      "vendor_product_id": "1_week_apple",
      "introductory_offer_eligibility": true,
      "promotional_offer_eligibility": true,
      "base_plan_id": null,
      "offer": null
    },
    {
      "title": "1 month",
      "is_consumable": false,
      "adapty_product_id": "f4088450-45a8-4737-8db0-367e642d7dcb",
      "vendor_product_id": "1_month_apple",
      "introductory_offer_eligibility": true,
      "promotional_offer_eligibility": true,
      "base_plan_id": null,
      "offer": null
    }
  ],
  "remote_config": {
    "lang": "en",
    "data": "{\"default_product_number\":1,\"features\":[\"#fresh\",\"#green\",\"#healthy1\"],\"soft_paywall\":false,\"image_url\":\"https://adapty.io/apple.png\"}"
  }
}

リクエストが不正です

Schema
errorsarray of object
sourcestring
errorsarray of string
error_codestring
status_codeinteger

認証されていません

Schema
errorsarray of object
sourcestring
errorsarray of string
error_codestring
status_codeinteger

見つかりません

Schema
errorsarray of object
sourcestring
errorsarray of string
error_codestring
status_codeinteger