公開
設定を更新
可視性・メンテナンス・ソースロケールを切替。いつでも完全に可逆。
PATCH
設定を更新
PATCH https://api-datahub.octoparse.com/v1/data-apps/{app_id}/settings
認証:APIキー必須(Authorization: Bearer <API Key>)。App 作者のみ。他者は 404。
App 単位の可逆的な運用状態で、ライフサイクルとは独立しており、いつでも調整できる:
scope:publicはマーケットに表示、privateは作者のみ、sharedは grant リスト(リストは grant 系エンドポイントで管理)。accepting_runs:メンテナンススイッチ。falseはメンテナンス中を意味し、他者からの新しい実行は拒否される(403 app-not-accepting-runs、messageにpause_messageが入る)。既存の実行、購入済みのデータ、マーケットでの表示には影響せず、作者のセルフテストも制限されない。上流の復旧後にtrueに戻せばよく、ライフサイクルの変更は不要。source_locale:マニフェストのテキストの言語(例:zh-CN/en-US)。未設定の場合はデプロイメントの既定値を使う。他言語の翻訳はこのソースの上に重ねられる。新しいソースロケールに既に翻訳がある場合、レスポンスにtranslation-shadowed-by-source警告が含まれ、翻訳は自動削除されない。
リクエスト
パスパラメータ
string
必須
App の参照。
リクエスト body
enum
公開範囲:
public / private / shared。指定可能な値:public / private / shared。boolean
他者からの新しい実行を受け付けるかどうか。
string
メンテナンス中に呼び出し元へ表示するメッセージ。
string
マニフェストのソースロケールコード。
リクエスト例
レスポンス
200 成功
data に包まれます。フィールド:
string
必須
現在の公開範囲。
boolean
必須
現在のメンテナンススイッチ。
string
現在のメンテナンスメッセージ。
string
必須
現在のソースロケール。
object[]
構造化された警告。
エラー
エラー応答は
{"error": {code, category, message, retryable}} です。エラー を参照。