機械翻訳について

パートナ・プログラムの更新

patch

/crmRestApi/resources/11.13.18.05/partnerPrograms/{ProgramNumber}

リクエスト

パス・パラメータ
ヘッダー・パラメータ
  • REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。 次に例を示します : Metadata-Context:sandbox="TrackEmployeeFeature".
  • RESTクライアントとサービスの間のプロトコル・バージョン。 クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。
サポートされるメディア・タイプ
リクエスト本文 - application/json ()
次の表では、このタスクのリクエストの本文パラメータについて説明します。
ルート・スキーマ : スキーマ
タイプ: object
ソースを表示
  • Attachments
    タイトル: Attachments
    添付リソースは、添付の表示、作成および更新に使用されます。
  • タイトル: End Date
    パートナ・プログラムが終了する日付。
  • Countries
    タイトル: Countries
    国のリソースは、パートナ・プログラムに関連付けられた国を表示、作成、更新および削除するために使用されます。 国のリソースは、特定の国のパートナ・プログラムの可用性の範囲を決定するために使用されます。
  • Program Benefit Details
    タイトル: Program Benefit Details
    プログラム福利厚生詳細リソースは、パートナ・プログラムに追加されたプログラム福利厚生の表示、作成、更新および削除に使用されます。
  • タイトル: Description
    最大長: 1000
    プログラムを説明するテキスト。
  • タイトル: Program Manager ID
    パートナ・プログラムの所有者の一意の識別子。
  • タイトル: Owner
    最大長: 360
    パートナ・プログラムの所有者/管理者の名前。
  • タイトル: Name
    最大長: 150
    パートナ・プログラムの名前。
  • Tiers
    タイトル: Tiers
    パートナ・プログラム階層リソースは、特定のプログラムの階層を表示、作成、更新および削除するために使用されます。 パートナ・プログラムは、階層に編成し、ビジネスへの貢献度に基づいてパートナに割り当てることができます。
  • タイトル: Type
    最大長: 30
    パートナ・プログラムのタイプ。 たとえば、再販業者やGo-To-Marketなどです。
  • タイトル: Start Date
    パートナ・プログラムが開始する日付。
  • タイトル: Status
    最大長: 30
    デフォルト値: D
    プログラムのステータスを示すコード。 たとえば、ドラフト、失敗、公開済、拒否済、保留中、終了済、未公開などがあります。 有効な値のリストは、参照ZPM_PROGRAM_STATUSで定義されます。
ネストされたスキーマ : 添付ファイル
タイプ: array
タイトル: Attachments
添付リソースは、添付の表示、作成および更新に使用されます。
ソースを表示
ネストされたスキーマ : 国
タイプ: array
タイトル: Countries
国のリソースは、パートナ・プログラムに関連付けられた国を表示、作成、更新および削除するために使用されます。 国のリソースは、特定の国のパートナ・プログラムの可用性の範囲を決定するために使用されます。
ソースを表示
ネストされたスキーマ : プログラム給付金詳細
タイプ: array
タイトル: Program Benefit Details
プログラム福利厚生詳細リソースは、パートナ・プログラムに追加されたプログラム福利厚生の表示、作成、更新および削除に使用されます。
ソースを表示
ネストされたスキーマ : 階層
タイプ: array
タイトル: Tiers
パートナ・プログラム階層リソースは、特定のプログラムの階層を表示、作成、更新および削除するために使用されます。 パートナ・プログラムは、階層に編成し、ビジネスへの貢献度に基づいてパートナに割り当てることができます。
ソースを表示
ネストされたスキーマ : スキーマ
タイプ: object
ソースを表示
ネストされたスキーマ : partnerPrograms-PartnerProgramCountries-item-patch-request
タイプ: object
ソースを表示
ネストされたスキーマ : partnerPrograms-ProgramBenefitDetails-item-patch-request
タイプ: object
ソースを表示
  • プログラム特典の値タイプが「リスト」の場合のプログラム階層特典のリスト値。
  • タイトル: Benefit Value
    最大長: 150
    プログラム階層の値には、プログラム・ベネフィットの値タイプに適した書式の利点があります。
  • タイトル: Tier
    プログラム階層特典が適用される階層の一意の識別子。
ネストされたスキーマ : partnerPrograms-ProgramTiers-item-patch-request
タイプ: object
ソースを表示
トップに戻る

応答

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

デフォルトのレスポンス

次の表では、このタスクに対するデフォルトのレスポンスについて説明します。
ヘッダー
  • REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。 次に例を示します : Metadata-Context:sandbox="TrackEmployeeFeature".
  • RESTクライアントとサービスの間のプロトコル・バージョン。 クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。
本文( )
ルート・スキーマ : partnerPrograms-item-response
タイプ: object
ソースを表示
  • Attachments
    タイトル: Attachments
    添付リソースは、添付の表示、作成および更新に使用されます。
  • タイトル: Countries
    読取り専用: true
    プログラムに適用される国のリスト。
  • タイトル: Created By
    読取り専用: true
    最大長: 64
    行を作成したユーザー。
  • タイトル: Creation Date
    読取り専用: true
    行が作成された日時。
  • 読取り専用: true
    プログラムを削除できるかどうかを示します。 値がYの場合、プログラムを削除できます。 デフォルト値はNです。
  • タイトル: End Date
    パートナ・プログラムが終了する日付。
  • タイトル: Last Updated Date
    読取り専用: true
    行が最後に更新された日時。
  • タイトル: Last Updated By
    読取り専用: true
    最大長: 64
    行を最後に更新したユーザー。
  • 読取り専用: true
    最大長: 32
    プログラムを最後に更新したユーザーのログイン。
  • Links
  • タイトル: Owner Party Number
    読取り専用: true
    最大長: 30
    パートナ・プログラムの所有者パーティの公開一意識別子です。
  • Countries
    タイトル: Countries
    国のリソースは、パートナ・プログラムに関連付けられた国を表示、作成、更新および削除するために使用されます。 国のリソースは、特定の国のパートナ・プログラムの可用性の範囲を決定するために使用されます。
  • タイトル: Program ID
    パートナ・プログラムのシステム生成の一意の識別子および主キー。
  • Program Benefit Details
    タイトル: Program Benefit Details
    プログラム福利厚生詳細リソースは、パートナ・プログラムに追加されたプログラム福利厚生の表示、作成、更新および削除に使用されます。
  • タイトル: Description
    最大長: 1000
    プログラムを説明するテキスト。
  • タイトル: Program Manager ID
    パートナ・プログラムの所有者の一意の識別子。
  • タイトル: Owner
    最大長: 360
    パートナ・プログラムの所有者/管理者の名前。
  • タイトル: Name
    最大長: 150
    パートナ・プログラムの名前。
  • タイトル: Program Number
    最大長: 30
    プログラムごとに生成される代替キー識別子。
  • Tiers
    タイトル: Tiers
    パートナ・プログラム階層リソースは、特定のプログラムの階層を表示、作成、更新および削除するために使用されます。 パートナ・プログラムは、階層に編成し、ビジネスへの貢献度に基づいてパートナに割り当てることができます。
  • タイトル: Type
    最大長: 30
    パートナ・プログラムのタイプ。 たとえば、再販業者やGo-To-Marketなどです。
  • タイトル: Start Date
    パートナ・プログラムが開始する日付。
  • タイトル: Status
    最大長: 30
    デフォルト値: D
    プログラムのステータスを示すコード。 たとえば、ドラフト、失敗、公開済、拒否済、保留中、終了済、未公開などがあります。 有効な値のリストは、参照ZPM_PROGRAM_STATUSで定義されます。
  • 読取り専用: true
    プログラムを更新できるかどうかを示します。 値がYの場合、プログラムを更新できます。 デフォルト値はNです。
ネストされたスキーマ : 添付ファイル
タイプ: array
タイトル: Attachments
添付リソースは、添付の表示、作成および更新に使用されます。
ソースを表示
ネストされたスキーマ : 国
タイプ: array
タイトル: Countries
国のリソースは、パートナ・プログラムに関連付けられた国を表示、作成、更新および削除するために使用されます。 国のリソースは、特定の国のパートナ・プログラムの可用性の範囲を決定するために使用されます。
ソースを表示
ネストされたスキーマ : プログラム給付金詳細
タイプ: array
タイトル: Program Benefit Details
プログラム福利厚生詳細リソースは、パートナ・プログラムに追加されたプログラム福利厚生の表示、作成、更新および削除に使用されます。
ソースを表示
ネストされたスキーマ : 階層
タイプ: array
タイトル: Tiers
パートナ・プログラム階層リソースは、特定のプログラムの階層を表示、作成、更新および削除するために使用されます。 パートナ・プログラムは、階層に編成し、ビジネスへの貢献度に基づいてパートナに割り当てることができます。
ソースを表示
ネストされたスキーマ : partnerPrograms-Attachments-item-response
タイプ: object
ソースを表示
ネストされたスキーマ : partnerPrograms-PartnerProgramCountries-item-response
タイプ: object
ソースを表示
ネストされたスキーマ : partnerPrograms-ProgramBenefitDetails-item-response
タイプ: object
ソースを表示
  • プログラム特典の値タイプが「リスト」の場合のプログラム階層特典のリスト値。
  • タイトル: Benefit Value
    最大長: 150
    プログラム階層の値には、プログラム・ベネフィットの値タイプに適した書式の利点があります。
  • タイトル: Category
    読取り専用: true
    最大長: 30
    プログラム特典のカテゴリを示すコード。 有効な値のリストは、参照ORA_ZPM_BENEFIT_CATEGORYで定義されます。
  • タイトル: Created By
    読取り専用: true
    最大長: 64
    行を作成したユーザー。
  • タイトル: Creation Date
    読取り専用: true
    行が作成された日時。
  • タイトル: Value Type
    読取り専用: true
    最大長: 30
    プログラム特典の値タイプ。
  • 読取り専用: true
    プログラム特典を削除できるかどうかを示します。 値がYの場合、プログラム特典は削除できます。 デフォルト値はNです。
  • タイトル: Benefits Description
    読取り専用: true
    最大長: 1000
    プログラム特典を説明するテキスト。
  • タイトル: Last Updated Date
    読取り専用: true
    行が最後に更新された日時。
  • タイトル: Last Updated By
    読取り専用: true
    最大長: 64
    行を最後に更新したユーザー。
  • タイトル: Last Update Login
    読取り専用: true
    最大長: 32
    プログラム特典詳細を最後に更新したユーザーのログイン。
  • Links
  • タイトル: Name
    最大長: 155
    プログラム階層特典の名前。
  • タイトル: Program
    プログラム階層特典が追加されたパートナ・プログラムの一意の識別子。
  • タイトル: Program Benefit Details
    システム生成の一意の識別子およびプログラム階層特典の主キー。
  • タイトル: Benefit
    プログラムまたはプログラム階層に追加されるプログラム・ベネフィットの一意の識別子。
  • タイトル: Tier
    プログラム階層特典が適用される階層の一意の識別子。
  • タイトル: Name
    読取り専用: true
    最大長: 155
    プログラム階層特典が適用される階層の名前。
  • 読取り専用: true
    プログラム特典を更新できるかどうかを示します。 値がYの場合、プログラム特典を更新できます。 デフォルト値はNです。
ネストされたスキーマ : partnerPrograms-ProgramTiers-item-response
タイプ: object
ソースを表示
トップに戻る

例:

次の例は、cURLを使用してRESTリソースに対するパッチ・リクエストを発行することによって、パートナ・プログラムを更新する方法を示しています。

cURLコマンド

curl -v -u Username:Password curl -v -u Username:Password -H "content-type:application/vnd.oracle.adf.resourceitem+json" -X PATCH "http://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/partnerPrograms/CDRM_12005" -d '{request_payload}'

リクエスト本文の例

次に、JSON形式のリクエスト本文の例を示します。

{  
 "ProgramType": "DEV"
}

レスポンス本文の例

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

{
  "PartnerProgramId" : 300100071293754,
  "ProgramName" : "North America program",
  "ProgramNumber" : "CDRM_12005",
  "ProgramDescription" : null,
  "StartDateActive" : null,
  "EndDateActive" : null,
  "ProgramManagerId" : 100010038017885,
  "ProgramManagerName" : "Channel_OPS_Mgr_ENT1 COM",
  "ProgramType" : "DEV",
  "StatusCode" : "D",
  "CreatedBy" : "CHANNEL_OPERATIONS_MANAGER",
...
}
「トップに戻る」