機械翻訳について
  1. サイト管理用のREST API
  2. タスク
  3. テーマ
  4. 更新およびコピー

テーマ・リソース編集のリクエスト本文の例の取得

get

/sites/management/api/v1/themes/{id}/edit-form

EDIT FORM

テーマ・インスタンスの編集に適したテンプレート・リクエスト本文を取得します。edit-formリソースは、Themeの編集時に更新可能なプロパティを判断するためのテンプレートとしてクライアントに使用されます。レスポンスには編集可能なすべてのプロパティ値が含まれます。 これらのプロパティを編集または破棄し、Themeを編集するためのリクエスト本文として使用できます。

リリース19.4.1.での導入。

認可

このedit-formリソースにアクセスするには、親リソースへの読取りアクセス権が必要です。

パス代替識別子

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

nameテーマ名

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

http://api.example.com/sites/management/api/v1/themes/name:LearnTheme/edit-form

リリース19.4.1.での導入。

成功したレスポンスの例

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

200OK

リクエスト

GET https://api.example.com/sites/management/api/v1/themes/{id}/edit-form

レスポンス本文

{
  "description": "A folder for my assets."
}

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

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

404Not Found - Theme Name Ambiguous

指定された名前はテーマを一意に識別しません。 削除されたテーマが名前によって参照され、同じ名前のテーマが複数ある場合、このエラーが発生します。 このエラーには、削除されたテーマの詳細が同じ名前で表示されます。

エラー・コード

OCE-SITEMGMT-009087

解決 - テーマ識別子の使用

名前のかわりに一意のテーマ識別子を使用して、テーマを識別します。

例外詳細フィールド

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

フィールド名説明
theme存在しないか、認証されたユーザーに表示されないテーマ。
themes名前に一致するテーマ。

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

レスポンス本文の例
{
  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
  "title": "Theme Name Ambiguous",
  "status": "404",
  "detail": "Multiple themes exist with an identifier of '{theme.id}'.",
  "o:errorCode": "OCE-SITEMGMT-009087",
  "theme": {
    "id": "FFA7758925559C7F6FC394910D5DDCD9211A3DB216EC"
  },
  "themes": [
      {
        "id": "FFA7758925559C7F6FC394910D5DDCD9211A3DB216EC",
        "name": "CafeSupremoTheme",
        "isDeleted": false,
        "description": "A folder for my assets.",
        "createdAt": "2019-06-01T06:44:17.000Z",
        "lastModifiedAt": "2019-06-01T06:44:17.000Z",
        "publishStatus": "unpublished",
        "isStarter": false
      }
  ]
}

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

404Not Found - Theme Not Found

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

エラー・コード

OCE-SITEMGMT-009041

解決 - 識別子のチェック

テーマ識別子が有効であることを確認してください。

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

認証されたユーザーがテーマのメンバーであることを確認します。

例外詳細フィールド

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

フィールド名説明
theme存在しないか、認証されたユーザーに表示されないテーマ。

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

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

リリース19.4.1.での導入。

リクエスト

パス・パラメータ
問合せパラメータ

  • レスポンスに含めないフィールド名のカンマ区切り文字列。

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

  • レスポンスに含めるフィールド名のカンマ区切りの文字列。 フィールド名を区切るには、ドットを使用してネストされたフィールドを特定できます。 フィールド名は大文字と小文字を区別します。 フィールドが存在しない場合、フィールド名は無視されます。

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

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

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

    リンク関係説明
    parent親リソースが読取り可能な場所を示します。 このリンクはupリンクに相当し、親リソース(単数形のリソースを含むコレクション・リソースなど)へのリンクを提供します。
    selfリソースの現在の戻り表現を示します。 リソース自体を表すリンクに使用されます。 たとえば、リソースがコレクションの一部として戻された場合、自己リンクは個々のリソースのURLパスを提供します。
    canonicalリクエストされたリソースの優先表現を示します。 リソースの標準的な形式を表すリンクに使用されます。 たとえば、リソースがコレクションの一部として返される場合、正規リンクは個々のリソースの正規の形式のURLパスを提供します。
    editリソースを編集できる場所について説明します。 単一のリソースで使用され、既存のリソースを編集するためにパッチを実行できる場所を示します。
    describedByリソースに関するメタデータ情報を提供するスキーマ・リソースが記述されます。 スキーマ・リソースがリソースを説明する場所を示すために、コレクション・リソース、単数形およびリレーション・リソースで使用されます。
トップに戻る

レスポンス

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

200レスポンス

OK
ヘッダー
本文()
ルート・スキーマ: schema
型: object
ソースを表示
  • 最大長: 1000

    オプションの説明。 説明の内容に制限はありません。任意の文字を含む1行または複数行を指定できます。

    リリース19.4.1.での導入。
  • links

    このリソースに対する関連リソースおよびアクションへのHATEOSリンク。 リソースの正規表現へのリンクを含む自己リンクを少なくとも1つ含める必要があります。

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

このリソースに対する関連リソースおよびアクションへのHATEOSリンク。 リソースの正規表現へのリンクを含む自己リンクを少なくとも1つ含める必要があります。

ソースを表示
ネストされたスキーマ: items
すべてに一致
ソースを表示
  • 「リンク」
レスポンスの例 ()
{
    "description":"A folder for my assets."
}

400レスポンス

不正なリクエスト

401レスポンス

未認可

403レスポンス

禁止

404レスポンス

見つかりません
ヘッダー
本文()
ルート・スキーマ: schema
すべてに一致
ソースを表示
ネストされたスキーマ : ThemeNameAmbiguousExceptionDetail
リリース20.1.1で導入されました。
すべてに一致
ソースを表示
ネストされたスキーマ : ExceptionDetail
型: object

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

ソースを表示

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

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

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

  • o:errorDetails

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

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

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

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

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

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

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

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

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

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

名前に一致するテーマ。

リリース20.1.1で導入されました。
ソースを表示
ネストされたスキーマ: items
すべてに一致
ソースを表示
  • Theme

    テーマでは、色スキーム、フォント・サイズ、フォント・タイプ、ページ・バックグラウンドなど、サイトの一般的なルック・アンド・フィールや全体的なスタイルを定義します。 テーマは、サイト内のページ間に視覚的な統一感を与えます。 デザインを調整し、コンテンツを追加して、スタイル、ブランドおよびビジョンを売り込むサイトを作成します。

    リリース19.4.1.での導入。
ネストされたスキーマ : テーマ

テーマでは、色スキーム、フォント・サイズ、フォント・タイプ、ページ・バックグラウンドなど、サイトの一般的なルック・アンド・フィールや全体的なスタイルを定義します。 テーマは、サイト内のページ間に視覚的な統一感を与えます。 デザインを調整し、コンテンツを追加して、スタイル、ブランドおよびビジョンを売り込むサイトを作成します。

リリース19.4.1.での導入。
すべてに一致
ソースを表示
  • SingularResource

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

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

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

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

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

    リリース19.4.1.での導入。
  • createdBy

    このテーマを作成したユーザーまたはクライアント・アプリケーション。

    リリース19.4.1.での導入。
  • 最大長: 1000

    オプションの説明。 説明の内容に制限はありません。任意の文字を含む1行または複数行を指定できます。

    リリース19.4.1.での導入。

  • テーマの不変識別子。

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

    リリース19.4.1.での導入。

  • テーマがソフト削除されたことを示します。 対応するテーマ・フォルダは、テーマを所有するユーザーのごみ箱フォルダに配置されます。

    リリース19.4.1.での導入。

  • テーマがテーマであることを示します。 初期テーマとは、新しいサイトを開発する際の実験を目的とした既存のテーマのコピーです。

    リリース22.8.1で導入されました。
  • job

    テーマに割り当てられた現在のジョブのステータス。

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

  • 最終変更日時。 日付値と時間値は、UTCタイムゾーンを使用してISO 8601 yyyy-MM-dd'T'HH:mm:ss.SSS'Z'形式です。

    リリース19.4.1.での導入。
  • lastModifiedBy

    このテーマを最後に変更したユーザー、クライアント・アプリケーションまたはサービス。

    リリース19.4.1.での導入。
  • members

    テーマが共有されているユーザーおよびグループ。

    リリース19.4.3での導入。
  • 最大長: 255

    テーマの人に読める名前。

    リリース19.4.1.での導入。
  • ownedBy

    このテーマを所有するユーザーまたはクライアント・アプリケーション。

    リリース19.4.1.での導入。
  • permissions

    テーマのユーザー権限。

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

  • テーマが公開されているかどうかを示します。

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

    • unpublished - テーマは未公開です
    • published - テーマが公開されました

    リリース19.4.1.での導入。
ネストされたスキーマ : createdBy

このテーマを作成したユーザーまたはクライアント・アプリケーション。

リリース19.4.1.での導入。
すべてに一致
ソースを表示
  • 「アイデンティティ」
    識別子: type

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

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

テーマに割り当てられた現在のジョブのステータス。

リリース21.9.1で導入されました。
すべてに一致
ソースを表示
  • SiteJobStatus
    識別子: action

    サイト・ジョブのバックグラウンド・ジョブの詳細。

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

このテーマを最後に変更したユーザー、クライアント・アプリケーションまたはサービス。

リリース19.4.1.での導入。
すべてに一致
ソースを表示
  • 「アイデンティティ」
    識別子: type

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

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

テーマが共有されているユーザーおよびグループ。

リリース19.4.3での導入。
ソースを表示
  • items

    「テーマ・メンバー」要素のコレクション。

    リリース19.4.1.での導入。
すべてに一致
ソースを表示
  • CollectionResource

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

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

このテーマを所有するユーザーまたはクライアント・アプリケーション。

リリース19.4.1.での導入。
すべてに一致
ソースを表示
  • 「アイデンティティ」
    識別子: type

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

    リリース20.3.1で導入されました。
ネストされたスキーマ : 許可
型: object

テーマのユーザー権限。

リリース22.7.2で導入されました。
ソースを表示
  • annotation

    ユーザーが持つ注釈権限のセット。

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

    • read - 注釈を読む
    • write - 注釈の作成
    • update - 注釈の更新
    • delete - 注釈の削除

    リリース22.7.2で導入されました。
  • conversation

    ユーザーが持つ会話権限のセット。

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

    • read - 会話を読む
    • write - 会話への書込み
    • update - 会話の更新
    • delete - 会話の削除

    リリース22.7.2で導入されました。
  • file

    ユーザーが持つファイル・レベルのアクセス権のセット。

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

    • preview - ファイルのプレビュー
    • read - ファイルの読取り
    • write - ファイルへの書込み
    • update - 更新ファイル
    • delete - ファイルの削除

    リリース22.7.2で導入されました。
  • links
  • members

    ユーザーが持つメンバーの権限セット。

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

    • read - メンバーの読み取りと一覧表示
    • add - メンバーに追加
    • update - メンバーの更新
    • remove - メンバーの削除

    リリース22.7.2で導入されました。
  • self

    ユーザーが持つフォルダ・レベルの権限のセット。

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

    • preview - フォルダのプレビュー
    • read - フォルダの読取り
    • write - フォルダへの書込み
    • update - フォルダの更新
    • delete - フォルダ

    リリース22.7.2で導入されました。
  • shareLink
ネストされたスキーマ: 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で導入されました。
ソースを表示
ネストされたスキーマ : SiteJobStatus
識別子: action

サイト・ジョブのバックグラウンド・ジョブの詳細。

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

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

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

  • 「サイト・ジョブ・ステータス」のタイプ。 有効な値は次のとおりです: 、translate, copy, publish, importTranslations, hardDelete, copyTheme, copyComponent, refresh, publishTheme。

  • 非同期ジョブが完了したかどうか。

  • プロセスの完了数を取得し、0から100までの数値。 非同期ジョブが開始していない場合、完了率は提供されません。 すべてのバックグラウンド非同期ジョブが詳細なプロセスをサポートしているわけではないため、完了率はステップなしでゼロから100にジャンプできます。

  • レスポンスを元の非同期ジョブに関連付けるために使用できるジョブ・コンテキスト識別子の値。 非同期ジョブがどのように開始されたかによって、コンテキスト値があるかどうか、およびコンテキスト値は何かが決まります。

  • 非同期ジョブの実行が終了した時間、または非同期ジョブが失敗した時間。 非同期ジョブが終了していないか失敗した(または開始していない)場合、このプロパティは存在しません。 特定のバックグラウンド・ジョブは停止時間を記録しないことがあるため、ジョブが完了した場合、停止時間がない可能性があります。 日付値と時間値は、UTCタイムゾーンを使用してISO 8601 yyyy-MM-dd'T'HH:mm:ss.SSS'Z'形式です。

  • error

    ジョブの失敗時の非同期ジョブ・レスポンスのエラー詳細。 このオプションは、非同期ジョブが実行されたにも失敗した場合にのみ使用可能です。

  • クライアントがステータスを再度チェックするまでに待機する必要がある時間のヒントとして、1ミリ秒数。 この値がない場合、ポーリング間隔は提案されず、クライアントは必要に応じてポーリングできることを意味します。

  • 現在の処理ステータスに関する、人間が読み取り可能なメッセージ。 このメッセージは、エンド・ユーザーに進行状況を通知するために使用されます。 非同期リクエストまたはジョブは、判読可能なステータス・メッセージを提供しない場合があります。

  • 非同期ジョブの現在の進行状況。 これらの値は、非同期ジョブが終了したことを示します: succeeded、failed、aborted。 blockedの値は、非同期ジョブには人による承認の待機など、アクションが必要であることを意味します。 非同期ジョブが処理中であることを示す値は次のとおりです: pending、processing、paused。

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

    • pending - リクエストは実行を待機しています
    • processing - リクエストは実行中です
    • succeeded - リクエストは正常に完了しました
    • failed - リクエストに失敗しました
    処理リクエストが完了する前に失敗しました。
    • aborted - リクエストは中断されました
    処理リクエストが完了する前に中止されました。
    • paused - リクエストは実行中でしたが、現在は一時停止しています
    • blocked - リクエストはブロックされています
    リクエストには、人の承認を待機するなどのアクションが必要です。

  • 非同期ジョブ・リクエストのHTTPステータス・コード。 このステータスは、非同期ジョブ・ステータスの問合せ時に取得するステータスではなく、非同期ジョブが完了したときのステータス・レスポンスです。 この値は非同期ジョブの終了後のみ使用可能です。

  • result

    クライアントがステータスについてサービスをポーリングする際に結果を取得できるよう、ステータス・リソースに最終結果を含めることが望ましい場合もあります。 結果はこのオプション・プロパティで取得されます。 このプロパティは、HTTPレスポンスがステータス・リソース内で効率的に返される場合にのみ使用する必要があります。 このプロパティが存在する場合は、重複を避けるためにrequestStatusプロパティが省略されます。 レスポンスの本文は、レスポンス固有のプロパティで構成されるJSONオブジェクトです。 非JSONレスポンス・データは、Base64が、bodyプロパティ内のバイト文字列として非JSONデータをエンコードするか、ステータス・リソースのリンク・プロパティの非JSONリソースへのリンクを提供することでサポートされます。

  • 非同期ジョブの実行が開始された時間。 非同期ジョブが開始していない場合、このプロパティは表示されません。 特定のバックグラウンド・ジョブは開始時間を記録しないことがあるため、ジョブが開始した場合、開始時間がない可能性があります。 日付値と時間値は、UTCタイムゾーンを使用してISO 8601 yyyy-MM-dd'T'HH:mm:ss.SSS'Z'形式です。

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

ジョブの失敗時の非同期ジョブ・レスポンスのエラー詳細。 このオプションは、非同期ジョブが実行されたにも失敗した場合にのみ使用可能です。

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

クライアントがステータスについてサービスをポーリングする際に結果を取得できるよう、ステータス・リソースに最終結果を含めることが望ましい場合もあります。 結果はこのオプション・プロパティで取得されます。 このプロパティは、HTTPレスポンスがステータス・リソース内で効率的に返される場合にのみ使用する必要があります。 このプロパティが存在する場合は、重複を避けるためにrequestStatusプロパティが省略されます。 レスポンスの本文は、レスポンス固有のプロパティで構成されるJSONオブジェクトです。 非JSONレスポンス・データは、Base64が、bodyプロパティ内のバイト文字列として非JSONデータをエンコードするか、ステータス・リソースのリンク・プロパティの非JSONリソースへのリンクを提供することでサポートされます。

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

    非同期リクエストのHTTPレスポンスの取得など、構造化データとして返すことができるようにHTTPレスポンスを取得します。

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

非同期リクエストのHTTPレスポンスの取得など、構造化データとして返すことができるようにHTTPレスポンスを取得します。

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

HTTPレスポンス・ヘッダー。

ソースを表示
ネストされたスキーマ: status
型: object

HTTPステータス・コードのレスポンス値および理由。

ソースを表示

  • 例外に対応するHTTPステータス・コード。 リソースを含む例外には404のHTTPステータスが存在します。

  • 短い、判読可能なステータス・コードのサマリーです。

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

「テーマ・メンバー」要素のコレクション。

リリース19.4.1.での導入。
ソースを表示
ネストされたスキーマ : CollectionResource

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

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

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

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

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

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

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

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

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

ネストされたスキーマ: items
型: object
ソースを表示

  • ユーザー、クライアント・アプリケーションまたはグループの表示名。

    リリース19.4.1.での導入。
  • グループ

    メンバーのグループ詳細。 メンバーのタイプが「グループ」の場合にのみ使用できます。

    リリース19.4.1.での導入。

  • メンバーがグループの場合、グループのタイプが指定されます。 メンバーがユーザーの場合、このフィールドは存在しません。

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

    • oce - コンテンツ管理グループ
    • idp - アイデンティティ・プロバイダ・グループ

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

  • ユーザー、クライアント・アプリケーションまたはグループ・メンバーの識別子。

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

    リリース19.4.1.での導入。

  • 関連するユーザーまたはクライアント・アプリケーションに外部ユーザー・ロールのみがある場合、trueに設定されます。

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

  • ユーザー、クライアント・アプリケーションまたはグループの一意の名前。 メンバーがユーザーの場合、名前はユーザー名です。 メンバーがグループの場合、名前はグループ名です。

    リリース19.4.1.での導入。

  • ユーザー、クライアント・アプリケーションまたはグループが与えられた共有ロール。

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

    • owner - ユーザーが所有者です。
    • manager - ユーザーにマネージャ・ロールがあります
    • contributor - ユーザーにコントリビュータ・ロールがあります
    • downloader - ユーザーにはダウンロード実行者ロールがあります
    • viewer - ユーザーの参照者のロール

    リリース19.4.1.での導入。

  • メンバーがユーザー、クライアント・アプリケーションまたはグループであることを示します。

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

    • user - メンバーはユーザーまたはクライアント・アプリケーションです。 ユーザーまたはメンバー間で区別されません
    クライアント・アプリケーションであるメンバー。
    • group - メンバーはグループです

    リリース19.4.1.での導入。
  • user

    メンバーのユーザーまたはクライアント・アプリケーションの詳細。 メンバーのタイプがuserの場合にのみ使用できます。 メンバーは、ユーザー、クライアント・アプリケーションまたはグループにすることができます。 ユーザーとクライアント・アプリケーションの両方の詳細を読むことができます。

    リリース19.4.1.での導入。
ネストされたスキーマ : グループ

メンバーのグループ詳細。 メンバーのタイプが「グループ」の場合にのみ使用できます。

リリース19.4.1.での導入。
すべてに一致
ソースを表示
  • Group

    グループとは、ユーザーおよびグループの集合です。 グループには、ユーザーが読取り可能なグループ名があります。

    リリース19.3.1.での導入。
ネストされたスキーマ: user

メンバーのユーザーまたはクライアント・アプリケーションの詳細。 メンバーのタイプがuserの場合にのみ使用できます。 メンバーは、ユーザー、クライアント・アプリケーションまたはグループにすることができます。 ユーザーとクライアント・アプリケーションの両方の詳細を読むことができます。

リリース19.4.1.での導入。
すべてに一致
ソースを表示
  • 「アイデンティティ」
    識別子: type

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

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

グループとは、ユーザーおよびグループの集合です。 グループには、ユーザーが読取り可能なグループ名があります。

リリース19.3.1.での導入。
すべてに一致
ソースを表示
  • SingularResource

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

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

  • グループに対する、人間が読み取り可能な名前。

    リリース19.3.1.での導入。

  • サービス・インスタンス内で一意のグループ名。

    リリース19.3.1.での導入。

  • グループの一意の識別子。

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

    リリース19.3.1.での導入。
  • roles

    ロール

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

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

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

  • グループのタイプ。

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

    • oce - コンテンツ管理グループ
    • idp - アイデンティティ・プロバイダ・グループ

    リリース19.3.1.での導入。
ネストされたスキーマ: roles
型: array

ロール

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

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

リリース21.10.2で導入されました。
ソースを表示
ネストされたスキーマ : 注釈
型: array

ユーザーが持つ注釈権限のセット。

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

  • read - 注釈を読む
  • write - 注釈の作成
  • update - 注釈の更新
  • delete - 注釈の削除

リリース22.7.2で導入されました。
ソースを表示
ネストされたスキーマ : 会話
型: array

ユーザーが持つ会話権限のセット。

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

  • read - 会話を読む
  • write - 会話への書込み
  • update - 会話の更新
  • delete - 会話の削除

リリース22.7.2で導入されました。
ソースを表示
ネストされたスキーマ : file
型: array

ユーザーが持つファイル・レベルのアクセス権のセット。

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

  • preview - ファイルのプレビュー
  • read - ファイルの読取り
  • write - ファイルへの書込み
  • update - 更新ファイル
  • delete - ファイルの削除

リリース22.7.2で導入されました。
ソースを表示
ネストされたスキーマ: members
型: array

ユーザーが持つメンバーの権限セット。

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

  • read - メンバーの読み取りと一覧表示
  • add - メンバーに追加
  • update - メンバーの更新
  • remove - メンバーの削除

リリース22.7.2で導入されました。
ソースを表示
ネストされたスキーマ: self
型: array

ユーザーが持つフォルダ・レベルの権限のセット。

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

  • preview - フォルダのプレビュー
  • read - フォルダの読取り
  • write - フォルダへの書込み
  • update - フォルダの更新
  • delete - フォルダ

リリース22.7.2で導入されました。
ソースを表示
レスポンスの例(テーマ名のあいまいさ)
{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
    "title":"Theme Name Ambiguous",
    "status":"404",
    "detail":"Multiple themes exist with an identifier of '{theme.id}'.",
    "o:errorCode":"OCE-SITEMGMT-009087",
    "theme":{
        "id":"FFA7758925559C7F6FC394910D5DDCD9211A3DB216EC"
    },
    "themes":[
        {
            "id":"FFA7758925559C7F6FC394910D5DDCD9211A3DB216EC",
            "name":"CafeSupremoTheme",
            "isDeleted":false,
            "description":"A folder for my assets.",
            "createdAt":"2019-06-01T06:44:17.000Z",
            "lastModifiedAt":"2019-06-01T06:44:17.000Z",
            "publishStatus":"unpublished",
            "isStarter":false
        }
    ]
}
レスポンスの例(テーマが見つかりません)
{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
    "title":"Theme Not Found",
    "status":"404",
    "detail":"Theme does not exist or has been deleted, or the authenticated user or client application does not have access to the theme.",
    "o:errorCode":"OCE-SITEMGMT-009041",
    "theme":{
        "id":"FFA7758925559C7F6FC394910D5DDCD9211A3DB216EC"
    }
}

406レスポンス

受入れられない

416 レスポンス

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

429 レスポンス

リクエストが多すぎます

500レスポンス

内部サーバー・エラー

501レスポンス

実装されていない

502 レスポンス

ゲートウェイが不良

503レスポンス

サービス使用不可

504レスポンス

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