アプリ内製品の編集

アプリケーションの既存のアプリ内製品は、Aptoide Connect 開発者コンソールを介して、またはこの API エンドポイントを使用してプログラムで更新できます。

エンドポイント

メソッド	URL
PATCH	https://ws.catappult.io/api/applications/{applicationName}/consumables/{sku}

認証

この API にアクセスするには、Aptoide Connect で有効なアカウントサブスクリプションを持ち、API キーで認証する必要があります（生成方法はこちらを確認してください）。

⚠️

必要なアカウントタイプ

アプリ内製品を編集できるのは、Developer タイプのアカウントのみです。

ヘッダー

ヘッダー	型	必須	説明
Api-Key	string	必須	API リクエストを認証するために使用されます。値は Aptoide Connect API キーです。

パスパラメーター

パラメーター	型	説明
applicationName	string	アプリケーションの一意のパッケージ名（例: com.example.test）。
sku	string	更新するアプリ内製品の一意の識別子（例: product01）。

クエリパラメーター

パラメーター	型	必須	説明
operatingSystem	string (URL)または file	任意（デフォルト: android）	アプリ内製品のオペレーティングシステムを指定します。可能な値: • android • ios

ボディパラメーター

⚠️

重要

ファイルをアップロードする代わりに URL を指定する場合でも、すべてのパラメーターは常にフォームデータ（multipart/form-data）として送信する必要があります。

JSON リクエストはサポートされていません。各フィールドを送信するには、cURL で -F フラグを使用してください。

注:

• 国別の小売価格が定義されていない場合、最終的な請求額は購入時に参照価格から自動的に変換されます。
• すべての countryPrices パラメーター（countryPrices[<country_code>][...]）は、サポートされている任意の ISO 3166-1 alpha-2 国コードを使用できます。
• すべての locale パラメーター（locales[<language_code>][...]）は、任意の ISO 639 言語コードを使用できます。複数の言語の locale パラメーターを一度に指定できますが、デフォルトとして設定できるのは 1 つだけです。

パラメーター	型	必須	説明
referencePriceCurrency	string	必須	参照価格の ISO 4217 通貨コード。利用可能な通貨コードを参照してください。
referencePriceAmount	string	必須	参照価格の数値。
countryPrices[<country_code>]	string	任意	指定された国での価格。
locales[<language_code>][title]	string	任意	指定された言語でのタイトル。
locales[<language_code>][description]	string	任意	指定された言語での説明。
locales[<language_code>][isDefault]	boolean	任意	この言語をデフォルトとして設定します。

レスポンス

成功

API 呼び出しが HTTP 200 ステータスコードを返した場合、リクエストは成功し、アプリ内製品は正常に更新されました。

例

アプリ com.example.app 内のアプリ内製品 product01 の例。参照価格は 1 EUR、アメリカ合衆国（US）の国別価格は 2 USD に設定され、英語（en）用のローカライズされたコンテンツを含む（cURL）

curl -X PATCH "https://ws.catappult.io/api/applications/com.example.app/consumables/product01?operatingSystem=android" \
  -H "Api-Key: YOUR_API_KEY" \
  -F "referencePriceCurrency=EUR" \
  -F "referencePriceAmount=1" \
  -F "countryPrices[US]=2" \
  -F "locales[en][title]=Title" \
  -F "locales[en][description]=Description" \
  -F "locales[en][isDefault]=true"