

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# よくある質問
<a name="faqs"></a>

 これらの一般的な質問と回答を使用して、カスタム統合を支援します。

**Topics**
+ [一般的なよくある質問](general-faq.md)
+ [技術的なよくある質問 — フィールド](technical-faq-fields.md)
+ [技術的なよくある質問 — Amazon S3](technical-faq-s3.md)
+ [技術的なよくある質問 — リードと機会](technical-faq-leads-and-opps.md)
+ [技術に関するよくある質問 — バージョニングと下位互換性](technical-faq-versioning.md)

# 一般的なよくある質問
<a name="general-faq"></a>

## 統合の仕組み
<a name="how-does-the-integration-work"></a>

 **Q: ファイルの送受信に使用される Amazon Simple Storage Service (Amazon S3) バケットにアクセスできますか？**

はい。パートナーは、バケットにアクセスできる AWS Identity and Access Management (IAM) のシークレット/アクセスキーを使用して Amazon S3 バケットにプログラムでアクセスできます。これらのバケットは Amazon Web Services () の独自のアカウントにあるため、パートナーは Amazon S3 バケットにコンソールでアクセスできません。AWS

 **Q: パートナーの開発者にはどのようなスキルセットが必要ですか？**

パートナーの開発者は、顧客関係管理 (CRM) システムと Amazon S3 に精通している必要があります。

 **Q: サンプルコードファイルには完全なコードが含まれていますか、またはパートナーがコードを記述する必要がありますか？**

パートナーは、提供されたサンプルコードファイルに基づいてコードを記述する必要があります。

 **Q: パートナーが Python、Golang、またはその他の言語でソリューションを開発する場合、 AWS Partner Network (APN) カスタマーエンゲージメント (ACE) は、この統合のためにそれらの言語でソフトウェア開発キット (SDK) を提供しますか？**

いいえ。

 **Q: Amazon S3 バケットから内部 ACE への同期プロセスは何ですか？**

バッチプロセスは 1 時間ごとに実行され、ファイルを取得し、情報を同期します。 AWS セールスチームがレコードに対して行う更新は、パートナーのバケットに送信されるまでに最大 1 時間かかる場合があります。パートナーは更新に関する E メール通知をすぐに受け取ることができますが、 の更新が 1 時間遅れ AWS る場合があります。

 **Q: ACE によるリードファイルとオポチュニティファイルのアップロードの頻度はどのくらいですか？**

ACE はリードとオポチュニティのデータを 1 時間ごとに送信します。

 **Q: ACE 用のサンドボックス環境はありますか？**

はい。ACE にはサンドボックス環境がありますが、セキュリティ上の理由からパートナーにアクセスすることはできません。新しい機会やリードをバケットにプッシュする場合は、Partner Central でサポートケースを作成します。

 **Q: パートナーの CRM と APN 全体で識別子を維持するにはどうすればよいですか？**

パートナーに柔軟性を提供するために、システム内で 2 セットの識別子を使用します。

1.  `apnCrmUniqueIdentifier`：この識別子 AWS を管理します。機会`OXXXXXX`の場合は で始まり、リード`LXXXXXX`の場合は で始まります。

1.  `PartnerCrmUniqueIdentifier`/`partnerCrmLeadId`: パートナーは、CRM 内で、それぞれ機会とリードでこの識別子を管理します。パートナーは、CRM に更新をトレースする新しい機会を取り込みながら、この識別子を追加する必要があります。

 `apnCrmUniqueIdentifier` または なしでオポチュニティが送信されると`partnerCrmUniqueIdentifier`、 はそれを新しいオポチュニティとして AWS 扱い、オポチュニティ`apnCrmUniqueIdentifier`に新しい を割り当てます。

 `apnCrmUniqueIdentifier` または でオポチュニティが送信されると`partnerCrmUniqueIdentifier`、 はそれを更新アクションとして AWS 扱い、ペイロードデータで既存のオポチュニティを更新します。

 **Q: 両方のシステムで重複するレコードが作成されないようにするにはどうすればよいですか？**

パートナー CRM 側から、ACE に送信されるレコードごとに一意の識別子が必要です。これは と呼ばれます`partnerCrmUniqueIdentifier`。同様に、ACE はレコードごとに一意の識別子も保持します。これは と呼ばれます`apnCrmUniqueIdentifier`。データが送信されると、ACE とパートナーの両方にこれらの 2 つのフィールドを含める必要があります。これは、レコードが新しいオポチュニティ (空白の場合) か既存のオポチュニティ (入力されている場合) かを識別するのに役立ちます。

# 技術的なよくある質問 — フィールド
<a name="technical-faq-fields"></a>

 **Q: 統合は CSV 形式をサポートしていますか？**

いいえ。統合は JSON ファイル形式のみを受け入れます。

 **Q: アウトバウンドフォルダからファイルを削除する必要があるのはいつですか？**

ファイルを正常に処理した後にのみ削除します。

 **Q: アウトバウンドフォルダからファイルを誤って削除した場合、元のファイルはどこにありますか？**

ファイルは `opportunity-outbound-archive`および `lead-outbound-archive`フォルダにあります。

 **Q: 開発中のサポートについてはどうすればよいですか？**

開発中のサポートについては、 Partner Central の AWS Partner Network (APN) サポートにお問い合わせください。

 **Q: `opportunityOwnerName`と の違いは何ですか`opportunityOwnerEmail`？**
+ `opportunityOwnerName`: パートナー組織内のオポチュニティ所有者の名前。これは Partner Central ユーザーである必要があります。
+ `opportunityOwnerEmail`: パートナー組織内のオポチュニティ所有者の E メール。これは Partner Central ユーザーである必要があります。指定しない場合、オポチュニティは Partner Central Alliance Lead を所有者として作成されます。

 **Q: すべての日付フィールド (`targetCloseDate`、`lastModifiedDate`、、`createdDate``acceptBy`) のタイムゾーンは何ですか？**

日付フィールドのタイムゾーンはグリニッジ標準時 (GMT) です。

 **Q: インバウンド JSON ファイルはバージョン管理されていますか？**

いいえ。Amazon Web Services (AWS) はファイルのバージョニングをサポートしていません。APN Customer Engagement (ACE) は、受信直後にファイルを処理し、処理が成功するとファイルを削除します。同じファイル名を再度受け取ると、拒否されます。

 **Q: Amazon Simple Storage Service (Amazon S3) JSON ファイル内のどのフィールドが、特定のリードとオポチュニティの作成日と最新の更新日を示していますか？**

`createdDate` および `lastModifiedDate`。

 **Q: オポチュニティが新規か既存かを判断するにはどうすればよいですか？**

フィールド`PartnerCrmUniqueIdentifier`は、パートナーに要求する各オポチュニティの一意の識別子です。この識別子は、パートナーのシステムのソース CRM で定義する必要があります。これを使用して、オポチュニティが存在するかどうかを判断します AWS。存在する場合は、共有情報でオポチュニティを更新します。そうでない場合は、新しいオポチュニティを作成します。

 パートナーにデータを送信するときは、 `PartnerCrmUniqueIdentifier`と の両方が含まれます`apnCrmUniqueIdentifier`。によって共有されたオポチュニティ AWS が初めて送信される場合は、 の値が表示されません`PartnerCrmUniqueIdentifier`。これにより、ACE から機会を新しいものとして扱うことができます。CRM に取り込んだら、 `PartnerCrmUniqueIdentifier`と の両方を使用して更新を返送します`apnCrmUniqueIdentifier`。

 **Q: Amazon S3 に複数のアウトバウンドおよび結果 JSON ファイルを含めることは可能ですか？**

 はい。アウトバウンドフォルダにさらにファイルを生成する場合があります。同様に、ファイルをインバウンドフォルダに送信すると、ファイルは処理され、結果ファイルは結果フォルダに保持されます。処理後に結果ファイルにタグを付けるか、削除する必要があります。

 **Q: アウトバウンドファイルには複数のレコードが含まれていますか？**

はい。アウトバウンドファイルには、複数のレコードを含めることができます。

 **Q: 20 件のインバウンドオポチュニティがオポチュニティセクションの 1 つの入力 JSON ファイルで送信され、オポチュニティの 1 つが APN 標準に準拠していない場合、どうなりますか？**

形式が正しくない場合、その場合でもファイル全体が拒否されます。形式が正しいが、1 つのオポチュニティしか処理できない場合、結果ファイルには、失敗したオポチュニティのエラーメッセージとともに、20 のすべてのオポチュニティとそのステータスが含まれます。

 **Q: JSON ファイルが正常に処理されたかどうかを検証する主要な属性は何ですか？**

これらは、JSON ファイルが正常に処理されたかどうかを理解するのに役立つ主要な属性です。

```
{
  "inboundApiResults": [
    {
      "warnings": null,  // no warnings
      "partnerCrmUniqueIdentifier": "XXXX", //uniqueId from Partner side 
      "isSuccess": true, // file successfully processed
      "errors": null, //no errors reported 
      "apnCrmUniqueIdentifier": "OXXXX" //uniqueId from AWS side
    }
  ]
}
```

 **Q: 無効な JSON を送信するとどうなりますか？**

このエラーレスポンスは`[{input JSON}]`「 は」タイプではありません`object`。

 **Q: 1 つのインバウンド JSON ファイルに含めることができるリード/オポチュニティレコードの数はいくつですか？**

1 つのファイルには最大 50 個のレコードを含めることができます。

# 技術的なよくある質問 — Amazon S3
<a name="technical-faq-s3"></a>

 **Q: Amazon Simple Storage Service (Amazon S3) REST API ドキュメントはどこで入手できますか？**

詳細については、[Amazon S3 REST API の概要](https://docs.aws.amazon.com/AmazonS3/latest/API/Welcome.html)」を参照してください。

 **Q: Amazon S3 バケットにアクセスするために認証するための Amazon Web Services AWS Key Management Service （AWS KMS) キーの詳細を取得するにはどうすればよいですか? Amazon S3 **

AWS Partner Network (APN) は、キー名を含むポリシーを共有します。

 **Q: Salesforce.com (SFDC) から Amazon S3 を認証するにはどうすればよいですか？**

サンプルコードファイル [S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls) を使用して、SFDC から Amazon S3 を認証します。

 **Q: Software Development Kit (SDK) AWS から S3 にファイルをアップロードするにはどうすればよいですか？**

次の AWS CLI コマンドを使用して、ファイルを S3 にアップロードします。

```
aws s3 cp example.json s3://awsexamplebucket/opportunity- inbound/filename.json --acl bucket-owner-full-control
```

 サンプルコードファイル [Sample\$1AceOutboundBatch.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls) には、SFDC からデータファイルをアップロードするコードが含まれています。

 **Q: Amazon S3 バケットを所有しているのは誰ですか？**

AWS は Amazon S3 バケットを所有および管理します。 AWS Identity and Access Management (IAM) ユーザーを使用して、独自の Amazon S3 バケットにプログラムでアクセスできます。

 **Q: ファイルを受信および送信するための個別のフォルダまたはバケットはありますか？**

ファイルを受信および送信するための異なるフォルダを持つバケットが 1 つあります。フォルダの詳細については、 ユーザーガイドを参照してください。

 **Q: を使用して Amazon S3 バケットにアクセスする必要がありますか AWS Lambda、または顧客関係管理 (CRM) システムを使用して直接アクセスできますか？**

どちらの方法でもアクセスできます。

 **Q: Amazon S3 バケットは保護または暗号化されていますか？**

はい。Amazon S3 が提供するデフォルトの暗号化メカニズムを有効にします。

 **Q: Amazon S3 バケットをリッスンする Amazon Simple Notification Service (Amazon SNS) を有効にして、定期的にポーリングするのではなく、イベントに対してのみアクションを実行できますか？**

いいえ。現在、APN カスタマーエンゲージメント (ACE) はこの機能をサポートしていません。

 **Q: どのフォルダにアクセスできますか? 各フォルダの目的は何ですか？**

Amazon S3 フォルダのリストは、 にあります[統合の前提条件](crm-integration-setting-up.md)。

# 技術的なよくある質問 — リードと機会
<a name="technical-faq-leads-and-opps"></a>

## リードと機会の送受信
<a name="send-and-receive-leads-and-opportunities"></a>

 **Q: ファイル命名規則はありますか？**

各ファイル名は一意である必要があります。ファイル名は にすることをお勧めします`PartnerProvided FileName+{timestamp}.json`。

 **Q: 結果の構造は何ですか？**

結果のサンプルファイル (成功とエラー) は、次の場所からダウンロードできます。
+  [リード結果の成功 Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results-Success-Sample.json) 
+  [機会の結果 Success Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results-Success-Sample.json) 
+  [Errors Sample.json を含むリード結果](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-Results_With-Errors-Sample.json) 
+  [Errors Sample.json による機会の結果](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results_With-Errors-Sample.json) 

 **Q: 結果の命名規則は何ですか？**

`PartnerProvidedFileName_result.json` 

 **Q: 同じ名前の 2 番目の JSON ファイルを送信するとどうなりますか？**

ファイルは処理されず、ファイルはアーカイブフォルダに移動されます。

 **Q: インバウンドファイルのサイズ制限はどのくらいですか？**

インバウンドファイルのサイズ制限は 1MB です。

 **Q: 1 つの JSON ファイルにバッチ処理できる機会とリードの最大数はありますか？**

1MB の制限を考慮すると、ファイルごとに 1 つのオポチュニティまたはリードを持つことをお勧めします。

 **Q: アクセス拒否エラーメッセージが表示されるため、ファイルをアップロードできません。どうすればよいですか?**

パートナーは、2 つの理由で*アクセス拒否*メッセージを受け取ります。

1.  ファイルを `outbound`フォルダではなく `inbound`フォルダにアップロードしました。ファイルを `inbound`フォルダにアップロードします。

1.  アクセスコントロールリスト (ACL) を指定する必要があります。データファイルをアップロードするには、次の Amazon Web Services (AWS) CLI コマンドを使用します。

```
aws s3 cp example.json s3://awsexamplebucket --acl bucket-owner-full-control
```

 **Q: `.pdf`、、`.docx`または 以外の拡張子を持つファイルがアップロードされた場合`.json`はどうなりますか？**

ファイルを拒否し、理由の詳細を含む`*.error.json`ファイルを生成します。

 **Q: 本番環境でデータ問題エラーメッセージが表示されたらどうすればよいですか？**

1. パートナーのカスタマーリレーションシップ管理 (CRM) システムでデータを修正する必要がある場合は、データを修正した後、修正したファイルを Amazon Simple Storage Service (Amazon S3) に送信します。

1. データに明確化が必要な場合は、 Partner Development Manager (PDM) にお問い合わせください。

1. その他のテクニカルサポートについては、APN ポータルで AWS Partner Network (APN) サポートケースを提出してください。

 **Q: 結果ファイルはどこにありますか。また、どのくらいの期間利用できますか。**

結果ファイルは `lead-inbound-results`および `opportunity-inbound-results`フォルダにあります。削除されるまで使用できます。プルが成功したら、ファイルを削除できます。

 **Q: 削除した後に結果ファイルを見つける必要がある場合、どこで見つけることができますか？**

結果ファイルは、 `lead-inbound-results-archive/YYYY/MM/DD`および `opportunity-inbound-results-archive/YYYY/MM/DD`フォルダにあります。

 **Q: ファイルの APN 処理に障害が発生した場合、どのように通知されますか？**

APN には、処理エラーを追跡するために Sev2 チケットを自動的に作成するアラームがあります。これらを確認して解決し、パートナーに伝えます。

 **Q: オポチュニティの開始後はどのフィールドを更新できますか？**

以下のフィールドは、独立系ソフトウェアベンダー (ISV) Accelerate パートナーのみが更新できます。
+ `isThisForMarketplace` 
+ `isNetNewBusinessForCompany` 
+ `deliveryModel` 
+ `awsFieldEngagement` 
+ `additionalComments` 

 **Q: *編集できないレコード*エラーが表示されました。これはどういう意味ですか？**

新しいパートナーから紹介されたオポチュニティを送信すると、検証プロセスが実行され、APN カスタマーエンゲージメント (ACE) チームが承認または拒否する必要があります。オポチュニティがレビュー中であり、まだ検証されていない間は、レコードを更新できず、このエラーが表示されます。

 **Q: 自分の側でアクティビティがない場合 (例: ファイルを処理していない、またはインバウンドオポチュニティを送信していない場合) はどうなりますか？**

お客様が情報を送信しない場合、または当社が提供するファイルを処理していない場合、現在、お客様に警告するメカニズムはありません。システムをモニタリングして、情報が APN に流れていることを確認することをお勧めします。

 **Q: JSON の結果は、新規/更新されたインバウンドオポチュニティ/リードの送信後、どのくらい早く結果フォルダで利用できますか？**

処理はほぼリアルタイムです。ファイルは 5 分以内に届きます。

 **Q: APN 標準の形式/長さ制限に準拠していないインバウンドオポチュニティ CRM を送信する場合、システムはそれをどのように処理しますか？ エラーレポートが生成されますか？**

ファイルがフィールド定義形式でない場合、APN の結果ファイルはファイルを呼び出します。

 **Q: 起動時に AWS アカウント ID がありません。どうすればよいですか？**

ACE プロセスでは、 はワークロードが完了し、請求が開始された`Launched`ことを意味します。これには AWS アカウント ID が必要です。詳細については、[「ACE プログラムに関するFAQs](https://partnercentral.awspartner.com/partnercentral2/s/resources?Id=0690h000003xjjXAAQ)」を参照してください。

 **Q: ユーザー受け入れテスト (UAT) の後、本番環境への移行中に履歴データをどのように処理する必要がありますか？**

デフォルトでは、ACE で更新が発生すると、それらの機会が Amazon S3 バケットに送信されます。処理したくない履歴データの場合は、システムで処理したくないものの抽出`X0001, X0002….X000N`で などのダミー値を `partnerCrmUniqueIdentifier` に提供する必要があります。これらの識別子を認識し、それに応じて処理するためのコードを記述する必要があります。残りの機会は正しい`partnerCrmUniqueIdentifier`値を提供します。これにより、システムで処理するものと処理しないものを完全に制御できます。

 **Q: アウトバウンドファイルには複数のレコードが含まれていますか？**

はい。アウトバウンドファイルには、複数のレコードを含めることができます。

 **Q: データが一部のフィールドで *Accept to view* を送信するのはなぜですか？**

 AWS 参照されたオポチュニティまたはリードの場合、オポチュニティまたはリードが受け入れられるまで、すべての PII フィールドは*「Accept to view*」というラベルでマスクされます。承認されると、次の同期サイクルですべてのデータフィールドを受け取ります。

 **Q: 新しい AWS 紹介された機会またはリードが初めて同期された場合はどうすればよいですか？**

新しいオポチュニティまたはリードを初めて同期する場合は、追加のデータ (顧客の連絡先など) を取得するために、そのオポチュニティまたはリードを承認または拒否する必要があります。

## 機会/リーダーの作成と更新
<a name="creating-and-updating-opportunitiesleads"></a>

 **Q: 統合を通じて ACE に新しい*パートナー紹介 (発信）* の機会を取り込むにはどうすればよいですか？**

統合を通じて ACE で新しいオポチュニティを作成するには、定義された JSON 形式の必要なオポチュニティ情報を `opportunity-inbound`フォルダに取り込む必要があります。 はこの情報 AWS を処理し、ACE で新しいオポチュニティを作成し、 `opportunity-inbound-processed-results`フォルダで成功/失敗した作成オペレーションの結果を共有します。

 **Q: 統合では、新しいオポチュニティの送信と更新はどのように区別されますか？**

各オポチュニティ`PartnerCrmUniqueIdentifier`の フィールドは、必須の一意の識別子です。この識別子は、システムソース CRM で定義する必要があります。 AWS はこれを使用して、ACE にオポチュニティがすでに存在するかどうかを判断します。ACE で利用可能な場合は、共有された情報を使用してオポチュニティを更新しますが、ACE で利用できない場合は、共有された情報を使用して新しいオポチュニティを作成します。

 **Q: 統合を通じて更新機能をすでに実装している場合は、統合を使用して新しい機会を送信 (作成) するために何をする必要がありますか？**

既存の統合に次の変更を加える必要があります。

1.  `opportunity-inbound` フォルダに新しい作成機会の取り込みを開始します。同じフォルダに更新を提供します。

1.  作成に必要な必須フィールドが、共有されたオポチュニティ JSON で使用可能であることを確認します。

1.  新しいオポチュニティごとに、ACE/Partner Central に存在しない一意の `PartnerCrmUniqueIdentifier` があることを確認します。重要な運用開始のベストプラクティスは、更新を受信したときに重複を作成しないように、ACE の既存のデータを CRM `PartnerCrmUniqueIdentifier`の各 にマッピングして更新することです。サポートが必要な場合は、ACE にお問い合わせください。

 **Q: 本番稼働プロセスの一環として、ACE の既存のオポチュニティを で更新するにはどうすればよいですか`PartnerCrmUniqueIdentifier`？** 

 ACE チームは、本番稼働開始の準備に役立つすべてのオープンオポチュニティのリストを提供します。ACE のこれらの既存のオポチュニティをそれぞれの にマッピングし`PartnerCrmUniqueIdentifier`、更新されたファイルを ACE に返して AWS CRM に統合する必要があります。

 提供される機会 AWS のサブセットのみを同期することを選択した場合は、処理したくない機会 AWS の更新をバイパスするロジックを開発する必要があります。このアプローチは、オンボーディング後の将来の機会にも適用する必要があります。両方の CRMs 間で調整が必要な機会`partnerCrmUniqueIdentifier`には、関連付けられた を指定する必要があります。さらに、更新しない機会 (例: クローズドロストオポチュニティまたはクローズドウォンオポチュニティのマーク) を指定して、更新から除外する必要があります。が AWS 共有し、受け入れるすべてのオープン/アクティブオポチュニティに が割り当てられることが重要です`partnerCrmUniqueIdentifier`。

 **Q: オポチュニティまたはリードの特定のフィールドのみを更新できますか？**

はい。更新が必要なフィールドと必要な識別子のみを指定できます。

 **Q: *ApnCrmUniqueIdentifier* を変更することは可能です**か？

いいえ。この識別子は に対して一定であり AWS 、各オポチュニティを一意に識別します。

 **Q: *partnerCrmUniqueIdentifier* が正しくない場合はどうなりますか**？

間違った識別子を指定すると、新しいオポチュニティが作成されます。データの重複を避けるために精度を確保します。

 **Q: が AWS 送信した機会を更新できますか？**

はい。送信されたオポチュニティ AWS は、正しい を使用して更新できます`partnerCrmUniqueIdentifier`。

 **Q: 送信された機会の結果はどのくらいで期待できますか？**

処理はほぼリアルタイムで、結果は通常数分以内に `opportunity-inbound-processed-results`フォルダで確認できます。

 **Q: 送信されたオポチュニティの処理エラーがある場合はどうすればよいですか？**

結果ファイルでエラーの詳細を確認し、問題に対処し、ACE サポートチームからさらに支援を求めます。

 **Q: 統合を通じてオポチュニティを削除できますか？**

いいえ。直接削除はサポートされていません。オポチュニティを更新して、*クローズ*ステータスを反映することができます。

 **Q: *レコードの編集不可*エラーとはどういう意味ですか？**

このエラーは、ACE レビューでオポチュニティを更新しようとすると発生します。これらの機会は、検証されるまで編集できません。

 **Q: 更新や新しい機会を送信しない場合はどうなりますか？**

統合を通じて更新や新しいオポチュニティを送信しない場合、新しいデータは受信および処理されません。

 **Q: 結果ファイルはどのくらいの期間使用できますか？**

結果ファイルは妥当な期間使用できます。それらをすぐに取得して管理する必要があります。

# 技術に関するよくある質問 — バージョニングと下位互換性
<a name="technical-faq-versioning"></a>

 **Q: アマゾン ウェブ サービス (AWS) データ交換のペイロードとは？**

ペイロードは、JSON でフォーマットされた構造化されたデータであり、 へのインバウンド AWS または からのアウトバウンドに送信されます AWS。この JSON 構造の各キーは*フィールド*と呼ばれ、各フィールドには関連する*値があります。*

 **Q: ペイロードのバージョンはどのように決定されますか？**

ペイロードバージョンは、ペイロード自体の `version`フィールド内で指定されます。フィールド定義 v13 に準拠するペイロードはペイロードバージョン 1.0 と見なされ、フィールド定義 v14 以降で定義された形式に従うペイロードはペイロードバージョン 2.0 と呼ばれます。

 **Q: このコンテキストでの下位互換性とはどういう意味ですか？また、どのように処理されますか？**

下位互換性により、新しいペイロードバージョンで新しいフィールドと必須フィールドが導入されても、既存の機会が失敗することがなくなります。 は、新しいバージョンで必要なフィールドにデフォルト値を自動的に割り当てることで、これ AWS を維持します。（ AWS Partner Network APN) カスタマーエンゲージメント (ACE) UI で、カスタマーリレーションシップ管理 (CRM) 統合を通じて明示的に指定していない値が表示される場合があります。各フィールドの詳細と条件は、フィールドの説明またはフィールドに関する追加の詳細で説明されています。

 **Q: 下位互換性は永続的な機能ですか？**

いいえ。下位互換性は期限付きであり、今後の変更を計画して実装するための柔軟性を提供するように設計されています。指定されたカットオフ日を超えて動作しなくなります。これは、より広範なローンチの一環として、年後半に発表される予定です。

 **Q: バージョン 2.0 でペイロードの送信を開始するとどうなりますか？**

バージョン 2.0 でペイロードを送信すると、システムは必要なすべての変更が実装されていることを前提としており、新しいペイロードバージョンの検証はそれ以降のすべての変更に適用されます。バージョン 1.0 とバージョン 2.0 のペイロードの間に機能は部分的に実装しないことが重要です。

 **Q: バージョン 2.0 に更新した後、ペイロードバージョン 1.0 に戻すことはできますか？**

いいえ。ペイロードバージョン 2.0 への移行は一方向のプロセスです。バージョン 2.0 に更新すると、ペイロードのバージョン 1.0 に戻すことはできません。