機械翻訳について

商談の取得

get

/crmRestApi/resources/11.13.18.05/deals/{dealsUniqID}/child/MatchedOpportunity/{OptyId}

リクエスト

パス・パラメータ
  • 商談の一意の識別子。
  • これは、ディール登録リソースのコンポジット・キーを構成し、ディール登録のインスタンスを一意に識別するために使用される属性のハッシュ・キーです。 クライアントはハッシュ・キー値を生成しないでください。 かわりに、クライアントはディール登録の特定のインスタンスに移動してハッシュ・キーを取得するために、ディール登録コレクション・リソースを問い合せる必要があります。
問合せパラメータ
  • このパラメータは、レスポンスの生成後に設定およびロールバックされるフィールドである依存関係を指定します。 通常、これらは属性変更の影響をプレビューするために使用されます。 このパラメータで指定されたフィールドは、常に問題のリソース・インスタンスで設定されます。 子リソース・コレクションがリクエストされ、パラメータが設定されると、リソース・コレクション・ペイロードを生成する前にフィールドが親リソース・インスタンスに設定されます。 この問合せパラメータの値は、依存性フィールドのセットです。 例: dependency=ProductId=2

    フォーマット: <attr1>=<val1>,<attr2>=<value2>
  • このパラメータを指定すると、指定した子がリソース・ペイロードに含まれます(リンクのみでなく)。 この問合せパラメータの値は"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
  • このパラメータは、単一のリソースまたはリソース・コレクションへのアクセス中に特定のリンクのみを表示するために使用できます。 パラメータ値書式は、次のカンマ区切りリストです : <link_relation>

    例:
    self,canonical
  • リソース・アイテム・ペイロードは、データのみを含めるようにフィルタされます(リンク・セクションなどは含まれません)。
ヘッダー・パラメータ
  • REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。 次に例を示します : Metadata-Context:sandbox="TrackEmployeeFeature".
  • RESTクライアントとサービスの間のプロトコル・バージョン。 クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。

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

トップに戻る

応答

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

デフォルトのレスポンス

次の表では、このタスクに対するデフォルトのレスポンスについて説明します。
ヘッダー
  • REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。 次に例を示します : Metadata-Context:sandbox="TrackEmployeeFeature".
  • RESTクライアントとサービスの間のプロトコル・バージョン。 クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。
本文( )
ルート・スキーマ : deals-MatchedOpportunity-item-response
タイプ: object
ソースを表示
  • タイトル: Account Number
    読取り専用: true
    最大長: 30
    一致した商談に関連付けられている取引先のパーティ番号。
  • 商談に関連付けられているアセットの一意の識別子。
  • タイトル: Asset Number
    最大長: 100
    商談に関連付けられたアセットの代替キー識別子。
  • タイトル: Asset
    商談に関連付けられているアセット製品。
  • タイトル: Asset Serial Number
    読取り専用: true
    最大長: 100
    商談に関連付けられているアセット・シリアル番号。
  • タイトル: Assignment Mode
    最大長: 30
    商談レコード更新の自動割当デフォルト動作を制御するために使用できる割当モード・オプションのタイプを指定します。
  • タイトル: Duration
    読取り専用: true
    商談が現在のセールス・ステージにとどまる平均期間(日数)。
  • タイトル: Batch Tag
    最大長: 30
    商談のバッチ・タグ。
  • タイトル: Budget Amount
    販売アカウントの予算金額。
  • タイトル: Budget Amount Currency
    最大長: 15
    販売アカウントの予算金額の通貨コード。
  • タイトル: Date Budget Available
    商談予算が使用可能になった日時。
  • タイトル: Budgeted
    最大長: 1
    デフォルト値: false
    商談販売アカウントに潜在的購買について承認された予算があるかどうかを示します。 値がtrueの場合、販売アカウントには購入の承認済予算があります。 デフォルト値は「False」です。
  • タイトル: Key Internal Sponsor
    最大長: 1
    デフォルト値: false
    商談に内部スポンサがあるかどうかを示します。 値がtrueの場合、商談には内部スポンサがあります。 デフォルト値は「False」です。
  • タイトル: Close Period
    読取り専用: true
    商談のクローズ期間。
  • タイトル: Comments
    最大長: 2000
    商談に対するユーザー指定のコメント。
  • タイトル: Conflict ID
    デフォルト値: 0
    切断されたモバイル: この値は、異なるデータベース(モバイル・データベースまたはサーバー)で重複が作成される場合に、行の一意性を保証するために使用されます。
  • タイトル: Created By
    読取り専用: true
    最大長: 64
    商談レコードを作成したユーザー。
  • タイトル: Creation Date
    読取り専用: true
    商談レコードが作成された日時。
  • タイトル: Conversion Rate
    このレートは、収益予測メトリックの計算を容易にするために、収益金額をCRM共通通貨に換算するために使用されます。 これは、特定の時点で1つの通貨を交換できる金額です。
  • タイトル: CRM Common Currency
    読取り専用: true
    最大長: 15
    CRM共通通貨コード。
  • タイトル: Currency
    最大長: 15
    一致した商談の通貨コード。 この属性は、CRM拡張フレームワークで使用されます。 有効な値のリストは、参照ZCA_COMMON_CORPORATE_CURRENCYで定義されます。 「設定およびメンテナンス」作業領域の通貨プロファイル・オプションの管理タスクを使用して、プロファイル・オプションをレビューおよび更新します。
  • タイトル: Billing Account
    商談に関連付けられている顧客請求アカウントの一意の識別子。
  • タイトル: Estimated Deal Duration
    最大長: 30
    ディールのクローズに必要な見積時間(日数)。 有効な値のリストは、参照MOO_SETID_DEAL_HORIZIONで定義されます。 「設定および保守」作業領域の「標準参照の管理」タスクを使用して、コードを確認、更新します。
  • タイトル: Decision Level
    最大長: 30
    商談の最終ディシジョンを行う個人のジョブ・レベル。 有効な値のリストは、参照MOO_SETID_DECISION_LEVELで定義されます。 「設定および保守」作業領域の「標準参照の管理」タスクを使用して、コードを確認、更新します。
  • 読取り専用: true
    商談を削除できるかどうかを示します。
  • タイトル: Sales Objective
    最大長: 2000
    営業目的を含む商談の摘要。
  • タイトル: Description
    読取り専用: true
    最大長: 255
    商談の営業目標の摘要。
  • タイトル: Worst Case
    デフォルト値: 0
    商談の売上の最小金額。
  • タイトル: Close Date
    商談がクローズされた日時。
  • タイトル: Owner Email
    読取り専用: true
    最大長: 320
    商談を所有する従業員リソースのEメール・アドレス。
  • タイトル: Expected Revenue
    デフォルト値: 0
    商談からの予想売上。
  • タイトル: Include in Forecast
    最大長: 30
    収益予測を上書きする必要があるかどうかを示すコード。 有効な値は、ALWAYS、NEVERおよびCRITERIAです。
  • タイトル: Hint Code
    読取り専用: true
    最大長: 10
    AIヒント・コード。
  • タイトル: Installed Base Asset
    商談の導入ベース・アセットの識別子。
  • タイトル: Installed Base Asset Number
    読取り専用: true
    最大長: 80
    商談の導入ベース・アセットのアセット番号。
  • タイトル: Installed Base Asset Serial Number
    読取り専用: true
    最大長: 80
    関連付けられた導入ベース・アセットのシリアル番号
  • タイトル: Primary Contact
    商談に関連付けられているプライマリ担当者の一意の識別子。
  • タイトル: Last Updated Date
    読取り専用: true
    商談レコードが最後に更新された日時。
  • タイトル: Last Updated By
    読取り専用: true
    最大長: 64
    商談レコードを最後に更新したユーザー。
  • タイトル: Last Update Login
    最大長: 32
    商談レコードを最後に更新したユーザーのログイン。
  • タイトル: Line of Business
    最大長: 30
    商談を所有する取扱商品を示すコード。
  • Links
  • タイトル: Status Category
    読取り専用: true
    最大長: 30
    商談ステータスのステータス・カテゴリ。
  • タイトル: Manage General Profile Data
    読取り専用: true
    競合相手、リード、ソース、担当者、参照、顧客対応、アセスメントなどの一般商談情報の管理を許可します。
  • タイトル: Manage Restricted Profile Data
    読取り専用: true
    販売メソッド、営業ステージ、販売アカウント、プライマリ担当者、パートナなどの制限された商談情報の管理を許可します。
  • タイトル: Manage Revenue Data
    読取り専用: true
    製品や経常収益情報などの収益データの管理を許可します。
  • タイトル: Manage Team Data
    読取り専用: true
    商談営業チーム・データの管理を許可します。
  • タイトル: Stalled Deal Limit
    読取り専用: true
    商談が中断とみなされるまでに営業ステージに残すことができる最大期間(日数)。
  • タイトル: Name
    最大長: 275
    商談の名前。
  • タイトル: Opportunity Origin
    最大長: 30
    デフォルト値: SALES_OPTY
    商談の発生元の値。
  • タイトル: Opportunity Type
    最大長: 30
    新規、更新、拡張など、様々なタイプの商談を表示します。
  • タイトル: Opportunity Created By
    最大長: 64
    商談を作成したユーザー。
  • タイトル: Opportunity Creation Date
    商談が作成された日時。
  • タイトル: Opportunity ID
    商談の一意の識別子。
  • タイトル: Opportunity Last Updated Date
    商談が最後に更新された日付。
  • タイトル: Opportunity Last Updated By
    最大長: 64
    商談を最後に更新したユーザー。
  • タイトル: Opportunity Number
    最大長: 30
    商談の一意の代替識別子。
  • タイトル: Owner Number
    読取り専用: true
    最大長: 30
    商談の所有者パーティ番号。
  • タイトル: Owner
    商談を所有および管理する有効な従業員リソースの一意の識別子。
  • タイトル: Owner
    読取り専用: true
    最大長: 360
    商談所有者の名前。
  • タイトル: Primary Competitor
    読取り専用: true
    最大長: 900
    商談のプライマリ競合会社の一意の名前。
  • タイトル: Phase
    読取り専用: true
    最大長: 30
    デフォルト値: "B - Working the Deal"
    商談営業ステージの現在のフェーズを示すコード。
  • タイトル: Predicted Win Probability
    読取り専用: true
    AIは受注確度を予測します。
  • タイトル: Primary Campaign ID
    一致した商談に関連付けられているプライマリ・キャンペーンの一意の識別子。
  • タイトル: Primary Campaign
    一致した商談に関連付けられたプライマリ・キャンペーンの名前。
  • タイトル: Primary Campaign Number
    最大長: 30
    一致した商談に関連付けられたプライマリ・キャンペーンの代替一意識別子。
  • タイトル: Primary Competitor
    商談に関連付けられているプライマリ競合相手の一意の識別子。
  • タイトル: Primary Competitor Party Number
    読取り専用: true
    最大長: 30
    商談に関連付けられているプライマリ競合相手のパーティ番号。
  • タイトル: Primary Contact Email
    読取り専用: true
    最大長: 320
    商談に関連付けられているプライマリ担当者のEメール・アドレス。
  • タイトル: Primary Contact Email Preference
    読取り専用: true
    最大長: 255
    プライマリ担当者のEメール・プリファレンスがEメール送信不可、Eメール送信可または値なしのいずれであるかを示します。
  • タイトル: Primary Contact Phone
    読取り専用: true
    商談に関連付けられているプライマリ担当者の電話番号。
  • タイトル: Primary Contact
    読取り専用: true
    最大長: 360
    商談に関連付けられているプライマリ担当者の名前。
  • タイトル: Primary Contact Party Number
    読取り専用: true
    最大長: 30
    商談に関連付けられているプライマリ担当者のパーティ番号。
  • タイトル: Primary Contact Phone Preference
    読取り専用: true
    最大長: 255
    プライマリ担当者の電話プリファレンスが電話不可、電話可または値なしのいずれであるかを示します。
  • タイトル: Business Unit ID
    商談に関連付けられているビジネス・ユニットの一意の識別子。
  • タイトル: Primary Partner Number
    最大長: 30
    商談に関連付けられているプライマリ・パートナのパーティ番号。
  • タイトル: Primary Partner
    商談に関連付けられているプライマリ・パートナの一意の識別子。
  • タイトル: Primary Partner
    最大長: 360
    商談に関連付けられているプライマリ・パートナの組織パーティ名。
  • タイトル: Summary Revenue Line ID
    商談に関連付けられている要約売上明細の一意の識別子。
  • タイトル: Primary Subscription Id
    商談のプライマリ・サブスクリプションの一意の識別子。
  • タイトル: Subscription Number
    読取り専用: true
    最大長: 120
    商談のプライマリ・サブスクリプションの代替識別子。
  • タイトル: Primary Source Number
    最大長: 100
    商談を生成したプライマリ・マーケティング・ソースまたはキャンペーンの一意の識別子。
  • タイトル: Quota Factor
    読取り専用: true
    商談営業ステージの目標ファクタ。
  • タイトル: Quoted
    最大長: 1
    デフォルト値: false
    この商談に対して見積が作成されたことを示します。
  • タイトル: Win Probability
    読取り専用: true
    デフォルト値: 0
    営業ステージで商談を成約させる推奨確度。
  • タイトル: Win/Loss Reason
    最大長: 30
    商談を成約または失注した理由。 有効な値のリストは、参照MOO_SETID_WIN_LOSS_REASONで定義されます。 「設定および保守」作業領域の「標準参照の管理」タスクを使用して、コードを確認、更新します。
  • タイトル: Recommended Action
    読取り専用: true
    最大長: 180
    AI推奨アクション。
  • 読取り専用: true
    商談のレコード・セット。
  • タイトル: Registered
    最大長: 30
    商談が登録されたかどうかを示します。 有効な値は、失効済、はいおよびいいえです。
  • タイトル: Registration Status
    最大長: 30
    商談の登録ステータス。
  • タイトル: Registration Type
    最大長: 30
    商談を作成するためにパートナが使用する登録タイプ。
  • タイトル: Renewal Process
    最大長: 30
    更改プロセスは、手動、更改なしまたは自動更改の場合があります。
  • タイトル: Amount
    デフォルト値: 0
    商談の売上額。
  • タイトル: Level of Risk
    最大長: 30
    商談のリスク・レベル・コード。 有効な値のリストは、参照MOO_SETID_RISK_LEVEで定義されます。 「設定および保守」作業領域の「標準参照の管理」タスクを使用して、コードを確認、更新します。
  • タイトル: Customer Account
    読取り専用: true
    最大長: 900
    商談を所有する販売アカウントの一意の名前。
  • タイトル: Sales Channel
    最大長: 50
    商談の販売チャネルを示すコード。
  • タイトル: Sales Method
    読取り専用: true
    最大長: 50
    商談に関連付けられている販売メソッド。
  • タイトル: Sales Method
    商談に関連付けられている販売メソッドの一意の識別子。
  • タイトル: Sales Stage
    読取り専用: true
    最大長: 50
    商談の現在のセールス・ステージ。
  • タイトル: Sales Stage
    商談に関連付けられている営業ステージの一意の識別子。
  • 一致した商談が選択されているかどうかを示します。
  • タイトル: Source Type
    読取り専用: true
    商談のソース・タイプ。
  • タイトル: Status
    読取り専用: true
    最大長: 30
    デフォルト値: "Open"
    商談に関連付けられている営業ステージのデフォルト・ステータスを示すコード。
  • タイトル: Status
    最大長: 30
    商談のステータス。 有効な値のリストは、参照MOO_OPTY_STATUSで定義されます。 「設定および保守」作業領域の「標準参照の管理」タスクを使用して、コードを確認、更新します。
  • タイトル: Order
    読取り専用: true
    販売メソッドにおける商談のセールス・ステージの順序。
  • タイトル: Strategic Value
    最大長: 30
    販売アカウントに対する商談の戦略的価値。 有効な値のリストは、参照MOO_SETID_STRATEGIC_VALUEで定義されます。 「設定および保守」作業領域の「標準参照の管理」タスクを使用して、コードを確認、更新します。
  • タイトル: Account
    商談に関連付けられている販売アカウントの一意の識別子。
  • タイトル: Account
    読取り専用: true
    最大長: 360
    商談に関連付けられている販売アカウントの名前。
  • タイトル: Account Country
    読取り専用: true
    最大長: 2
    プライマリ取引先のプライマリ住所の国。
  • 読取り専用: true
    商談を更新できるかどうかを示します。
  • タイトル: Best Case
    デフォルト値: 0
    商談の最大売上金額。
  • タイトル: Win Probability
    商談を成約させる推定確度。
トップに戻る

例:

次の例は、cURLを使用してRESTリソースに対するgetリクエストを発行して、商談を取得する方法を示しています。

cURLコマンド

curl -u <username:password> \ -X https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/deals/300100071991763/child/MatchedOpportunity/300100089504947

レスポンス本文の例

次に、JSON形式のレスポンス本文の例を示します。

{    
  PrimaryOrganizationId: 100000015105046
  ChampionFlag: false
  CurrencyCode: "USD"
  SalesMethodId: 100000012430001
  SalesStageId: 100000012430007
  Name: "Major Application Upgrade"
  OptyId: 300100089504947
  OptyNumber: "CDRM_98919"
  OwnerResourcePartyId: 100000016934102
  ...
}

「トップに戻る」