ドキュメント
無料で作る

エンドポイント

ストア掲載文を書く

Google PlayとApp Storeのストアページの文章を、アプリの画面に書かれている内容から作成します。

POSThttps://www.setherion.com/api/v1/projects/{id}/store/listing

プラン： Pro and up

アプリのストアページの文章を、両方のストア分まとめて一度に書きます。アプリ名、Google Playの短い説明と詳しい説明、App Storeのサブタイトル、キーワード、プロモーション用テキストです。「Publish to app stores」ウィンドウのWrite itボタンと同じ作業で、プランの条件も料金も支払う人も同じです。

文章は、アプリの画面に書かれている内容から、その画面の言語で作られます。ライターには、機能、価格、評価、ユーザー数を決して作り上げないこと、そしてストアやアプリを作ったツールの名前を出さないことが指示されています。

アプリを編集できる権限が必要です。アプリのクレジットを使うためです。何も保存されません。結果の文章をオーナーに見せて、Play ConsoleとApp Store Connectにコピーしてもらってください。

費用とプラン

  • クレジット：数クレジットが、作業の前に、アプリの支払いをするアカウントに請求されます。レスポンスのchargedフィールドに、引かれた数が入ります。使える内容が得られなかった場合は、返却されます。
  • プラン：アプリの支払いをするアカウントのProまたはBusinessです。Freeでは、この呼び出しは402を返します。
  • ペース：エディタのほかの小さなAI操作と同じ、1時間あたりの上限で、1アカウントにつき1時間に600回です。人が操作していて上限に達することはありません。

リクエスト

ボディは不要です。

bash
curl -X POST https://www.setherion.com/api/v1/projects/7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14/store/listing \
  -H "Authorization: Bearer $SETHERION_API_KEY"

最大で2分ほどかかります。クライアントのタイムアウトは、2分以上に設定してください。

レスポンス

json
{
  "ok": true,
  "language": "en",
  "charged": 2,
  "limits": {
    "name": 30,
    "googleShort": 80,
    "description": 4000,
    "appleSubtitle": 30,
    "appleKeywords": 100,
    "applePromo": 170
  },
  "texts": {
    "name": "Coffee Shop",
    "googleShort": "Order your coffee and cake ahead and skip the queue.",
    "description": "Coffee Shop is for anyone in Leeds who wants a good coffee without waiting. Browse the menu, choose what you like and collect it when it is ready.\n\n• Browse the full menu with prices\n• Order ahead for collection\n• See the opening hours\n• Find the shop on the map\n\nPick your favourite and skip the queue.",
    "appleSubtitle": "Order ahead, skip the queue",
    "appleKeywords": "coffee,cafe,order ahead,takeaway,cake,Leeds",
    "applePromo": "Your morning coffee, ready when you arrive. Open the menu, order ahead and collect it without waiting."
  }
}
フィールド型意味
languagestring文章が書かれている言語のコードです。アプリの画面から判定されます。
chargednumber引かれたクレジットの数です。クレジットの台帳に接続できず、呼び出しがそのまま通された場合は0です。
limitsobject各フィールドの最大文字数です。ストア自身の上限です。
textsobject文章です。すべてのフィールドが必ず含まれます。

textsのフィールド

フィールド使われる場所上限
name両方のストアでのアプリ名30文字
googleShortGoogle Play、短い説明80文字
description詳しい説明。両方のストアで共通です4,000文字
appleSubtitleApp Store、サブタイトル30文字
appleKeywordsApp Store、キーワード。カンマで区切り、スペースは入れません100文字
applePromoApp Store、プロモーション用テキスト170文字

各フィールドは、上限に収まるよう単語の切れ目で切り詰められます。上限を超えるフィールドはストアのコンソールに拒否され、モデルは文字数を数えるのが苦手だからです。キーワードも整えられます。それぞれ一度だけ現れ、アプリ名に含まれる単語は繰り返されません。詳しい説明はプレーンテキストで、ユーザーができる主なことが1行に1つずつ、•で始まります。

エラー

ステータス発生する場合
401キーがない、間違っている、または無効にされています。
402アプリの支払いをするアカウントがFreeである、クレジットが残っていない、またはあなたに設定されたワークスペースの上限に達しています。
404そのようなアプリがない、またはあなたのキーでは編集できません。
409アプリにまだコードがありません。先にSetherionで作ってください。
429このアカウントで、直近1時間に小さなAI操作が600回を超えました。
500ライターの答えを利用できませんでした。何も請求されず、クレジットは返却されます。もう一度試してください。
503制限機能が一時的に使えないため、何も実行されませんでした。1分後にもう一度試してください。
正確な文言
ステータスerror
402Writing the store page is part of the Pro plan.
402This costs 2 credits and you have 1.
402This app's owner has no credits left this month.
402You have used the credits this workspace allows you this month. Ask an admin to raise your limit.
404No such app on this account.
409This app has no code yet. Build it in Setherion first.
429Too many AI actions in the last hour. Try again later.
500The model did not answer with the store page.
500The model's answer was cut off or not readable.
500The model left out: appleKeywords.
503Usage limits are briefly unavailable, so this was not run. Try again in a minute.

最初の402はFree向けです。2つ目の数字は料金と残高です。他の人のアプリでは、代わりに3つ目の文が返され、その人の残高は出ません。500の行は例です。文は何がうまくいかなかったかを示し、クレジットは返却されます。

このページは役に立ちましたか？

前へ

ストア向けプライバシー回答

次へ

MCPサーバー

コミュニティに参加

質問、アイデア、ほかの人が作っているもの。