API経由でのカタログ自動更新
In-Game Store APIコールを使用して、カタログの作成と更新を自動化できます。自動化により、時間をかけずにカタログを最新の状態に保つことができます。カタログ自動化では、アイテムやプロモーションの作成と更新、外部システムからのデータのインポートを行うことができます。
そのため、以下のことをメンテナンスや更新にかかる時間が短縮されます:
- たくさんの商品が記載されているカタログ
- あらゆる種類のプロモーション
- 国別価格
ユーザーエンゲージメントを維持するためには、アイテムカタログを作成した後もエクソーラ側で最新の状態に保つことが重要です。製品の追加や価格の変更など、お客様側で更新が発生した場合には、エクソーラ側のカタログを更新することをお勧めします。
次のことができます:
基本認証は、アイテムやプロモーションを作成または更新するためのAPIコールに使用されます。Authorization:Basic <your_authorization_basic_key>
を渡し、そこで、<your_authorization_basic_key>
はマーチャントID:APIキーペア、はBase64規格に基づいてエンコードされています。アドミンページに移動して、以下のパラメータを見つかります:
- マーチャントIDは以下の場所で表示されます:
- 会社設定 > 会社セクション。
- アドミンページページのブラウザーアドレスバーのURL。URLは以下の形式があります:
https://publisher.xsolla.com/<merchant ID>/<Publisher Account section>
。
- APIキーは、作成時に一度だけアドミンページに表示され、お客様側で保存する必要があります。次のセクションで新しいキーを作成できます:
- 会社設定 > APIキー
- プロジェクト設定 > APIキー
アイテムの作成と更新
複数のアイテムを作成する必要がある場合は、必要なアイテムタイプのAPIメソッドを必要な回数だけ呼び出すスクリプトを作成することができます。
アイテムリクエストに対する応答で返されるパラメータのリストは、カタログを更新する際に渡す必要のあるパラメータのリストとは異なります。必須パラメータおよび更新されたパラメータに加えて、アイテム更新メソッドで、アイテムリクエストに対する応答で返されるパラメータを渡します。
例:
仮想アイテムを取得するメソッドでは、ユーザーの制限データを持つ
仮想アイテム
カタログを更新するには:
- 仮想アイテムを取得するまたはすべての仮想アイテムのリストを取得API メソッドを使用してカタログからデータを取得します
- 仮想アイテムを更新するAPIメソッドを使用して新しいパラメータ値を渡します。
仮想アイテムを作成するには、仮想アイテムを作成するAPIメソッドを使用します。
バンドル
カタログを更新するには:
- バンドルのリストを取得するAPIメソッドを使用してカタログからデータを取得します。
- バンドルを更新するAPIメソッドを使用して新しいパラメータ値を渡します。
バンドルを作成するには、バンドルを作成するAPIメソッドを使用します。
ゲームキー、国の制限、または価格をバンドルに追加する場合は、説明を使用してください。
プロモーションの作成と更新
クーポン
プロモーションを更新するには:
- クーポンのプロモーションを取得するまたはクーポンのプロモーションのリストからデータを取得します。
- クーポンのプロモーションを更新するAPIメソッドを使用して新しいパラメータ値を渡します。
- クーポンのプロモーションをアクティブ化するAPIメソッドを使用してプロモーションをアクティブにします。
プロモーションを作成するには、クーポンプロモーションを作成するAPIメソッドを使用してから、クーポンコードの作成でカスタムクーポンコードを作成するか、クーポンコードの生成でランダムなクーポンコードを生成します。
プロモーションを非アクティブ化するには、クーポンプロモーションを非アクティブ化するAPIメソッドを使用します。
プロモーションコード
プロモーションを更新するには:
- プロモーションコードのプロモーションを取得するまたはプロモーションコードのプロモーションのリストを取得するAPI メソッドを使用してカタログからデータを取得します。
- プロモーションコードを更新するAPIメソッドを使用して新しいパラメータ値を渡します。
- プロモーションコードのプロモーションをアクティブ化するAPIメソッドを使用してプロモーションをアクティブにします。
プロモーションを作成するには、プロモーションコードのプロモーションを作成するAPIメソッドを使用してから、ププロモーションコードプロモーションのコードを作成するを使用してカスタムプロモーションコードを作成するか、プロモーションコードプロモーションのコードを生成するを使用してランダムなプロモーションコードを生成します。
プロモーションを無効にするには、プロモーションコードプロモーションを無アクティブ化するAPIメソッドを使用します。
割引
プロモーションを更新するには:
- アイテムのプロモーションを取得するまたはアイテムのプロモーションのリストからデータを取得します。
- アイテムのプロモーションを更新するAPIメソッドを使用して新しいパラメータ値を渡します。
- プロモーションをアクティブ化するAPIメソッドを使用してプロモーションをアクティブにします。
プロモーションを作成するには、アイテムのディスカウントを作成するAPIメソッドを使用します。
プロモーションを非アクティブ化するには、プロモーションを非アクティブ化するAPIメソッドを使用します。
ボーナス
プロモーションを更新するには:
- ボーナスのプロモーションを取得するまたはボーナスのプロモーションのリストからデータを取得します。
- ボーナスのプロモーションを更新するAPIメソッドを使用して新しいパラメータ値を渡します。
- ボーナスのプロモーションをアクティブ化するAPIメソッドを使用してプロモーションをアクティブにします。
プロモーションを作成するには、ボーナスのプロモーションを作成するAPIメソッドを使用します。
プロモーションを非アクティブ化するには、プロモーションを非アクティブ化するAPIメソッドを使用します。
API経由でのアイテムの自動作成
システムからのデータに基づいて複数のアイテムを作成する必要がある場合は、APIを使用してこのプロセスを自動化できます。
次のことを行う必要があります:
- システムからアイテムデータをエクスポートします。
- エクスポートされたデータを、必須なアイテムタイプのAPIメソッドのデータ形式に一致する形式に変換します。
- エクスポートの各アイテムについて、必須なAPIメソッドを呼び出すスクリプトを作成します:
アイテムグループを使用する場合は、アドミンページインターフェースで事前に作成してください。
複数のタイプのアイテムを使用する場合は、次の順序で作成する必要があります:
- アドミンページのアイテムグループ。
- 仮想通貨。
- 仮想アイテム。
- 仮想通貨パッケージ。
- バンドル。
次は想アイテムを作成するメソッドを繰り返し呼び出して仮想アイテムを作成するスクリプトの例です。
スクリプトはJavaScriptとJavaScriptランタイムNode.jsを使って開発されています。
- エクソーラにHTTPリクエストを送信するために、
“node-fetch”
モジュールのfetch
関数をインポートします。
- javascript
import fetch from "node-fetch";
- リクエスト認証に必要な定数を設定します。
と の代わりに、プロジェクトIDとAPIキーの値を挿入し、これらは後続のAPIリクエストで使用するためにBase64でエンコードされます。
- javascript
const projectId = <your project_id from PA>;
const apiKey = <your api key from PA>;
const buff = new Buffer(`${projectId}:${apiKey}`);
const basicAuth = buff.toString('base64')
- リクエストを送信する際に遅延を作成するために使用される
sleep
ヘルパー関数を実装します。これはAPIリクエストレート制限を超えないために必要です。
- javascript
function sleep(ms) {
return new Promise(resolve => setTimeout(resolve, ms));
}
- システムからアイテムデータを取得にはシステム固有の
getItems
関数を実装します。
- javascript
async function getItems() {
// receive items from the original system or read from a pre-prepared file
return items;
}
- 仮想アイテムを作成するAPIコールのデータフォーマットに従ってアイテムデータをフォーマットするには、システム固有の
prepareData
関数を実装します。
- javascript
function prepareData(items) {
// format items in accordance with API requirements
return formattedItems;
}
POST
リクエストをXsolla APIに送信して仮想アイテムを作成するcreateItem
関数を追加します。
- javascript
async function createItem(item) {
const url = `https://store.xsolla.com/api/v2/project/${projectId}/admin/items/virtual_items`;
return await fetch(url, {
method: "POST",
headers: {
Authorization: "Basic " + basicAuth,
"Content-Type": "application/json"
},
body: JSON.stringify(item),
});
}
- 指定したSKUの仮想アイテムが存在するかどうかを確認する
checkItemExist
関数を追加します。この関数はXsolla APIにGET
リクエストを送信します:- 指定されたSKUのアイテムが見つからない場合は、
404
のHTTPコードの応答が受信され、作成する必要があります。 200
のHTTPコードを含む応答を受信した場合、指定されたSKUを持つアイテムが見つかり、作成する必要はありません。
- 指定されたSKUのアイテムが見つからない場合は、
- javascript
async function checkItemExist(sku) {
const url = `https://store.xsolla.com/api/v2/project/${projectId}/admin/items/virtual_items/sku/${sku}`;
const response = await fetch(url, {
method: "GET",
headers: {
Authorization: "Basic " + basicAuth
}
});
return response.status !== 404;
}
- アイテムのリストを処理し、エクソーラ側にシステムのSKUを持つアイテムが存在するかどうかを確認する
createItems
関数を追加します。該当するSKUを持つアイテムがない場合、関数はアイテムを作成します。進行状況がコンソールに表示されます。
- javascript
async function createItems(items) {
let success = 0;
let alreadyCreated = 0;
for (let i = 0; i < items.length; i++) {
const item = items[i];
if (item['sku'] === undefined) {
console.log(`${i} Field "sku" not specified`);
continue;
}
const sku = item['sku'];
if (await checkItemExist(sku)) {
console.log(`${i} Item with sku "${sku}" already created`);
alreadyCreated++;
continue;
}
const response = await createItem(item);
if (response.status === 201) {
console.log(`${i} Item with sku "${sku}" successfully created`)
success++;
} else {
const jsonData = await response.json();
console.log(`${i} An error occurred while creating the items with sku "${sku}"`);
console.log(jsonData);
}
// add a delay so as not to run into rate limits
await sleep(500);
}
console.log(`${success} items out of ${items.length} created. ${alreadyCreated} items already existed`);
}
- 正しい順序で上記のすべての関数を呼び出す
run
関数を追加します。
- javascript
async function run() {
const items = await getItems();
const formattedItems = prepareData(items);
await createItems(formattedItems);
}
完全なコードは:
- javascript
import fetch from "node-fetch";
const projectId = <your project_id from PA>;
const apiKey = <your api key from PA>;
const buff = new Buffer(`${projectId}:${apiKey}`);
const basicAuth = buff.toString('base64')
function sleep(ms) {
return new Promise(resolve => setTimeout(resolve, ms));
}
async function getItems() {
// receive items from the original system or read from a pre-prepared file
return items;
}
function prepareData(items) {
// format items in accordance with API requirements
return formatedItems;
}
async function createItem(item) {
const url = `https://store.xsolla.com/api/v2/project/${projectId}/admin/items/virtual_items`;
return await fetch(url, {
method: "POST",
headers: {
Authorization: "Basic " + basicAuth,
"Content-Type": "application/json"
},
body: JSON.stringify(item),
});
}
async function isItemExisted(sku) {
const url = `https://store.xsolla.com/api/v2/project/${projectId}/admin/items/virtual_items/sku/${sku}`;
const response = await fetch(url, {
method: "GET",
headers: {
Authorization: "Basic " + basicAuth
}
});
return response.status !== 404;
}
async function createItems(items) {
let success = 0;
let alreadyCreated = 0;
for (let i = 0; i < items.length; i++) {
const item = items[i];
if (item['sku'] === undefined) {
console.log(`${i} Field "sku" not specified`);
continue;
}
const sku = item['sku'];
if (await isItemExisted(sku)) {
console.log(`${i} Item with sku "${sku}" already created`);
alreadyCreated++;
continue;
}
const response = await createItem(item);
if (response.status === 201) {
console.log(`${i} Item with sku "${sku}" successfully created`)
success++;
} else {
const jsonData = await response.json();
console.log(`${i} An error occurred while creating the items with sku "${sku}"`);
console.log(jsonData);
}
// add a delay so as not to run into rate limits
await sleep(500);
}
console.log(`${success} items out of ${items.length} created. ${alreadyCreated} items already existed`);
}
async function run() {
const items = await getItems();
const formattedItems = prepareData(items);
await createItems(formattedItems);
}
run();
外部システムからインポートして更新する
PlayFabやGoogle Playなどの外部システムからデータをインポートするには、説明に従ってください。
誤字脱字などのテキストエラーを見つけましたか? テキストを選択し、Ctrl+Enterを押します。