機械翻訳について

サイトのコンテンツの検証

post

/sites/management/api/v1/sites/{id}/validate

EXTENDED OPERATION

翻訳に関するエンタープライズ・サイトのページを検証してください。 サイトが検証されると、ページがチェックされ、その翻訳がサイト・チャネルのローカリゼーション・ポリシーおよび言語詳細と一致しているかどうかが確認されます。 ページの詳細ごとに、ページに翻訳の欠落および言語の欠落があるかどうかが示されます。 ページで使用されるアセットも、アセットがドラフトか公開済かなど、各アセットのバージョンを示すリストに表示されます。

リリース19.4.1.での導入。

認可

この操作を起動するには、認証されたユーザーまたはクライアント・アプリケーションがリソースと共有され、次のいずれかの「共有」ロールを持っている必要があります:

  • 所有者
  • マネージャ

パス代替識別子

「サイト」リソースのデフォルトの識別子は、「サイト識別子」です。 サイト・リソースは代替識別子をサポートしています。

nameサイト名

サイト識別子のかわりに、サイト名を使用してリソース・パスのサイトを一意に識別できます。 サイトのデフォルトのリソース・パス・パラメータはサイト識別子ですが、サイトでの作業時には判読可能なサイト名が簡単になる場合があります。

http://api.example.com/sites/management/api/v1/sites/name:MyNewProduct/validate

リリース19.4.1.での導入。

成功したレスポンスの例

この操作は、次の成功(2xx)のレスポンスで応答します。 レスポンスHTTPステータス・コードとサンプル本体の完全なリストは、この操作の「レスポンス」に関する項を参照してください。

200OK - Valid Site Results

検証結果には、siteinfostructureページおよびホーム・ページの詳細が含まれます。

リクエスト

POST https://api.example.com/sites/management/api/v1/sites/{id}/validate

レスポンス本文

{
  "valid": false,
  "pages": [
      {
        "id": "siteinfo",
        "name": "siteinfo",
        "type": "siteinfo",
        "publishable": false,
        "languages": [
            {
              "language": "fr-FR",
              "policyStatus": "required",
              "validation": "missing"
            },
            {
              "language": "de-DE",
              "policyStatus": "optional",
              "validation": "ready"
            },
            {
              "language": "es-ES",
              "policyStatus": "undefined",
              "validation": "excluded"
            }
        ],
        "usedAssets": [
        ]
      },
      {
        "id": "structure",
        "name": "structure",
        "type": "structure",
        "publishable": false,
        "languages": [
            {
              "language": "fr-FR",
              "policyStatus": "required",
              "validation": "missing"
            },
            {
              "language": "de-DE",
              "policyStatus": "optional",
              "validation": "ready"
            },
            {
              "language": "es-ES",
              "policyStatus": "undefined",
              "validation": "excluded"
            }
        ],
        "usedAssets": [
        ]
      },
      {
        "id": "10",
        "name": "Home",
        "type": "page",
        "publishable": false,
        "languages": [
            {
              "language": "fr-FR",
              "policyStatus": "required",
              "validation": "missing"
            },
            {
              "language": "de-DE",
              "policyStatus": "optional",
              "validation": "ready"
            },
            {
              "language": "es-ES",
              "policyStatus": "undefined",
              "validation": "excluded"
            }
        ],
        "usedAssets": [
            {
              "id": "CORED2FDC62C23504F6AB47B1F6106F9DC73",
              "version": "draft"
            },
            {
              "id": "CORE48AF98371AFC4568B260D4417E38A739",
              "version": "published"
            },
            {
              "id": "CONTBD592905665C4652BFEAE6FD19E9F291",
              "version": "draft"
            },
            {
              "id": "CONT9DE7B749A5E9438689492A0054C02707",
              "version": "draft"
            }
        ]
      }
  ]
}

クライアント・エラー・レスポンスの例

この操作は、レスポンス本文に例外の詳細が含まれている次のクライアント・エラー(4xx)レスポンスで応答します。 レスポンスHTTPステータス・コードとサンプル本体の完全なリストは、この操作の「レスポンス」に関する項を参照してください。

403Forbidden - Site Operation Forbidden

サイト内で共有ロールを持つユーザーは、この操作を実行できません。

エラー・コード

OCE-SITEMGMT-009026

解決 - 共有ロールの変更

認証ユーザーに付与された共有ロールを必要なロール以上に変更します。

解決 - アプリケーション・ロールの変更

ユーザーにStandardユーザーまたはエンタープライズ・ユーザー・アプリケーション・ロールがあることを確認します。

例外詳細フィールド

このエラー・タイプでは、レスポンスに次のフィールド/値が含まれます:

フィールド名説明
site操作が実行されているサイト。

この例外の詳細タイプの詳細は、swaggerドキュメントの定義セクションのSiteOperationForbiddenExceptionDetailスキーマを参照してください。

レスポンス本文の例
{
  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
  "title": "Site Operation Forbidden",
  "status": "403",
  "detail": "You do have a sharing role in this site, but your role does not allow you to use this operation.",
  "o:errorCode": "OCE-SITEMGMT-009026",
  "site": {
    "id": "FCA9C0E5CDCB549A19FFB85987A2352778961003B8A0"
  }
}

リリース19.1.5.での導入。

404Not Found - Site Not Found

サイトが存在しないか、削除されたか、認証されたユーザーまたはクライアント・アプリケーションがサイトへのアクセス権を持っていません。

エラー・コード

OCE-SITEMGMT-009003

解決 - 識別子のチェック

サイト識別子が有効であることを確認してください。

解決 - メンバーシップのチェック

認証済ユーザーがサイトのメンバーまたはサイト管理者であることを確認します。

例外詳細フィールド

このエラー・タイプでは、レスポンスに次のフィールド/値が含まれます:

フィールド名説明
site存在しないか、認証されたユーザーが参照できないサイトです。

この例外の詳細タイプの詳細は、swaggerドキュメントの定義セクションのSiteNotFoundExceptionDetailスキーマを参照してください。

レスポンス本文の例
{
  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
  "title": "Site Not Found",
  "status": "404",
  "detail": "Site does not exist or has been deleted, or the authenticated user or client application does not have access to the site.",
  "o:errorCode": "OCE-SITEMGMT-009003",
  "site": {
    "id": "FCA9C0E5CDCB549A19FFB85987A2352778961003B8A0"
  }
}

409Conflict - Site Deleted

ソフト削除されたサイトでは操作を実行できません。 このエラーは、includeDeleted問合せパラメータがtrueに設定されている場合にのみ発生します。

エラー・コード

OCE-SITEMGMT-009059

解決 - サイトのリストア

サイトをリストアしてから操作を再試行してください。

例外詳細フィールド

このエラー・タイプでは、レスポンスに次のフィールド/値が含まれます:

フィールド名説明
siteサイト識別子が指定されている場合、ソフト削除されるサイト。

この例外の詳細タイプの詳細は、swaggerドキュメントの定義セクションのSiteDeletedExceptionDetailスキーマを参照してください。

レスポンス本文の例
{
  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
  "title": "Site Deleted",
  "status": "409",
  "detail": "The operation cannot be performed as the site has been soft deleted.",
  "o:errorCode": "OCE-SITEMGMT-009059",
  "site": {
    "id": "FCA9C0E5CDCB549A19FFB85987A2352778961003B8A0"
  }
}

リリース19.4.1.での導入。

409Conflict - Missing Site Default Language

この操作を実行するには、サイトのデフォルトが必要です。

エラー・コード

OCE-SITEMGMT-001008

レスポンス本文の例
{
  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
  "title": "Missing Site Default Language",
  "status": "409",
  "detail": "Default language for the site is missing.",
  "o:errorCode": "OCE-SITEMGMT-001008"
}

リリース19.4.1.での導入。

409Conflict - Missing Site Localization Policy

この操作を実行するには、サイトにローカリゼーション・ポリシーが必要です。

エラー・コード

OCE-SITEMGMT-009074

レスポンス本文の例
{
  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
  "title": "Missing Site Localization Policy",
  "status": "409",
  "detail": "Localization policy for site is missing.",
  "o:errorCode": "OCE-SITEMGMT-009074"
}

リリース19.4.1.での導入。

409Conflict - Invalid Site Default Language

サイトには、ローカリゼーション・ポリシーの必須言語と一致しないデフォルト言語があります。

エラー・コード

OCE-SITEMGMT-009075

例外詳細フィールド

このエラー・タイプでは、レスポンスに次のフィールド/値が含まれます:

フィールド名説明
defaultLanguageデフォルト言語が無効です。

この例外の詳細タイプの詳細は、swaggerドキュメントの定義セクションのInvalidSiteDefaultLanguageExceptionDetailスキーマを参照してください。

レスポンス本文の例
{
  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
  "title": "Invalid Site Default Language",
  "status": "409",
  "detail": "Default Language '{defaultLanguage}' for site is not valid. The default language must be one of the localization policy's required languages.",
  "o:errorCode": "OCE-SITEMGMT-009075",
  "defaultLanguage": "en-US"
}

リリース19.4.1.での導入。

リクエスト

パス・パラメータ
問合せパラメータ
  • 削除対象としてマークされているリソースでは、この問合せパラメータがtrueに設定されているかぎり、読取り、変更およびサポート対象の拡張操作が可能です。 includeDeleted問合せパラメータを送信しない場合、読取り、変更および拡張操作に対するレスポンスは、リソースが完全に削除された場合に戻されるものと同じです。

トップに戻る

レスポンス

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

200レスポンス

OK
ヘッダー
本文()
ルート・スキーマ: schema
すべてに一致
ソースを表示
  • SiteValidationResult

    サイト・チャネルに構成されたローカリゼーション・ポリシーに対するサイト・コンテンツ検証の結果。

ネストされたスキーマ : SiteValidationResult
型: object

サイト・チャネルに構成されたローカリゼーション・ポリシーに対するサイト・コンテンツ検証の結果。

ソースを表示
ネストされたスキーマ : ページ
型: array

siteinfoおよび構造を含むページ・オブジェクトのリスト。

ソースを表示
ネストされたスキーマ: items
すべてに一致
ソースを表示
  • SitePageValidationResult

    サイト・チャネルに構成されているローカリゼーション・ポリシーに対するサイト・コンテンツ検証の個々のページの結果。

ネストされたスキーマ : SitePageValidationResult
型: object

サイト・チャネルに構成されているローカリゼーション・ポリシーに対するサイト・コンテンツ検証の個々のページの結果。

ソースを表示
ネストされたスキーマ : 言語
型: array

各サイト・ページの言語検証情報のリスト。 siteinfoページおよびstructureページは、このリストに含まれます。 サイトのチャネル・ローカリゼーション・ポリシーに定義されているすべての言語と、ページが翻訳される言語をリストします。

ソースを表示
ネストされたスキーマ : usedAssets
型: array

サイトで使用されるアセットのアセット検証情報のリスト。

ソースを表示
ネストされたスキーマ: items
すべてに一致
ソースを表示
  • LanguageValidationResult

    サイト・チャネルに構成されているローカリゼーション・ポリシーに対するサイト・コンテンツ検証の個々のページの結果。

ネストされたスキーマ : LanguageValidationResult
型: object

サイト・チャネルに構成されているローカリゼーション・ポリシーに対するサイト・コンテンツ検証の個々のページの結果。

ソースを表示
  • 言語

  • この言語のローカリゼーション・ポリシー検証ステータス。

    有効な値は次のとおりです。

    • required - 必要な言語翻訳がありません
    • optional - 必須言語翻訳はオプションです
    • undefined - ローカリゼーション・ポリシーで定義されていない言語

  • この言語の検証ステータス。

    有効な値は次のとおりです。

    • missing - ページ言語がありません
    • ready - ページ言語準備完了
    • excluded - 除外されるページ言語

ネストされたスキーマ: items
すべてに一致
ソースを表示
  • UsedAsset

    サイト・ページで使用されるアセットに関する情報。

ネストされたスキーマ : UsedAsset
型: object

サイト・ページで使用されるアセットに関する情報。

ソースを表示
  • アセット識別子。

  • アセット・バージョン

    有効な値は次のとおりです。

    • draft - サイトの公開時にドラフトのアセットが公開されていません
    • published - 公開されたアセットは、サイトの公開時に公開されます

レスポンスの例(有効なサイト結果)
{
    "valid":false,
    "pages":[
        {
            "id":"siteinfo",
            "name":"siteinfo",
            "type":"siteinfo",
            "publishable":false,
            "languages":[
                {
                    "language":"fr-FR",
                    "policyStatus":"required",
                    "validation":"missing"
                },
                {
                    "language":"de-DE",
                    "policyStatus":"optional",
                    "validation":"ready"
                },
                {
                    "language":"es-ES",
                    "policyStatus":"undefined",
                    "validation":"excluded"
                }
            ],
            "usedAssets":[
            ]
        },
        {
            "id":"structure",
            "name":"structure",
            "type":"structure",
            "publishable":false,
            "languages":[
                {
                    "language":"fr-FR",
                    "policyStatus":"required",
                    "validation":"missing"
                },
                {
                    "language":"de-DE",
                    "policyStatus":"optional",
                    "validation":"ready"
                },
                {
                    "language":"es-ES",
                    "policyStatus":"undefined",
                    "validation":"excluded"
                }
            ],
            "usedAssets":[
            ]
        },
        {
            "id":"10",
            "name":"Home",
            "type":"page",
            "publishable":false,
            "languages":[
                {
                    "language":"fr-FR",
                    "policyStatus":"required",
                    "validation":"missing"
                },
                {
                    "language":"de-DE",
                    "policyStatus":"optional",
                    "validation":"ready"
                },
                {
                    "language":"es-ES",
                    "policyStatus":"undefined",
                    "validation":"excluded"
                }
            ],
            "usedAssets":[
                {
                    "id":"CORED2FDC62C23504F6AB47B1F6106F9DC73",
                    "version":"draft"
                },
                {
                    "id":"CORE48AF98371AFC4568B260D4417E38A739",
                    "version":"published"
                },
                {
                    "id":"CONTBD592905665C4652BFEAE6FD19E9F291",
                    "version":"draft"
                },
                {
                    "id":"CONT9DE7B749A5E9438689492A0054C02707",
                    "version":"draft"
                }
            ]
        }
    ]
}

400レスポンス

不正なリクエスト

401レスポンス

未認可

403レスポンス

禁止
本文()
ルート・スキーマ: schema
すべてに一致
ソースを表示
ネストされたスキーマ : SiteOperationForbiddenExceptionDetail
リリース19.1.5.での導入。
すべてに一致
ソースを表示
ネストされたスキーマ : ExceptionDetail
型: object

HTTPエラー・コードおよびエラー・メッセージに加えて、リクエストが失敗したときにクライアントに追加情報を提供することが適切な場合もあります。 その場合、追加情報がレスポンス本文に含まれます。

ソースを表示
  • この問題の発生に固有の説明。 人間が判読できる、場合によっては複数行の詳細で問題を説明しています。

  • エラーに関する詳細を提供するリンクへのURI。

  • アプリケーション・エラー・コード。HTTPエラー・コードとは異なります。 このコードは、titledetailなどのフィールドを比較するのではなく、特定のエラーをチェックするために使用する必要があります。

  • o:errorDetails

    階層構造に複数のエラーがある場合もあります。

  • エラーが発生した場所を示すXPathまたはJSONパス。

  • エラーに対応するHTTPステータス・コード。

  • 問題の短く、判読可能なサマリー。 タイトルは、特定のエラーをチェックする方法としては使用しないでください。そのためにはo:errorCodeを使用してください。

  • 問題のタイプを識別する絶対URI。 このURIが参照解除されると、「推奨」は、HTMLページなどの問題の判読可能なサマリーを提供します。

ネストされたスキーマ : SiteOperationForbiddenExceptionDetail-allOf[1]
型: object
ソースを表示
ネストされたスキーマ: o:errorDetails
型: array

階層構造に複数のエラーがある場合もあります。

ソースを表示
ネストされたスキーマ: items
すべてに一致
ソースを表示
  • ExceptionDetail

    HTTPエラー・コードおよびエラー・メッセージに加えて、リクエストが失敗したときにクライアントに追加情報を提供することが適切な場合もあります。 その場合、追加情報がレスポンス本文に含まれます。

レスポンスの例(サイト操作禁止)
{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
    "title":"Site Operation Forbidden",
    "status":"403",
    "detail":"You do have a sharing role in this site, but your role does not allow you to use this operation.",
    "o:errorCode":"OCE-SITEMGMT-009026",
    "site":{
        "id":"FCA9C0E5CDCB549A19FFB85987A2352778961003B8A0"
    }
}

404レスポンス

見つかりません
ヘッダー
本文()
ルート・スキーマ: schema
すべてに一致
ソースを表示
ネストされたスキーマ : SiteNotFoundExceptionDetail
すべてに一致
ソースを表示
  • ExceptionDetail

    HTTPエラー・コードおよびエラー・メッセージに加えて、リクエストが失敗したときにクライアントに追加情報を提供することが適切な場合もあります。 その場合、追加情報がレスポンス本文に含まれます。

  • SiteNotFoundExceptionDetail-allOf[1]
ネストされたスキーマ : ExceptionDetail
型: object

HTTPエラー・コードおよびエラー・メッセージに加えて、リクエストが失敗したときにクライアントに追加情報を提供することが適切な場合もあります。 その場合、追加情報がレスポンス本文に含まれます。

ソースを表示
  • この問題の発生に固有の説明。 人間が判読できる、場合によっては複数行の詳細で問題を説明しています。

  • エラーに関する詳細を提供するリンクへのURI。

  • アプリケーション・エラー・コード。HTTPエラー・コードとは異なります。 このコードは、titledetailなどのフィールドを比較するのではなく、特定のエラーをチェックするために使用する必要があります。

  • o:errorDetails

    階層構造に複数のエラーがある場合もあります。

  • エラーが発生した場所を示すXPathまたはJSONパス。

  • エラーに対応するHTTPステータス・コード。

  • 問題の短く、判読可能なサマリー。 タイトルは、特定のエラーをチェックする方法としては使用しないでください。そのためにはo:errorCodeを使用してください。

  • 問題のタイプを識別する絶対URI。 このURIが参照解除されると、「推奨」は、HTMLページなどの問題の判読可能なサマリーを提供します。

ネストされたスキーマ : SiteNotFoundExceptionDetail-allOf[1]
型: object
ソースを表示
ネストされたスキーマ: o:errorDetails
型: array

階層構造に複数のエラーがある場合もあります。

ソースを表示
ネストされたスキーマ: items
すべてに一致
ソースを表示
  • ExceptionDetail

    HTTPエラー・コードおよびエラー・メッセージに加えて、リクエストが失敗したときにクライアントに追加情報を提供することが適切な場合もあります。 その場合、追加情報がレスポンス本文に含まれます。

レスポンスの例(サイトが見つかりません)
{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
    "title":"Site Not Found",
    "status":"404",
    "detail":"Site does not exist or has been deleted, or the authenticated user or client application does not have access to the site.",
    "o:errorCode":"OCE-SITEMGMT-009003",
    "site":{
        "id":"FCA9C0E5CDCB549A19FFB85987A2352778961003B8A0"
    }
}

406レスポンス

受入れられない

409レスポンス

競合
本文()
ルート・スキーマ: schema
すべてに一致
ソースを表示
ネストされたスキーマ : SiteDeletedExceptionDetail
リリース19.4.1.での導入。
すべてに一致
ソースを表示
  • ExceptionDetail

    HTTPエラー・コードおよびエラー・メッセージに加えて、リクエストが失敗したときにクライアントに追加情報を提供することが適切な場合もあります。 その場合、追加情報がレスポンス本文に含まれます。

  • SiteDeletedExceptionDetail-allOf[1]
ネストされたスキーマ : ExceptionDetail
型: object

HTTPエラー・コードおよびエラー・メッセージに加えて、リクエストが失敗したときにクライアントに追加情報を提供することが適切な場合もあります。 その場合、追加情報がレスポンス本文に含まれます。

ソースを表示
  • この問題の発生に固有の説明。 人間が判読できる、場合によっては複数行の詳細で問題を説明しています。

  • エラーに関する詳細を提供するリンクへのURI。

  • アプリケーション・エラー・コード。HTTPエラー・コードとは異なります。 このコードは、titledetailなどのフィールドを比較するのではなく、特定のエラーをチェックするために使用する必要があります。

  • o:errorDetails

    階層構造に複数のエラーがある場合もあります。

  • エラーが発生した場所を示すXPathまたはJSONパス。

  • エラーに対応するHTTPステータス・コード。

  • 問題の短く、判読可能なサマリー。 タイトルは、特定のエラーをチェックする方法としては使用しないでください。そのためにはo:errorCodeを使用してください。

  • 問題のタイプを識別する絶対URI。 このURIが参照解除されると、「推奨」は、HTMLページなどの問題の判読可能なサマリーを提供します。

ネストされたスキーマ : SiteDeletedExceptionDetail-allOf[1]
型: object
ソースを表示
  • サイト識別子が指定されている場合、ソフト削除されるサイト。

    リリース19.4.1.での導入。
ネストされたスキーマ: o:errorDetails
型: array

階層構造に複数のエラーがある場合もあります。

ソースを表示
ネストされたスキーマ: items
すべてに一致
ソースを表示
  • ExceptionDetail

    HTTPエラー・コードおよびエラー・メッセージに加えて、リクエストが失敗したときにクライアントに追加情報を提供することが適切な場合もあります。 その場合、追加情報がレスポンス本文に含まれます。

レスポンスの例(サイト削除)
{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
    "title":"Site Deleted",
    "status":"409",
    "detail":"The operation cannot be performed as the site has been soft deleted.",
    "o:errorCode":"OCE-SITEMGMT-009059",
    "site":{
        "id":"FCA9C0E5CDCB549A19FFB85987A2352778961003B8A0"
    }
}
レスポンスの例(サイトのデフォルト言語がない)
{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
    "title":"Missing Site Default Language",
    "status":"409",
    "detail":"Default language for the site is missing.",
    "o:errorCode":"OCE-SITEMGMT-001008"
}
レスポンスの例(サイト・ローカリゼーション・ポリシーがありません)
{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
    "title":"Missing Site Localization Policy",
    "status":"409",
    "detail":"Localization policy for site is missing.",
    "o:errorCode":"OCE-SITEMGMT-009074"
}
レスポンスの例(無効なサイト・デフォルト言語)
{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
    "title":"Invalid Site Default Language",
    "status":"409",
    "detail":"Default Language '{defaultLanguage}' for site is not valid. The default language must be one of the localization policy's required languages.",
    "o:errorCode":"OCE-SITEMGMT-009075",
    "defaultLanguage":"en-US"
}

413 レスポンス

ペイロードが大きすぎます

416 レスポンス

範囲を満たすことはできません

429 レスポンス

リクエストが多すぎます

500レスポンス

内部サーバー・エラー

501レスポンス

実装されていない

502 レスポンス

ゲートウェイが不良

503レスポンス

サービス使用不可

504レスポンス

ゲートウェイがタイムアウト
先頭に戻る