機械翻訳について

バージョンIDによるコンテンツの更新

patch

/km/api/v1/content/{versionId}

このメソッドは、バージョンを増分せずに、指定されたコンテンツ・バージョンの値を更新します。

このメソッドのURIの例を次に示します:

  • http://<IM_REST_API_HOST>/km/api/latest/content/{versionId}

    リクエストは、更新されたContentBOを返します。

  • ノート: 現在、このサービスはHTTPヘッダー・パラメータX-HTTP-Method-Overrideを介したHTTP PATCHをサポートしています。

    クライアントには、ヘッダーX-HTTP-Method-Override値PATCHを持つコールPOSTがあります。

クライアントは、次から1つまたは複数の値を送信してリクエストで更新できます。

  • ContentUpdateBO.owner - 新規所有者をコンテンツ・バージョンに割り当てます。

  • ContentUpdateBO.articleStatus - コンテンツ・バージョンにarticleStatusを割り当てる場合。

レスポンス・エラー

このメソッドの考えられるエラー・レスポンスは次のとおりです:

  • OKDOM-GEN0001

    このエラーは、次のいずれかの場合に発生します:

    • 新しい値のデータが見つかりません。
    • 指定したバージョンIDでコンテンツが見つかりません。
  • $ERROR.Content.INACTIVE_ARTICLE_STATUS_ASSIGNED$

    このエラーは、リクエストで指定されたContentUpdateBO.articleStatusが非アクティブである場合に発生します。

  • $ERROR.Content.ARTICLE_STATUS_FEATURE_NOT_AVAILABLE$

    このエラーは、リクエストでContentUpdateBO.articleStatusが指定され、記事ステータス機能が使用できない場合に発生します。

リクエスト

サポートされるメディア・タイプ
パス・パラメータ
本文( )
新しい値オブジェクト。
ルート・スキーマ : ContentUpdate
タイプ: object
タイトル: ContentUpdate
ソースを表示
ネストされたスキーマ : ArticleStatusKey
タイプ: object
タイトル: ArticleStatusKey
ソースを表示
ネストされたスキーマ : UserKey
タイプ: object
タイトル: UserKey
ソースを表示
  • ユーザー・オブジェクトの電子メール
  • ExternalIdは、外部システムからの対応するユーザーのIDです。 ExternalTypeとともに、このシステムからのユーザーと外部システムのユーザーとの間のギャップを埋めるために使用できます。
  • ExternalTypeは、外部システムからの対応するユーザーのタイプです。 ExternalIdとともに使用すると、このシステムからのユーザーと外部システムのユーザーとの間のギャップを埋めることができます。
  • links
  • ユーザーのフルネーム
  • ユーザー・オブジェクトの一意のレコードID。
トップに戻る

レスポンス

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

200 レスポンス

「OK」をクリックします。
本文( )
ルート・スキーマ : ContentKey
タイプ: object
タイトル: ContentKey
ソースを表示
ネストされたスキーマ : allTranslations
タイプ: array

このフィールドは、ユーザーが表示できるすべての翻訳済コンテンツのリストを返します

このフィールドは、allTranslations問合せパラメータが値trueで渡された場合にのみ移入されます。

ソースを表示
ネストされたスキーマ : ArticleStatusKey
タイプ: object
タイトル: ArticleStatusKey
ソースを表示
ネストされたスキーマ : LocaleKey
タイプ: object
タイトル: LocaleKey
ソースを表示
ネストされたスキーマ : DataForm
タイプ: object
タイトル: DataForm
ソースを表示
ネストされたスキーマ : AggregateFormResults
タイプ: object
タイトル: AggregateFormResults
ソースを表示
ネストされたスキーマ : schemaAttributes
タイプ: array

このフィールドには、このコンテンツのコンテンツ・タイプに関連付けられたスキーマ属性のリストが返されます。

このフィールドは、additionalFields問合せパラメータが値schemaAttributesとともに渡された場合にのみ移入されます。

ソースを表示
ネストされたスキーマ : 質問
タイプ: array
質問と多数の関係
ソースを表示
ネストされたスキーマ : UserKey
タイプ: object
タイトル: UserKey
ソースを表示
  • ユーザー・オブジェクトの電子メール
  • ExternalIdは、外部システムからの対応するユーザーのIDです。 ExternalTypeとともに、このシステムからのユーザーと外部システムのユーザーとの間のギャップを埋めるために使用できます。
  • ExternalTypeは、外部システムからの対応するユーザーのタイプです。 ExternalIdとともに使用すると、このシステムからのユーザーと外部システムのユーザーとの間のギャップを埋めることができます。
  • links
  • ユーザーのフルネーム
  • ユーザー・オブジェクトの一意のレコードID。
ネストされたスキーマ : ビュー
タイプ: array
表示する関係が多すぎます
ソースを表示
ネストされたスキーマ : DataFormQuestion
タイプ: object
タイトル: DataFormQuestion
ソースを表示
ネストされたスキーマ : 答え
タイプ: array
回答との関連性が多すぎます
ソースを表示
ネストされたスキーマ : DataFormKey
タイプ: object
タイトル: DataFormKey
ソースを表示
ネストされたスキーマ : DataFormAnswer
タイプ: object
タイトル: DataFormAnswer
ソースを表示
ネストされたスキーマ : DataFormQuestionKey
タイプ: object
タイトル: DataFormQuestionKey
ソースを表示
ネストされたスキーマ : ViewKey
タイプ: object
タイトル: ViewKey
ソースを表示
ネストされたスキーマ : 質問
タイプ: array
AggregateQuestionResultとの関係が多すぎます
ソースを表示
ネストされたスキーマ : AggregateQuestionResult
タイプ: object
タイトル: AggregateQuestionResult
ソースを表示
ネストされたスキーマ : 答え
タイプ: array
AggregateAnswerResultとの関係が多すぎます
ソースを表示
ネストされたスキーマ : AggregateAnswerResult
タイプ: object
タイトル: AggregateAnswerResult
ソースを表示
ネストされたスキーマ : SchemaAttribute
タイプ: object
タイトル: SchemaAttribute
ソースを表示
ネストされたスキーマ : 子供
タイプ: array
現在の要素の子ノードのリスト
ソースを表示
ネストされたスキーマ : localizedAttributes
タイプ: array
様々なロケールでのこのSchemaAttribute名のLocalizedAttributesおよび説明のリスト
ソースを表示
ネストされたスキーマ : schemaAttributeUserGroupList
タイプ: array
この属性を保護するために使用できるユーザー・グループのリスト。 これは、ContentTypeに割り当てられたユーザー・グループのリストのサブセットである必要があります
ソースを表示
ネストされたスキーマ : LocalizedAttributes
タイプ: object
タイトル: LocalizedAttributes
ソースを表示
ネストされたスキーマ : SchemaAttributeUserGroup
タイプ: object
タイトル: SchemaAttributeUserGroup
ソースを表示
ネストされたスキーマ : UserGroupKey
タイプ: object
タイトル: UserGroupKey
ソースを表示
トップに戻る

次の例は、指定したコンテンツ・バージョンの値をバージョンを増分せずに更新する方法を示しています:

curl -X PATCH "https://<IM_REST_API_HOST>/km/api/latest/content/{versionId}" -u "<username:password>" -H "Accept: application/json" -H "Content-Type: application/json" -d "@<FilePath/RequestBody.json>"

リクエスト本文の例

次に、JSON形式のリクエスト本文の例を示します。

{
  "owner" : {
    "recordId" : "RECORDID_VALUE"
  },
  "articleStatus" : {
    "referenceKey" : "REFERENCEKEY_VALUE"
}
}

レスポンス本文の例

次に、JSON形式のレスポンス本文の例を示します。

{
  "recordId": "27BA7D089309424D86657C14C4B637A6",
  "versionId": "3B5049724B604F21A4F2235E142BA46F",
  "documentId": "FAQ1",
  "title": "Q query  Testing --update",
  "version": "2.0",
  "answerId": 1000018,
  "locale": {
    "recordId": "en_US"
  },
  "dateModified": "2018-11-26T12:46:11+0530",
  "links": [
    {
      "rel": "canonical",
      "href": "https://<IM_REST_API_HOST>/km/api/latest/content/27BA7D089309424D86657C14C4B637A6",
      "mediaType": "application/json, application/xml",
      "method": "GET"
    },
    {
      "rel": "collection",
      "href": "https://<IM_REST_API_HOST>/km/api/latest/content",
      "mediaType": "application/json, application/xml",
      "method": "GET",
      "profile": "https://<IM_REST_API_HOST>/km/api/latest/metadata-catalog/content"
    }
  ]
}
「トップに戻る」