機械翻訳について

Lightboxプレゼンテーション・セッションをすべて取得

get

/crmRestApi/resources/11.13.18.05/presentationSessions

リクエスト

問合せパラメータ
  • このパラメータを指定すると、指定した子がリソース・ペイロードに含まれます(リンクのみでなく)。 この問合せパラメータの値は"all"または""です。 カンマをセパレータとして使用して、複数の子を指定できます。 例: ?expand=Employees,Localizations. ネストされた子は、"Child.NestedChild"の書式に従って指定することもできます(例): ?expand=Employees.Managers). ネストされた子が指定されている場合(例): Employees.Managers)。欠落している子は暗黙的に処理されます。 たとえば、"?expand=Employees.Managers"は"?expand=Employees,Employees.Managers"と同じです(これにより、従業員とマネージャが展開されます)。
  • このパラメータは、リソース・フィールドをフィルタします。 指定されたフィールドのみが返されます。つまり、フィールドが指定されていない場合、フィールドは返されません(リンクのみを取得する場合に便利です)。 間接子リソースが指定されている場合(例): Employees.Managers)。欠落している子は暗黙的に処理されます。 たとえば、"?fields=Employees.Managers:Empname"は"?fields=;Employees:;Employees.Managers:Empname" (これはマネージャの"Empname"フィールドのみを返す)と同じです。この問合せパラメータの値は、リソース・フィールドのリストです。 属性は直接にすることができます(例): 従業員または間接(例): Employees.Managers) child. 拡張問合せパラメータと組み合せることはできません。 両方を指定した場合、フィールドのみが考慮されます。

    フォーマット : ?fields=Attribute1,Attribute2

    子リソースのフィールドの書式 : ?fields=Accessor1:Attribute1,Attribute2
  • コレクションを検索するための事前定義済ファインダとして使用されます。

    フォーマット : ?finder=<finderName>;<variableName>=<variableValue>,<variableName2>=<variableValue2>

    使用可能なファインダ名および対応するファインダ変数を次に示します:

    • MyPresentationSessionsRF : 現在のユーザーが作成したLightboxプレゼンテーション・セッションを検索します。
      ファインダ変数:
      • PresentationSessionSearchRF : 指定した主キーでLightboxプレゼンテーション・セッションを検索します。
        ファインダ変数:
        • BindAccountId; integer;アカウントの一意の識別子。
        • BindActivityId; integer;アクティビティの一意の識別子。
        • BindSessionDateFrom; string;指定した最も早い日付からLightboxプレゼンテーション・セッションを検索します。
        • BindSessionDateTo; string;指定した日付までのLightboxプレゼンテーション・セッションを検索します。
        • BindSessionOwnerId; integer;所有者の一意の識別子。
      • PrimaryKey : 指定した主キーでLightboxプレゼンテーション・セッションを検索します。
        ファインダ変数:
        • PresentationSessionId; integer; Lightboxプレゼンテーション・セッションの一意の識別子。
    • このパラメータは、リソース・コレクション内で返されるリソースの数を制限します。 制限がリソース数を超えると、フレームワークは使用可能なリソースのみを返します。
    • このパラメータは、単一のリソースまたはリソース・コレクションへのアクセス中に特定のリンクのみを表示するために使用できます。 パラメータ値書式は、次のカンマ区切りリストです : <link_relation>

      例:
      self,canonical
    • リソース・コレクションの開始位置を定義するために使用します。 オフセットがリソース数を超えると、リソースは返されません。 デフォルト値は0です。
    • リソース・アイテム・ペイロードは、データのみを含めるようにフィルタされます(リンク・セクションなどは含まれません)。
    • このパラメータは、指定されたフィールドに基づいてリソース・コレクションを順序付けます。 パラメータ値は、属性名のカンマ区切りの文字列で、それぞれオプションでコロンと「asc」または「desc」が続きます。 昇順の場合は「asc」、降順の場合は「desc」を指定します。 デフォルト値は「asc」です。 たとえば、?orderBy=field1:asc,field2:descです
    • この問合せパラメータは、where句を定義します。 リソース・コレクションは、指定された式を使用して問い合せられます。 この問合せパラメータの値は、1つ以上の式です。 例 : ?q=部門番号>=10および<= 30;Loc!=NY

      フォーマット : ?q=expression1;expression2

      次の問合せ可能属性を使用して、q問合せパラメータを使用してこの収集リソースをフィルタできます:
      • AccountId; integer; プレゼンテーション・セッションが行われたアカウントの一意の識別子。 デフォルト値は、作成時に指定されないかぎり、アクティビティから取得されます。
      • AccountName; string; プレゼンテーション・セッションが行われたアカウントの名前。
      • AccountPartyNumber; string; プレゼンテーション・セッションが行われたアカウントのレジストリ識別子。
      • ActivityAccountId; integer;アクティビティ・アカウントの一意の識別子。 この属性は、アドホック・プレゼンテーション・セッションでは使用できません。
      • ActivityAccountName; string;プレゼンテーション・セッションのアクティビティ・アカウントの名前。 この属性は、アドホック・プレゼンテーション・セッションでは使用できません。
      • ActivityAccountPartyNumber; string; プレゼンテーション・セッションのアクティビティ・アカウントのレジストリ識別子。 この属性は、アドホック・プレゼンテーション・セッションでは使用できません。
      • ActivityId; integer; プレゼンテーション・セッションのアクティビティの一意の識別子。
      • ActivityNumber; string; プレゼンテーション・セッションのアクティビティ番号。
      • ActivitySubject; string;プレゼンテーション・セッションのアクティビティの件名。
      • CreatedBy; string; レコードを作成したユーザー。
      • CreationDate; string;レコードが作成された日付。
      • LastUpdateDate; string; レコードが最後に更新された日付。
      • LastUpdateLogin; string; レコードを最後に更新したユーザーのログイン。
      • LastUpdatedBy; string; レコードを最後に更新したユーザー。
      • PresentationSessionId; integer; Lightboxプレゼンテーション・セッションの一意の識別子。
      • SessionDate; string; Lightboxプレゼンテーション・セッションが実行された日時。 デフォルト値は、作成時に指定されないかぎり、アクティビティから取得されます。
      • SessionOwnerEmailAddress; string; プレゼンテーション・セッションの所有者の電子メール・アドレス。
      • SessionOwnerId; integer; プレゼンテーション・セッションの所有者の一意の識別子。 この個人は、Lightbox文書の主要なプレゼンタです。 デフォルト値は、作成時に指定されないかぎり、ユーザーのPartyIdから取得されます。
      • SessionOwnerName; string;プレゼンテーション・セッションの所有者の名前。
      • SessionOwnerTitle; string;プレゼンテーション・セッションの所有者のタイトル。
      • TotalSessionDisplayDuration; number;すべてのプレゼンテーション・セッションの合計時間には、プレゼンテーション・セッション中に表示されたすべてのLightbox文書ページのイベントが表示されます。 値は秒単位です。
    • "?totalResults=true"の場合、リソース・コレクション表現には"推定行数"が含まれます。それ以外の場合、カウントは含まれません。 デフォルト値はfalseです。
    ヘッダー・パラメータ
    • REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。 次に例を示します : Metadata-Context:sandbox="TrackEmployeeFeature".
    • RESTクライアントとサービスの間のプロトコル・バージョン。 クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。

    この操作にはリクエスト本文がありません。

    トップに戻る

    応答

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

    デフォルトのレスポンス

    次の表では、このタスクに対するデフォルトのレスポンスについて説明します。
    ヘッダー
    • REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。 次に例を示します : Metadata-Context:sandbox="TrackEmployeeFeature".
    • RESTクライアントとサービスの間のプロトコル・バージョン。 クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。
    本文( )
    ルート・スキーマ : presentationSessions
    タイプ: object
    ソースを表示
    ネストされたスキーマ : アイテム
    タイプ: array
    タイトル: Items
    コレクション内のアイテム。
    ソースを表示
    ネストされたスキーマ : presentationSessions-item-response
    タイプ: object
    ソースを表示
    • タイトル: Account ID
      プレゼンテーション・セッションが行われた取引先の一意の識別子。 デフォルト値は、作成時に指定されないかぎり、アクティビティから取得されます。
    • タイトル: Account
      最大長: 360
      プレゼンテーション・セッションが行われた取引先の名前。
    • タイトル: Registry ID
      読取り専用: true
      最大長: 30
      プレゼンテーション・セッションが実施されたアカウントのレジストリ識別子。
    • タイトル: Activity Account ID
      読取り専用: true
      アクティビティ・アカウントの一意の識別子。 この属性は、アドホック・プレゼンテーション・セッションでは使用できません。
    • タイトル: Activity Account
      読取り専用: true
      最大長: 900
      プレゼンテーション・セッションのアクティビティ・アカウントの名前。 この属性は、アドホック・プレゼンテーション・セッションでは使用できません。
    • タイトル: Activity Registry ID
      読取り専用: true
      最大長: 30
      プレゼンテーション・セッションのアクティビティ・アカウントのレジストリ識別子。 この属性は、アドホック・プレゼンテーション・セッションでは使用できません。
    • タイトル: Activity ID
      プレゼンテーション・セッションの活動の一意の識別子。
    • タイトル: Activity Number
      読取り専用: true
      最大長: 64
      プレゼンテーション・セッションの活動番号。
    • タイトル: Subject
      読取り専用: true
      最大長: 500
      プレゼンテーション・セッションの活動の件名。
    • タイトル: Created By
      読取り専用: true
      最大長: 64
      レコードを作成したユーザー。
    • タイトル: Creation Date
      読取り専用: true
      レコードが作成された日付。
    • 読取り専用: true
      レコードを削除できるかどうかを示します。 デフォルト値はtrueです。
    • タイトル: Last Updated Date
      読取り専用: true
      レコードが最後に更新された日付。
    • タイトル: Last Updated By
      読取り専用: true
      最大長: 64
      レコードを最後に更新したユーザー。
    • タイトル: Last Update Login
      読取り専用: true
      最大長: 32
      レコードを最後に更新したユーザーのログイン。
    • Links
    • タイトル: Session ID
      Lightboxプレゼンテーション・セッションの一意の識別子。
    • Presentation Session Attendance Events
      タイトル: Presentation Session Attendance Events
      プレゼンテーション・セッション出席イベント・リソースは、イベント出席を表示および作成するために使用します。 プレゼンテーション・セッション・イベントの出席は、Lightbox文書が表示されたときにセッションに参加したオーディエンスを追跡するために使用されます。
    • タイトル: Session Date
      Lightboxプレゼンテーション・セッションが実行された日時。 デフォルト値は、作成時に指定されないかぎり、アクティビティから取得されます。
    • Presentation Session Display Events
      タイトル: Presentation Session Display Events
      プレゼンテーション・セッション表示イベント・リソースは、表示イベントを表示および作成するために使用します。 プレゼンテーション・セッション中にLightbox文書ページが表示されていた開始時間と停止時間を記録するイベントを表示します。
    • タイトル: Owner Primary Email
      読取り専用: true
      最大長: 320
      プレゼンテーション・セッションの所有者の電子メール・アドレス。
    • タイトル: Session Owner ID
      プレゼンテーション・セッションの所有者の一意の識別子。 この個人は、Lightbox文書の主要なプレゼンタです。 デフォルト値は、作成時に指定されないかぎり、ユーザーのPartyIdから取得されます。
    • タイトル: Owner Name
      読取り専用: true
      最大長: 360
      プレゼンテーション・セッションの所有者の名前。
    • タイトル: Owner Title
      読取り専用: true
      最大長: 60
      プレゼンテーション・セッションの所有者のタイトル。
    • タイトル: Total Session Display Duration
      読取り専用: true
      デフォルト値: 1
      すべてのプレゼンテーション・セッションの合計時間には、プレゼンテーション・セッション中に表示されたすべてのLightbox文書ページのイベントが表示されます。 値は秒単位です。
    • 読取り専用: true
      レコードを更新できるかどうかを示します。 デフォルト値はtrueです。
    ネストされたスキーマ : プレゼンテーション・セッション出席イベント
    タイプ: array
    タイトル: Presentation Session Attendance Events
    プレゼンテーション・セッション出席イベント・リソースは、イベント出席を表示および作成するために使用します。 プレゼンテーション・セッション・イベントの出席は、Lightbox文書が表示されたときにセッションに参加したオーディエンスを追跡するために使用されます。
    ソースを表示
    ネストされたスキーマ : プレゼンテーション・セッション表示イベント
    タイプ: array
    タイトル: Presentation Session Display Events
    プレゼンテーション・セッション表示イベント・リソースは、表示イベントを表示および作成するために使用します。 プレゼンテーション・セッション中にLightbox文書ページが表示されていた開始時間と停止時間を記録するイベントを表示します。
    ソースを表示
    ネストされたスキーマ : presentationSessions-sessionAttendanceEvents-item-response
    タイプ: object
    ソースを表示
    ネストされたスキーマ : presentationSessions-sessionDisplayEvents-item-response
    タイプ: object
    ソースを表示
    トップに戻る

    例:

    次の例は、cURLを使用してRESTリソースに対するGETリクエストを発行することによって、すべてのLightboxプレゼンテーション・セッションを取得する方法を示しています。

    cURLコマンド

    curl -u <username:password> \ -X GET https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/presentationSessions

    レスポンス本文の例

    次の例は、JSON形式のレスポンス本文のコンテンツを示しています。

    {
      "items": [
        {
          "PresentationSessionId": 300100089786735,
          "SessionDate": "2017-02-21T05:48:17+00:00",
          "ActivityId": null,
          "ActivitySubject": null,
          "ActivityNumber": null,
          "AccountId": null,
          "AccountName": null,
          "AccountPartyNumber": null,
          "ActivityAccountId": null,
          "ActivityAccountName": null,
          "ActivityAccountPartyNumber": null,
          "SessionOwnerId": 100010032752947,
          "SessionOwnerName": "Ryan,Katy",
          "SessionOwnerEmailAddress": "email@your_organization.com",
          "SessionOwnerTitle": null,
          "CreatedBy": "KRyan",
          "CreationDate": "2017-02-21T05:48:27+00:00",
          "LastUpdateDate": "2017-02-21T05:48:27+00:00",
          "LastUpdateLogin": "4904EDC6284F3784E0533DD7F00A5CB2",
          "LastUpdatedBy": "KRyan",
          "TotalSessionDisplayDuration": null,
          "DeleteFlag": true,
          "UpdateFlag": true,
          "links": 
    	  ...
        },
        {
          "PresentationSessionId": 300100089786740,
          "SessionDate": "2017-02-16T00:30:00+00:00",
          "ActivityId": 300100089786738,
          "ActivitySubject": "Payload Examples",
          "ActivityNumber": "CDRM_56153",
          "AccountId": 1004,
          "AccountName": "Hilman and Associates",
          "AccountPartyNumber": "1004",
          "ActivityAccountId": 1004,
          "ActivityAccountName": "Hilman and Associates US)",
          "ActivityAccountPartyNumber": "1004",
          "SessionOwnerId": 100010032752947,
          "SessionOwnerName": "Ryan,Katy",
          "SessionOwnerEmailAddress": "email@your_organization.com",
          "SessionOwnerTitle": null,
          "CreatedBy": "KRyan",
          "CreationDate": "2017-02-21T06:07:55+00:00",
          "LastUpdateDate": "2017-02-21T06:07:55+00:00",
          "LastUpdateLogin": "4904EDC6284F3784E0533DD7F00A5CB2",
          "LastUpdatedBy": "KRyan",
          "TotalSessionDisplayDuration": null,
          "DeleteFlag": true,
          "UpdateFlag": true,
          "links": 
    	  ...
        }
      ],
      "count": 2,
      "hasMore": false,
      "limit": 25,
      "offset": 0,
      "links": 
      ...
    }
    
    「トップに戻る」