機械翻訳について

移動

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

バリエーション・タイプ別アイテム・バリエーションの取得

get

/content/published/api/v1.1/items/{id}/variations/{varType}

品目の変動タイプの品目バリエーションを取得します。

リクエスト

パス・パラメータ

• id: string
  アイテムの一意の識別子(ID)。
• varType: string
  変動のタイプ。 可能な値: language

問合せパラメータ

• links(optional): string
  クライアントが結果に必要とするrel (リレーション)リンクのコンマ区切りのリストを受け入れます。 デフォルトでは、リソース内のすべての適用可能なリンクがレスポンスに含まれます。 可能な値は次のとおりです: self, canonical, describedby。
  例: links=self,canonicalは、relプロパティselfまたはcanonicalを持つリンクのみを返します。

トップに戻る

レスポンス

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

• application/json

200レスポンス

操作の成功

本文()

ルート・スキーマ : VariationsInfo

型: object

バリエーション情報。

Show Source

• items(optional): array items
  コンテンツ・アイテムのバリエーション。
• links(optional): array links
• masterItem(optional): string
  マスター・アイテム。
• setId(optional): string
  変動セットId。
• varType(optional): string
  バリエーション・タイプ名です。

{
    "type":"object",
    "properties":{
        "setId":{
            "type":"string",
            "description":"Variation set id."
        },
        "varType":{
            "type":"string",
            "description":"Variation type name."
        },
        "masterItem":{
            "type":"string",
            "description":"Master item."
        },
        "items":{
            "type":"array",
            "description":"Content item variations.",
            "items":{
                "$ref":"#/definitions/Language"
            }
        },
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/Link"
            }
        }
    },
    "description":"Variations Info."
}

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

型: array

コンテンツ・アイテムのバリエーション。

Show Source

• Array of: object Language
  LanguageItem

{
    "type":"array",
    "description":"Content item variations.",
    "items":{
        "$ref":"#/definitions/Language"
    }
}

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

型: array

Show Source

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

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

ネストされたスキーマ : 言語

型: object

LanguageItem

Show Source

• id(optional): string
  アイテムのId。
• links(optional): array links
• value(optional): string
  言語値

{
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"id of the item."
        },
        "value":{
            "type":"string",
            "description":"Language value"
        },
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/Link"
            }
        }
    },
    "description":"LanguageItem"
}

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

型: array

Show Source

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

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

ネストされたスキーマ : リンク

型: object

リソースのリンク。

Show Source

• 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."
}

400レスポンス

不正リクエスト。 サーバーは、不正な構文、無効なデータまたはメッセージ・フレーミングのために、クライアント側でリクエストを処理できません。

403レスポンス

禁止。

404レスポンス

見つかりません。

500レスポンス

内部サーバー・エラー

トップに戻る

例

次の例では、コンテンツ・アイテムのバリエーション・タイプのバリエーションを読み取る方法を示します。

curl -i -X GET -H "Accept:application/json" 'http://<hostname>/content/published/api/v1.1/items/{id}/variations/{varType}'

例1

これは、コンテンツ・アイテムのバリエーション・タイプのバリエーションを読み取ります: COREAF9E55FE83E84885A10DDA42B5160A5F、channelToken: 7ffdaa85baae4fbca4b300144f93918c.

/content/published/api/v1.1/items/COREAF9E55FE83E84885A10DDA42B5160A5F/variations/language?channelToken=7ffdaa85baae4fbca4b300144f93918c

レスポンス本文

 {
        "setId": "A9D44312B476147CE05321997B0AAC46",
        "masterItem": "COREAF9E55FE83E84885A10DDA42B5160A5F",
        "items": [
          {
            "id": "CORE4FD93D7B9DF2468DA6C122764D0AA85E",
            "value": "fr",
            "links": [
              {
                "href": "https://<hostname>/content/published/api/v1.1/items/CORE4FD93D7B9DF2468DA6C122764D0AA85E?channelToken=7ffdaa85baae4fbca4b300144f93918c",
                "rel": "self",
                "method": "GET",
                "mediaType": "application/json"
              }
            ]
          },
          {
            "id": "COREAF9E55FE83E84885A10DDA42B5160A5F",
            "value": "en-US",
            "links": [
              {
                "href": "https://<hostname>/content/published/api/v1.1/items/COREAF9E55FE83E84885A10DDA42B5160A5F?channelToken=7ffdaa85baae4fbca4b300144f93918c",
                "rel": "self",
                "method": "GET",
                "mediaType": "application/json"
              }
            ]
          }
        ],
        "links": [
          {
            "href": "https://<hostname>/content/published/api/v1.1/items/COREAF9E55FE83E84885A10DDA42B5160A5F/variations/language?channelToken=7ffdaa85baae4fbca4b300144f93918c",
            "rel": "self",
            "method": "GET",
            "mediaType": "application/json"
          },
          {
            "href": "https://<hostname>/content/published/api/v1.1/items/COREAF9E55FE83E84885A10DDA42B5160A5F/variations/language?channelToken=7ffdaa85baae4fbca4b300144f93918c",
            "rel": "canonical",
            "method": "GET",
            "mediaType": "application/json"
          },
          {
            "href": "https://<hostname>/content/published/api/v1.1/metadata-catalog/items/COREAF9E55FE83E84885A10DDA42B5160A5F/variations/language?channelToken=7ffdaa85baae4fbca4b300144f93918c",
            "rel": "describedby",
            "method": "GET",
            "mediaType": "application/schema+json"
          }
        ]
      }

例2

これにより、公開デジタル・アイテムのIDタイプの言語が読み取られます : CONTAF9E55FE83E84885A10DDA42B5160A5F、channelToken:7ffdaa85baae4fbca4b300144f93918c。

/content/published/api/v1.1/items/CONTAF9E55FE83E84885A10DDA42B5160A5F/variations/language?channelToken=7ffdaa85baae4fbca4b300144f93918c

レスポンス本文

{
        "setId": "A9D44312B476147CE05321997B0AAC46",
        "masterItem": "CONTAF9E55FE83E84885A10DDA42B5160A5F",
        "items": [
          {
            "id": "CONT4FD93D7B9DF2468DA6C122764D0AA85E",
            "value": "fr",
            "links": [
              {
                "href": "https://<hostname>/content/published/api/v1.1/items/CONT4FD93D7B9DF2468DA6C122764D0AA85E?channelToken=7ffdaa85baae4fbca4b300144f93918c",
                "rel": "self",
                "method": "GET",
                "mediaType": "application/json"
              }
            ]
          },
          {
            "id": "CONTAF9E55FE83E84885A10DDA42B5160A5F",
            "value": "en-US",
            "links": [
              {
                "href": "https://<hostname>/content/published/api/v1.1/items/CONTAF9E55FE83E84885A10DDA42B5160A5F?channelToken=7ffdaa85baae4fbca4b300144f93918c",
                "rel": "self",
                "method": "GET",
                "mediaType": "application/json"
              }
            ]
          }
        ],
        "links": [
          {
            "href": "https://<hostname>/content/published/api/v1.1/items/CONTAF9E55FE83E84885A10DDA42B5160A5F/variations/language?channelToken=7ffdaa85baae4fbca4b300144f93918c",
            "rel": "self",
            "method": "GET",
            "mediaType": "application/json"
          },
          {
            "href": "https://<hostname>/content/published/api/v1.1/items/CONTAF9E55FE83E84885A10DDA42B5160A5F/variations/language?channelToken=7ffdaa85baae4fbca4b300144f93918c",
            "rel": "canonical",
            "method": "GET",
            "mediaType": "application/json"
          },
          {
            "href": "https://<hostname>/content/published/api/v1.1/metadata-catalog/items/CONTAF9E55FE83E84885A10DDA42B5160A5F/variations/language?channelToken=7ffdaa85baae4fbca4b300144f93918c",
            "rel": "describedby",
            "method": "GET",
            "mediaType": "application/schema+json"
          }
        ]
      }
    }

トップに戻る