PATCH /api/v2/server-side-api/profile/

プロファイルを更新する

Copy as Markdown

ユーザープロファイル情報を更新します

Header parameters

adapty-customer-user-idstring

お客様のシステムにおける顧客の一意の ID です。adapty-customer-user-id または adapty-profile-id のいずれかが必須です。

adapty-profile-idstring

お客様のシステムにおけるプロファイルの一意の ID です。匿名プロファイルを扱う場合に最適です。adapty-customer-user-id または adapty-profile-id のいずれかが必須です。

Request body

first_namestring

エンドユーザーの名

last_namestring

エンドユーザーの姓

genderstring

エンドユーザーの性別

One of: "f", "m", "o"

emailstring

エンドユーザーのメールアドレス

phone_numberstring

エンドユーザーの電話番号

birthdaystring

エンドユーザーの誕生日

ip_countrystring

ISO 3166-2 形式のエンドユーザーの国

ip_v4_addressstring

エンドユーザーの IPv4 アドレス

store_countrystring

エンドユーザーのアプリストアの国

storestring

ユーザーがアプリ内で購入に使用するプラットフォーム

One of: "app_store", "play_store", "stripe", "adapty", "paddle"

store_account_tokenstring

ストアアカウントトークン

att_statusinteger

Apple App Tracking Transparency ステータス（0=未確定、1=制限あり、2=拒否、3=許可）

One of: 0, 1, 2, 3

analytics_disabledboolean

外部アナリティクスをオプトアウトするオプション

custom_attributesarray of object

プロファイルに最大 30 個のカスタム属性を設定できます

keystringrequired

キーは 30 文字以下の文字列である必要があります。英字、数字、ダッシュ、ピリオド、アンダースコアのみ使用できます

valuestring | numberrequired

属性値は 50 文字以下である必要があります。文字列と浮動小数点数のみ使用できます

installation_metaobjectrequired

device_idstringrequired

デバイスの一意の識別子

devicestring

デバイス情報

localestring

デバイスのロケール

osstring

オペレーティングシステム情報

platformstring

プラットフォーム（iOS、Android など）

One of: "iOS", "macOS", "iPadOS", "Android", "visionOS", "web"

timezonestring

デバイスのタイムゾーン

user_agentstring

ユーザーエージェント文字列

app_buildstring

アプリのビルドバージョン

app_versionstring

アプリのバージョン

adapty_sdk_versionstring

Adapty SDK のバージョン

idfastring

iOS 広告識別子（IDFA）

idfvstring

iOS ベンダー識別子（IDFV）

advertising_idstring

Android 広告 ID

android_idstring

Android デバイス ID

android_app_set_idstring

Android アプリセット ID

Responses

プロファイルが正常に更新されました

Schema

dataobjectrequired

app_idstringrequired

アプリの内部 ID

profile_idstringrequired

Adapty プロファイル ID

customer_user_idstringrequired

お客様のシステムにおけるユーザーの ID

total_revenue_usdnumberrequired

プロファイルで獲得した USD 換算の総収益を表す浮動小数点値

segment_hashstringrequired

内部パラメータ

timestampintegerrequired

レスポンス時刻（ミリ秒）。競合状態の解決に使用します

custom_attributesarray of objectrequired

プロファイルに設定できるカスタム属性は最大 30 個です

keystringrequired

キーは 30 文字以下の文字列である必要があります。英字、数字、ダッシュ、ピリオド、アンダースコアのみ使用できます

valuestring | numberrequired

属性値は 50 文字以下である必要があります。文字列と浮動小数点数のみ使用できます

access_levelsarray of objectrequired

アクセスレベルオブジェクトの配列。顧客がアクセスレベルを持たない場合は空配列

access_level_idstring

アクセスレベルの識別子

storestring

アクセスレベルが購入されたストア

store_product_idstring

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

store_base_plan_idstring

ストアにおけるベースプラン ID

store_transaction_idstring

ストアにおけるトランザクション ID

store_original_transaction_idstring

ストアにおける元のトランザクション ID

offerallOf

プロモーションオファーまたは初回オファーが適用された場合のオファー詳細

categorystring

オファーのカテゴリ

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

typestring

オファーの種別

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

idstring

オファー ID

starts_atstring

アクセスレベルの開始日時

purchased_atstring

アクセスレベルが購入された日時

originally_purchased_atstring

アクセスレベルが最初に購入された日時

expires_atstring

アクセスレベルの有効期限

renewal_cancelled_atstring

更新がキャンセルされた日時

billing_issue_detected_atstring

請求問題が検出された日時

is_in_grace_periodboolean

アクセスレベルがグレース期間中かどうか

cancellation_reasonstring

キャンセルの理由

subscriptionsarray of objectrequired

サブスクリプションオブジェクトの配列。顧客がサブスクリプションを持たない場合は空配列

storestring

サブスクリプションが購入されたストア

store_product_idstring

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

store_base_plan_idstring

ストアにおけるベースプラン ID

store_transaction_idstring

ストアにおけるトランザクション ID

store_original_transaction_idstring

ストアにおける元のトランザクション ID

offerallOf

プロモーションオファーまたは初回オファーが適用された場合のオファー詳細

categorystring

オファーのカテゴリ

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

typestring

オファーの種別

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

idstring

オファー ID

environmentstring

環境（サンドボックス、本番）

purchased_atstring

サブスクリプションが購入された日時

originally_purchased_atstring

サブスクリプションが最初に購入された日時

expires_atstring

サブスクリプションの有効期限

renewal_cancelled_atstring

更新がキャンセルされた日時

billing_issue_detected_atstring

請求問題が検出された日時

is_in_grace_periodboolean

サブスクリプションがグレース期間中かどうか

cancellation_reasonstring

キャンセルの理由

non_subscriptionsarray of objectrequired

非サブスクリプションオブジェクトの配列。顧客が購入履歴を持たない場合は空配列

purchase_idstring

購入の一意の識別子

storestring

購入が行われたストア

store_product_idstring

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

store_base_plan_idstring

ストアにおけるベースプラン ID

store_transaction_idstring

ストアにおけるトランザクション ID

store_original_transaction_idstring

ストアにおける元のトランザクション ID

purchased_atstring

購入が行われた日時

environmentstring

環境（サンドボックス、本番）

is_refundboolean

返金かどうか

is_consumableboolean

消耗型アイテムの購入かどうか

リクエストが不正です

Schema

errorsarray of objectrequired

sourcestring

エラーの発生源

errorsarray of string

エラーメッセージの配列

error_codestringrequired

エラーの短縮名

status_codeintegerrequired

HTTP ステータスコード

認証エラー

Schema

errorsarray of objectrequired

sourcestring

エラーの発生源

errorsarray of string

エラーメッセージの配列

error_codestringrequired

エラーの短縮名

status_codeintegerrequired

HTTP ステータスコード

プロファイルが見つかりません

Schema

errorsarray of objectrequired

sourcestring

エラーの発生源

errorsarray of string

エラーメッセージの配列

error_codestringrequired

エラーの短縮名

status_codeintegerrequired

HTTP ステータスコード

内部サーバーエラー

Try it

Authorization

Header parameters

adapty-customer-user-id

adapty-profile-id

Body

curl --request PATCH \
  --url 'https://api.adapty.io/api/v2/server-side-api/profile/' \
  --header 'Authorization: Api-Key YOUR_SECRET_API_KEY'

const response = await fetch('https://api.adapty.io/api/v2/server-side-api/profile/', {
  method: 'PATCH',
  headers: {
    'Authorization': 'Api-Key YOUR_SECRET_API_KEY',
  },
});
const data = await response.json();

import requests

response = requests.patch('https://api.adapty.io/api/v2/server-side-api/profile/', headers={
    'Authorization': 'Api-Key YOUR_SECRET_API_KEY',
})
data = response.json()