adjust-icon

Vaultエンドポイント

アカウントの認証情報(クラウドストレージの認証情報やPlayストアのキーなど)を保存するには、/vaultエンドポイントを使用してください。アプリオートメーションでは、テンプレートアプリから他のアプリに設定を移行する際にこれらの認証情報を使用するため、リクエストごとに送信する必要はありません。

保存するデータは暗号化されます。APIがそれをプレーンテキストで返すことはありません。

仕組み

  • 保管庫レコードはアカウントに属しています。そのアカウント内のすべてのアプリで使用でき、他のアカウントから読み取ることはできません。
  • レコードはsectionとstoreによって識別されます。既存のsectionとstoreの組み合わせにデータを保存すると、そのレコードのデータが置き換えられます。
  • APIは各レコードのdataのみを暗号化された形式で返します。後で確認する必要がある場合に備えて、認証情報のコピーを保管してください。

保管庫を使用するセクション

移行中に保管庫から認証情報を読み取るアプリセクションは次のとおりです。

セクションstore次に保存する内容 data使用するタイミング
csv_upload_settings省略クラウドストレージの認証情報を含むJSON文字列。CSVアップロード用の認証情報をご覧ください。対象アプリには、クラウドストレージの認証情報がまだありません。このセクションにはレコードを1件だけ保存してください。
purchase_verificationgooglePlayストアのキー(文字列)。対象のアプリはAndroidアプリです。

app_infoセクションおよびsignatureセクションのデータは保存できません。

CSVアップロード認証情報

csv_upload_settingsの場合、dataはJSON文字列です。その内容は、ストレージのタイプによって異なります。

Amazon S3

パラメーターデータタイプ必須説明
typeStringはいS3である必要があります。
bucketStringはいバケット名。
keyStringはいアクセスキーID。
secretStringはいシークレットアクセスキー。
regionStringいいえAWSバケットのリージョン。

Google Cloud Storage

パラメーターデータタイプ必須説明
typeStringはいGCSである必要があります。
bucketStringはいバケット名。
secretObjectはいJSONオブジェクトとしてのサービスアカウントキー。

保管庫レコードを作成または更新する

セクションの認証情報を保存します。同じsectionとstoreのレコードが存在する場合、そのデータは置き換えられます。

APIプロトコル

エンドポイント: https://automate.adjust.com/app-automation/vault

メソッド: POST

リクエスト本文: 保管庫作成リクエスト

レスポンス: 保管庫レコード

例

CSVアップロード用にAmazon S3の認証情報を保存する

リクエスト - cURL
curl --location 'https://automate.adjust.com/app-automation/vault' \
--header 'Authorization: Bearer {your-adjust-api-token}' \
--header 'Content-Type: application/json' \
--data '{
"section": "csv_upload_settings",
"data": "{\"type\": \"S3\", \"bucket\": \"my-export-bucket\", \"key\": \"{access-key-id}\", \"secret\": \"{secret-access-key}\", \"region\": \"eu-central-1\"}"
}'
レスポンス
{
"id": 1,
"account_id": 12345,
"section": "csv_upload_settings",
"store": null,
"data": "{encrypted-data}",
"created_at": "2026-10-01T09:30:00"
}

購入認証用のPlayストアキーを保存してください

リクエスト - cURL
curl --location 'https://automate.adjust.com/app-automation/vault' \
--header 'Authorization: Bearer {your-adjust-api-token}' \
--header 'Content-Type: application/json' \
--data '{
"section": "purchase_verification",
"store": "google",
"data": "{play-store-key}"
}'

エラー

ステータスコード説明
400このセクションはサポートされていません。app_infoまたはsignatureのデータを保存できません。
422リクエスト本文が無効です。たとえば、sectionまたはstoreの値が不明であるか、dataがありません。

保管庫レコードを取得する

アカウント内のすべての保管庫レコードを取得します。各レコードのdataは暗号化されています。

APIプロトコル

エンドポイント: https://automate.adjust.com/app-automation/vault

メソッド: GET

レスポンス: Vaultレコードの配列

例

リクエスト - cURL
curl --location 'https://automate.adjust.com/app-automation/vault' \
--header 'Authorization: Bearer {your-adjust-api-token}'
レスポンス
[
{
"id": 1,
"account_id": 12345,
"section": "csv_upload_settings",
"store": null,
"data": "{encrypted-data}",
"created_at": "2026-10-01T09:30:00"
},
{
"id": 2,
"account_id": 12345,
"section": "purchase_verification",
"store": "google",
"data": "{encrypted-data}",
"created_at": "2026-10-01T09:32:00"
}
]

データモデル

Vault作成リクエスト

パラメーターデータタイプ説明
section*String認証情報に対応するアプリセクション。app_infoとsignatureはサポートされていません。
storeString認証情報の対象となるストア。次のいずれかを使用:googleまたはitunes。認証情報がストア固有でない場合は、省略してください。
data*String保存する認証情報。APIは値を保存する前に暗号化します。

保管庫レコード

パラメーターデータタイプ説明
id*IntegerレコードID。
account_id*Integerレコードが属するアカウントのID。
section*String認証情報の対象となるアプリセクション。
storeString認証情報の対象となるストア:googleまたはitunes。未設定の場合はnull。
data*String暗号化された形式で保存された認証情報。APIがプレーンテキストを返すことはありません。
created_at*Stringレコード作成時のISO形式のdatetime。