機械翻訳について
  1. サイト管理用のREST API
  2. タスク
  3. リクエスト
  4. レビュー

リスト・レビューがリクエストに追加されました

get

/sites/management/api/v1/requests/{id}/reviews

COLLECTION

リクエストを承認または否認したレビューをリストします。 作成されたリクエストには、承認する前に1人以上のユーザーによるリクエストの確認が必要な場合があります。 この操作では、リクエストに追加されたすべてのレビューがリストされます。

認可

「サイト管理者」ではすべてのレビューをリストできます。 ユーザーが「作成した」でリクエストされた場合、すべてのレビューをリストできます。

制限

limit問合せパラメータが指定されていない場合、この操作では50アイテムのデフォルト制限が使用されます。 指定できる最大制限は250です。 制限がこの最大値を超えると、250の制限が使用されます。

ソート

デフォルトのソート順では、createdAtは降順でソートします。

成功したレスポンスの例

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

200OK - List Reviews I Created

認証されたユーザーが作成したレビュー済をリストします。

リクエスト

GET https://api.example.com/sites/management/api/v1/requests/{id}/reviews?q=reviewedBy.userName eq "@me"))
リリース19.3.3での導入。

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

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

404Not Found - Request Not Found

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

エラー・コード

OCE-SITEMGMT-009001

解決 - 識別子のチェック

リクエスト識別子が有効であることを確認してください。

解決 - 認可の確認

認証済ユーザーがリクエストをレビューできること、または認証済ユーザーがリクエストを作成したユーザーであることを確認します。

例外詳細フィールド

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

フィールド名説明
request存在しない、または認証されたユーザーが表示できないリクエストです。

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

レスポンス本文の例
{
  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
  "title": "Request Not Found",
  "status": "404",
  "detail": "Request does not exist or has been deleted, or the authenticated user or client application does not have access to the request.",
  "o:errorCode": "OCE-SITEMGMT-009001",
  "request": {
    "id": "e77229e8-1f44-4c27-bacb-9a99b7c77af7"
  }
}

リクエスト

パス・パラメータ

  • リクエストのグローバルに一意の不変識別子。

問合せパラメータ

  • レスポンスに使用しないフィールド名のカンマ区切り文字列。 フィールド名を区切るには、ドットを使用してネストされたフィールドを特定できます。 フィールド名は大文字と小文字を区別します。 フィールドが存在しない場合、フィールド名は無視されます。 コレクションのフィールドを参照するために、フィールド名の先頭に@文字(@hasMoreなど)を付加できます。

  • レスポンスからexcludeへのリンク関係名のカンマ区切りリスト。

  • 展開するフィールド名のカンマ区切りの文字列。 値allを使用して、すべての関係を展開します。

    expand問合せパラメータには次のフィールド名を指定できます:

    フィールド名説明
    reviewedByレビューを作成したユーザーまたはクライアント・アプリケーションの詳細を取得します。

  • 拡張のエラーの処理方法を指定します。 指定しない場合は、デフォルトで関連フィールドにエラーの詳細が含まれます。

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

    • ignore - エラーを無視して関係を展開しません。 関連リンクはレスポンスに含まれません
    • include - 展開された関係のかわりにエラー詳細を含めます。 関連リンクが返されます
    • fail - リクエストの拡張の失敗エラー・レスポンスでの失敗

  • レスポンスに必要なフィールド名のカンマ区切り文字列。 フィールド名を区切るためにドットを使用して、ネストされたプロパティを特定できます。 フィールド名は大文字と小文字を区別します。 フィールドが存在しない場合、フィールド名は無視されます。 コレクションのフィールドを参照するために、フィールド名の先頭に@文字(@hasMoreなど)を付加できます。

  • レスポンスで返される最大品目数を指定する正の整数値。 指定しない場合、サービスでは適切な制限が選択されます。

  • レスポンス内のincludeへのリンク関係名のカンマ区切りリスト。 デフォルトでは、すべてのリンクが返されます。

    次のリンクは、このリソースにより提供されます:

    リンク関係説明
    parent親リソースが読取り可能な場所を示します。 このリンクはupリンクに相当し、親リソース(単数形のリソースを含むコレクション・リソースなど)へのリンクを提供します。
    selfリソースの現在の戻り表現を示します。 リソース自体を表すリンクに使用されます。 たとえば、リソースがコレクションの一部として戻された場合、自己リンクは個々のリソースのURLパスを提供します。
    canonicalリクエストされたリソースの優先表現を示します。 リソースの標準的な形式を表すリンクに使用されます。 たとえば、リソースがコレクションの一部として返される場合、正規リンクは個々のリソースの正規の形式のURLパスを提供します。
    child関連リソースまたは子リソースの読取りが可能な場所を表します。 子リンクは展開可能なプロパティとして返され、展開されていない関係の詳細が読み取られるロケーションを提供します。
    prev前のページが存在する場合、結果の前のページを説明します。 コレクション・リソースとともに使用し、offsetおよびlimit問合せパラメータを指定したページ・リクエストへのレスポンスに基づいて前のパス・リンクを提供します。
    next次のページが存在する場合、結果の次のページについて説明します。 収集リソースとともに使用し、offsetおよびlimit問合せパラメータを指定したページ・リクエストへのレスポンスに基づいて、次のページ・リンクを提供します。
    createリソースを作成できる場所を説明します。 コレクション・リソースで、コレクション内に新規リソースを作成するために投稿を実行できる場所を示すために使用されます。
    search-form使用可能な問合せ構文を説明する検索フォームの読取り可能な場所を説明します。 検索フォームには、リソースの検索に使用できる検索基準の詳細が表示されます。
    create-formリソースを作成するテンプレート・リクエスト本文を読むことができる場所を説明します。 作成フォームには、リソースの作成に使用できるプロパティの詳細が示されます。
    describedByリソースに関するメタデータ情報を提供するスキーマ・リソースが記述されます。 スキーマ・リソースがリソースを説明する場所を示すために、コレクション・リソース、単数形およびリレーション・リソースで使用されます。

  • 返される最初のアイテムのインデックスを指定する負でない整数値。 オフセット索引はゼロから始まります。 デフォルトでは、オフセットはゼロで、コレクション内の最初のアイテムから始まるアイテムが返されます。

  • カンマで区切ったフィールド名の文字列。それぞれにオプションで:ascまたは:descが続く文字列が続き、レスポンスで返されるアイテムの順序が指定されます。

    orderByの問合せパラメータでは、次のフィールドを使用できます:

    フィールド名説明
    decisionこのレビューの結果で、リクエストを承認または否認します。
    createdAtレビューが作成された日時。

  • コレクションで返されるアイテムを制御する問合せ式。 問合せ式が指定されていない場合に、アイテムにフィルタリングは適用されません。

    q問合せパラメータでは、次のフィールドおよび演算子を使用できます:

    フィールド名サポートされる演算子
    createdAt(eq)、(gt)より大きい、(lt)より小さい
    decision(eq)と等しい
    reviewedBy.id(eq)と等しい
    reviewedBy.userName(eq)と等しい
    reviewedBy.name(eq)と等しい

    次の演算子について説明します:

    オペレータ説明
    eq

    次と等しい演算子。 属性と演算子の値は同一です。

    gt

    「より大きい」演算子。 属性値が演算子値より大きい場合、一致があります。 実際の比較は属性タイプによって決まります。 文字列属性タイプの場合、これは辞書比較であり、日時タイプの場合、時系列比較です。 整数属性の場合、これは数値による比較です。

    lt

    「より小さい」演算子。 属性値が演算子値より小さい場合、一致があります。 実際の比較は属性タイプによって決まります。 文字列属性タイプの場合、これは辞書比較であり、日時タイプの場合、時系列比較です。 整数属性の場合、これは数値による比較です。

  • レスポンス・フィールドおよびリンクの制御に使用するリソース表現を指定します。 表現が指定されない場合、fields、excludeFields、links、excludeLinksおよびexpand問合せパラメータの値に基づいて、クライアント定義の表現が戻されます。

    次の表現は、return問合せパラメータでサポートされています:

    表現説明
    representationフル・リソース表示には、すべてのプロパティとリンクが含まれ、大部分の関係が拡張されます。
    defaultデフォルトのリソース表示には、ほとんどのプロパティとリンクが含まれます。
    basic基本的なリソース表現には、いくつかのプロパティといくつかのリンクが含まれます。
    minimal最小リソース表現。必須プロパティとリンクなしが含まれます。
トップに戻る

レスポンス

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

200レスポンス

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

    REST APIによって返されるすべてのコレクションは、標準のコレクション定義を拡張します。 この定義では、品目の合計数、返される品目のオフセットおよび制限の詳細、品目の数、および使用可能な品目が他にもあるかどうかを示すインジケータに関する情報を提供します。

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

「確認」要素のコレクション。

ソースを表示
ネストされたスキーマ : CollectionResource

REST APIによって返されるすべてのコレクションは、標準のコレクション定義を拡張します。 この定義では、品目の合計数、返される品目のオフセットおよび制限の詳細、品目の数、および使用可能な品目が他にもあるかどうかを示すインジケータに関する情報を提供します。

すべてに一致
ソースを表示
  • SingularResource

    すべての単数形のリソースには、特異なリソース定義のプロパティが含まれます。 単一のリソースには、他のリソースとの関係を提供するリンク、またはリソース自体をselfがリンクするリンク先のリストが含まれます。

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

すべての単数形のリソースには、特異なリソース定義のプロパティが含まれます。 単一のリソースには、他のリソースとの関係を提供するリンク、またはリソース自体をselfがリンクするリンク先のリストが含まれます。

ソースを表示
  • links
ネストされたスキーマ : CollectionResource-allOf[1]
型: object
ソースを表示

  • レスポンス内のリソースの合計数。

  • コレクションには、リクエストに一致する多くの要素があります。 ページ・リクエストを作成し、ページがすべての要素を返すのに十分な大きさでない場合に、返されるアイテムが他にもあるかどうかを示します。

  • 実際のレスポンス・サイズ制限。 リクエストで指定されている制限値が大きすぎる場合、または制限が指定されていない場合、レスポンスでは使用される制限が指定されます。

  • 使用される実際のレスポンス・オフセット。 リクエストでオフセットが指定されていない場合、レスポンスに実際のオフセットが指定されます。

  • リクエストに一致するリソースの合計数。 指定した場合は、使用可能なアイテムの合計数です。 指定されない場合、合計が不明か、または戻り不可能です。 この値を計算するとき、ページング制限またはオフセットは無視されます。 totalResultsパラメータがサポートされていて、クライアントがtrueに設定している場合にのみ返されます。

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

    レビューとは、リクエストの承認または却下を目的とした人間が開始したレビューです。 レビューは、リクエスト元がリクエストを承認または却下した理由を理解するために使用できるオプションのコメントとともに、リクエストを承認または却下します。 リクエストに関連付けられている承認のタイプに応じて、ゼロ以上のレビューが必要になる場合があります。 たとえば、「自動承認」リクエストではレビューは不要です。 「管理者承認」では、リクエストをレビューするには1人の管理者が必要です。

ネストされたスキーマ : 確認

レビューとは、リクエストの承認または却下を目的とした人間が開始したレビューです。 レビューは、リクエスト元がリクエストを承認または却下した理由を理解するために使用できるオプションのコメントとともに、リクエストを承認または却下します。 リクエストに関連付けられている承認のタイプに応じて、ゼロ以上のレビューが必要になる場合があります。 たとえば、「自動承認」リクエストではレビューは不要です。 「管理者承認」では、リクエストをレビューするには1人の管理者が必要です。

すべてに一致
ソースを表示
  • SingularResource

    すべての単数形のリソースには、特異なリソース定義のプロパティが含まれます。 単一のリソースには、他のリソースとの関係を提供するリンク、またはリソース自体をselfがリンクするリンク先のリストが含まれます。

  • Review-allOf[1]
ネストされたスキーマ : Review-allOf[1]
型: object
ソースを表示
  • 最大長: 1000

    レビューに関連付けられたコメントは、リクエストが承認または却下された理由を説明するために使用できます。 説明の内容に制限はありません。任意の文字を含む1行または複数行を指定できます。

  • レビューが作成された日時。 日付値と時間値は、UTCタイムゾーンを使用してISO 8601 yyyy-MM-dd'T'HH:mm:ss.SSS'Z'形式です。

  • このレビューの結果で、リクエストを承認または否認します。

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

    • approved - 関連リクエストが承認されました
    • rejected - 関連リクエストは却下されました

  • レビューのリクエスト・スコープ指定識別子。 レビュー識別子は、レビューが作成されるときにシステムによって生成され、変更できません。 識別子は、親リクエストのスコープ内でのみ一意です。 最新のレビューの識別子値は小さくなります。

    フィールドの内容は想定しないでください。フィールドはopaque値として扱われる必要があります。

  • reviewedBy

    レビューを作成したユーザーまたはクライアント・アプリケーションの詳細を取得します。

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

レビューを作成したユーザーまたはクライアント・アプリケーションの詳細を取得します。

すべてに一致
ソースを表示
  • 「アイデンティティ」
    識別子: type

    ユーザーまたはクライアント・アプリケーションを表すアイデンティティ。 アイデンティティには、アイデンティティ識別子、一意の名前、表示名などの共通情報が含まれます。

    リリース20.3.1で導入されました。
ネストされたスキーマ: Identity
識別子: type

ユーザーまたはクライアント・アプリケーションを表すアイデンティティ。 アイデンティティには、アイデンティティ識別子、一意の名前、表示名などの共通情報が含まれます。

リリース20.3.1で導入されました。
すべてに一致
ソースを表示
  • SingularResource

    すべての単数形のリソースには、特異なリソース定義のプロパティが含まれます。 単一のリソースには、他のリソースとの関係を提供するリンク、またはリソース自体をselfがリンクするリンク先のリストが含まれます。

  • Identity-allOf[1]
ネストされたスキーマ : Identity-allOf[1]
型: object
ソースを表示

  • 人間が判読できる表示名。

    リリース20.3.1で導入されました。

  • ユーザーまたはクライアント・アプリケーションに対してCECによって割り当てられる識別子値。 識別子はサービスのスコープ内で一意です。

    フィールドの内容は想定しないでください。フィールドはopaque値として扱われる必要があります。

    リリース20.3.1で導入されました。

  • ユーザー名やクライアント・アプリケーション名などの一意の名前。

    リリース20.3.1で導入されました。
  • roles

    ロール

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

    • CECServiceAdministrator - サービス管理者
    • ユーザー列挙の割当
    • ユーザーのパスワードおよびチャレンジ質問の変更
    • サービス・インスタンスの構成、モニターおよび管理
    • CECSitesAdministrator - サイト管理者
    • サイト、テンプレート、テーマまたはコンポーネントの作成
    • CECRepositoryAdministrator - リポジトリ管理者
    • CECDeveloperUser - 開発者ユーザー
    • CECContentAdministrator - コンテンツ管理者
    • 新規コンテンツ・タイプの作成およびアイテムの公開
    • CECStandardUser - 標準ユーザー
    • コンテンツの管理(ドキュメントの表示、アップロードおよび編集)
    • 他のユーザーとのコンテンツおよびサイトの共有
    • 会話によるコラボレーション(トピックのディスカッション、他のユーザーへのメッセージの送信、他のユーザーへのフラグの割当て、ドキュメントへの注釈の追加)
    • ユーザーのフォロー
    • サイトの作成、編集および公開
    • サイトのテーマの管理および公開
    • カスタム・サイト・コンポーネントの作成、登録、エクスポートおよびインポート
    • サイト・テンプレートの作成、編集、エクスポートおよびインポート
    • サイト内のコンテンツの表示および操作
    • カスタム・プロパティの管理と表示、および値の編集
    • CECEnterpriseUser - エンタープライズ・ユーザー
    • コンテンツの管理(ドキュメントの表示、アップロードおよび編集)
    • 他のユーザーとのコンテンツおよびサイトの共有
    • 会話によるコラボレーション(トピックのディスカッション、他のユーザーへのメッセージの送信、他のユーザーへのフラグの割当て、ドキュメントへの注釈の追加)
    • ユーザーのフォロー
    • デジタル・アセット
    • コンテンツ・アイテム(エディトリアル・コンテンツ管理)
    • コンテンツ・アイテムの作成、管理、表示および操作
    • コレクション
    • サイトの作成、編集および公開
    • サイトのテーマの管理および公開
    • カスタム・サイト・コンポーネントの作成、登録、エクスポートおよびインポート
    • サイト・テンプレートの作成、編集、エクスポートおよびインポート
    • カスタム・プロパティの管理と表示、および値の編集
    • CECExternalUser - 外部ユーザー
    将来使用するために予約済
    • CECIntegrationUser - 統合ユーザー
    Collaboration REST APIのソーシャルRESTエンドポイントを介して操作を実行しながら、別のユーザーを偽装するために使用されます。
    • CECSitesVisitor - サイト・ビジター
    サイトへのアクセスはビジターに制限されます。

    リリース21.10.2で導入されました。

  • 「アイデンティティ」のタイプ。 有効な値は次のとおりです: user, service, application, unknown。

    リリース20.3.1で導入されました。
ネストされたスキーマ: roles
型: array

ロール

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

  • CECServiceAdministrator - サービス管理者
  • ユーザー列挙の割当
  • ユーザーのパスワードおよびチャレンジ質問の変更
  • サービス・インスタンスの構成、モニターおよび管理
  • CECSitesAdministrator - サイト管理者
  • サイト、テンプレート、テーマまたはコンポーネントの作成
  • CECRepositoryAdministrator - リポジトリ管理者
  • CECDeveloperUser - 開発者ユーザー
  • CECContentAdministrator - コンテンツ管理者
  • 新規コンテンツ・タイプの作成およびアイテムの公開
  • CECStandardUser - 標準ユーザー
  • コンテンツの管理(ドキュメントの表示、アップロードおよび編集)
  • 他のユーザーとのコンテンツおよびサイトの共有
  • 会話によるコラボレーション(トピックのディスカッション、他のユーザーへのメッセージの送信、他のユーザーへのフラグの割当て、ドキュメントへの注釈の追加)
  • ユーザーのフォロー
  • サイトの作成、編集および公開
  • サイトのテーマの管理および公開
  • カスタム・サイト・コンポーネントの作成、登録、エクスポートおよびインポート
  • サイト・テンプレートの作成、編集、エクスポートおよびインポート
  • サイト内のコンテンツの表示および操作
  • カスタム・プロパティの管理と表示、および値の編集
  • CECEnterpriseUser - エンタープライズ・ユーザー
  • コンテンツの管理(ドキュメントの表示、アップロードおよび編集)
  • 他のユーザーとのコンテンツおよびサイトの共有
  • 会話によるコラボレーション(トピックのディスカッション、他のユーザーへのメッセージの送信、他のユーザーへのフラグの割当て、ドキュメントへの注釈の追加)
  • ユーザーのフォロー
  • デジタル・アセット
  • コンテンツ・アイテム(エディトリアル・コンテンツ管理)
  • コンテンツ・アイテムの作成、管理、表示および操作
  • コレクション
  • サイトの作成、編集および公開
  • サイトのテーマの管理および公開
  • カスタム・サイト・コンポーネントの作成、登録、エクスポートおよびインポート
  • サイト・テンプレートの作成、編集、エクスポートおよびインポート
  • カスタム・プロパティの管理と表示、および値の編集
  • CECExternalUser - 外部ユーザー
将来使用するために予約済
  • CECIntegrationUser - 統合ユーザー
Collaboration REST APIのソーシャルRESTエンドポイントを介して操作を実行しながら、別のユーザーを偽装するために使用されます。
  • CECSitesVisitor - サイト・ビジター
サイトへのアクセスはビジターに制限されます。

リリース21.10.2で導入されました。
ソースを表示
レスポンスの例 ()
{
    "totalResults":"1",
    "limit":"20",
    "count":"1",
    "hasMore":"false",
    "offset":"0",
    "items":[
        {
            "id":0,
            "decision":"approved",
            "comment":"Site request looks good, approved.",
            "createdAt":"2019-06-01T06:44:17.000Z"
        }
    ]
}

400レスポンス

不正なリクエスト

401レスポンス

未認可

403レスポンス

禁止

404レスポンス

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

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

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

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

ソースを表示

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

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

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

  • o:errorDetails

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

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

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

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

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

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

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

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

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

レスポンスの例(リクエストが見つかりません)
{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
    "title":"Request Not Found",
    "status":"404",
    "detail":"Request does not exist or has been deleted, or the authenticated user or client application does not have access to the request.",
    "o:errorCode":"OCE-SITEMGMT-009001",
    "request":{
        "id":"e77229e8-1f44-4c27-bacb-9a99b7c77af7"
    }
}

406レスポンス

受入れられない

416 レスポンス

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

429 レスポンス

リクエストが多すぎます

500レスポンス

内部サーバー・エラー

501レスポンス

実装されていない

502 レスポンス

ゲートウェイが不良

503レスポンス

サービス使用不可

504レスポンス

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