機械翻訳について

移動先

• リクエスト
• レスポンス

タクソノミの公開

post

/content/management/api/v1.1/taxonomies/{id}/publish

昇格されたタクソノミを選択されたチャネルに公開します。 同じプロモート・タクソノミの既存のアセット・カテゴリ分けが、選択したチャネルで使用可能になります。 ユーザーは、プロモートされているタクソノミのバージョンが同じである場合にのみ、選択したチャネルのコントリビュータである必要があります。 タクソノミのプロモート済バージョンが公開済バージョンと異なる場合、ユーザーは選択したチャネルおよび以前に公開されたすべてのチャネルのコントリビュータである必要があります。 タクソノミでアクティブにできるのは、一度に1つの公開リクエストまたは非公開リクエストのみです。 プロモートされたタクソノミでパブリッシュが進行中の場合、以降のリクエストは最初のパブリッシュが完了するまで失敗します。

リクエスト

パス・パラメータ

• id: string
  タクソノミのId。

問合せパラメータ

• links(optional): string
  このパラメータは、リンク名のカンマ区切りのリストを受け入れます。 デフォルトでは、このパラメータによって、適用可能なすべてのリンクが指定されます。 可能な値は次のとおりです: self, canonical, describedby

ヘッダー・パラメータ

• X-Requested-With: string
  CSRF攻撃を軽減するためのカスタム・ヘッダー。

  許容値: [ "XMLHttpRequest" ]

本文()

タクソノミ公開リクエスト・ペイロード。 現在、「プロモート済」のタクソノミのみを公開できるため、statusとversionは使用できません。 これは非同期的な操作です。 非同期リクエストは、ロケーション・ヘッダーにステータス・リンクがある202ステータスで応答します。

ルート・スキーマ : TaxonomyOperationPublishRequest

型: object

タクソノミ操作公開リクエスト

ソースを表示

• channels(optional): array channels
  公開チャネルのリスト。 パラメータ・チャネルは、最初のタクソノミの公開には必須です。 チャネルが初めて空の場合、エラー・メッセージが返されます。 チャネルが空だが、タクソノミがまだ他のチャネルに公開されている場合、新しいバージョンが現在のチャネルに公開されます。 チャネルが空でない場合、特定のチャネルと以前に公開されているチャネルにタクソノミが公開されます(新しい上位レベルのバージョンが使用可能な場合)。
• status(optional): string
  タクソノミのステータス(ドラフト/促進済)。 プロモートされたタクソノミのみを公開できるため、これは公開リクエストでは無視されます。
• version(optional): integer(int32)
  タクソノミのバージョン。 現在、バージョン・フィールドは無視されます。

{
    "type":"object",
    "properties":{
        "status":{
            "type":"string",
            "description":"Status of the Taxonomy (draft/promoted). This is ignored for a publishing request since only promoted taxonomies can be published."
        },
        "version":{
            "type":"integer",
            "format":"int32",
            "description":"Version of a Taxonomy. The version field is currently ignored."
        },
        "channels":{
            "type":"array",
            "description":"List of publish channels. Parameter channels is mandatory for the first taxonomy publishing. If channels is empty for the first time, an error message will be returned. If channels is empty but taxonomy is still published to other channels, a new version will be published to the current channels. If channels is not empty, taxonomy is published to given channels and any previously published channels (in case a new promoted version is available).",
            "items":{
                "$ref":"#/definitions/ChannelId"
            }
        }
    },
    "description":"Taxonomy Operation Publish Request"
}

ネストされたスキーマ : channels

型: array

公開チャネルのリスト。 パラメータ・チャネルは、最初のタクソノミの公開には必須です。 チャネルが初めて空の場合、エラー・メッセージが返されます。 チャネルが空だが、タクソノミがまだ他のチャネルに公開されている場合、新しいバージョンが現在のチャネルに公開されます。 チャネルが空でない場合、特定のチャネルと以前に公開されているチャネルにタクソノミが公開されます(新しい上位レベルのバージョンが使用可能な場合)。

ソースを表示

• Array of: object ChannelId
  ChannelId

{
    "type":"array",
    "description":"List of publish channels. Parameter channels is mandatory for the first taxonomy publishing. If channels is empty for the first time, an error message will be returned. If channels is empty but taxonomy is still published to other channels, a new version will be published to the current channels. If channels is not empty, taxonomy is published to given channels and any previously published channels (in case a new promoted version is available).",
    "items":{
        "$ref":"#/definitions/ChannelId"
    }
}

ネストされたスキーマ : ChannelId

型: object

ChannelId

ソースを表示

• id(optional): string
• isPrimaryChannel(optional): boolean
  チャネルがアセットのプライマリかどうかを示します。
• links(optional): array links
  リンク
• name(optional): string

{
    "type":"object",
    "properties":{
        "id":{
            "type":"string"
        },
        "name":{
            "type":"string"
        },
        "isPrimaryChannel":{
            "type":"boolean",
            "description":"Indicates if channel is primary for an asset."
        },
        "links":{
            "type":"array",
            "description":"Links",
            "items":{
                "$ref":"#/definitions/Link"
            }
        }
    },
    "description":"ChannelId"
}

ネストされたスキーマ: links

型: array

リンク

ソースを表示

• Array of: object Link
  リソースのリンク。

{
    "type":"array",
    "description":"Links",
    "items":{
        "$ref":"#/definitions/Link"
    }
}

ネストされたスキーマ: Link

型: object

リソースのリンク。

ソースを表示

• href(optional): string
  ターゲット・リソースのURI それはテンプレートURIである可能性があります。 これはレスポンス取得の必須プロパティです。
• mediaType(optional): string
  メディア・タイプ。
• method(optional): string
  ターゲット・リソースへのアクセスに使用できるHTTPメソッド。
• profile(optional): string
  ターゲット・リソースを記述するメタデータにリンクします。
• rel(optional): string
  関連タイプ これはレスポンス取得の必須プロパティです。
• templated(optional): boolean
  URIがテンプレートであるかどうか。

{
    "type":"object",
    "properties":{
        "href":{
            "type":"string",
            "description":"The target resource's URI. It could be template URI. It is a required property in the get response."
        },
        "rel":{
            "type":"string",
            "description":"Relation type. It is a required property in the get response."
        },
        "templated":{
            "type":"boolean",
            "description":"Whether the URI is a template."
        },
        "method":{
            "type":"string",
            "description":"What HTTP method can be used to access the target resource."
        },
        "profile":{
            "type":"string",
            "description":"Link to the metadata that describes the target resource."
        },
        "mediaType":{
            "type":"string",
            "description":"Media type."
        }
    },
    "description":"Link of the resource."
}

トップに戻る

レスポンス

サポートされているメディア・タイプ

• application/json

202レスポンス

Accepted.

400レスポンス

不正リクエスト

403レスポンス

禁止。

404レスポンス

タクソノミが見つかりません。 リクエストしたリソースが見つかりません。

409レスポンス

リクエストされたリソース操作は一時的に使用できません

500レスポンス

内部サーバー・エラー

先頭に戻る