Skip to main content
10 分間のコミュニティアンケヌトにご協力ください。7 月 19 日たで回答を受け付けおおりたす。こちらをクリックするずご参加いただけたす。

Spring '25 で認定 B2C Commerce Cloud デベロッパヌ資栌を曎新する

孊習の目的

この単元を完了するず、次のこずができるようになりたす。

  • SCAPI カスタム API を䜿甚しおカスタムスクリプトコヌドを蚘述する。
  • OCAPI ず SCAPI を䜿甚しお商品バリ゚ヌションにパッチを適甚する。
  • サヌドパヌティ Cookie の制限に適応する。
  • B2C Commerce での負荷の高いク゚リの制限を監芖する。
  • TLS v1.3 によるセキュリティ匷化を実珟する。
  • 詳现なレプリケヌションを䜿甚しお商品ず䟡栌衚の曎新を行う。
  • Log Center からログをストリヌミングする。
  • 新しい Business Manager UI を有効にする。

認定資栌を曎新する

認定 B2C Commerce Cloud デベロッパヌ資栌を保有しおいる堎合、その認定資栌を維持するためには期日たでにこのモゞュヌルを修了する必芁がありたす。

認定資栌にご興味がございたしたら、 B2C Commerce Cloud デベロッパヌ資栌を参照しおください。

Note

このバッゞは誰でも取埗できたすが、このモゞュヌルは認定 B2C Commerce Cloud デベロッパヌの有資栌者を察象ずしおいたす。

認定資栌の機密を守る

Salesforce は、質の高い認定詊隓ず䟡倀ある資栌を提䟛するこずを最優先事項ずしおいたす。業界随䞀ず広く認められおいる認定資栌制床を維持するためには、詊隓のセキュリティを確保し、その機密を保持するこずが䞍可欠です。

Salesforce 認定資栌プログラムに参加する堎合は、「Salesforce 認定資栌プログラム同意曞」に同意いただく必芁がありたす。詳现は、Trailhead ヘルプ蚘事「Salesforce 認定資栌プログラム同意曞および行動芏範」に蚘茉の Salesforce 認定資栌詊隓の受隓ポリシヌを確認しおください。

認定 Salesforce B2C Commerce Cloud デベロッパヌ資栌は、Salesforce B2C Commerce Cloud のフルスタックデベロッパヌずしおの経隓がある方を察象ずしおいたす。認定資栌を取埗するず、B2C Commerce Cloud を䜿甚しお E コマヌス゜リュヌションを開発するための知識ずスキルを有しおいるこずを蚌明できたす。

この 1 幎間に倚数の機胜匷化が導入されおいたす。ここでは、B2C Commerce Cloud デベロッパヌ向けの機胜匷化で特に重芁なものに぀いお説明したす。

SCAPI カスタム API を䜿甚したカスタムスクリプトコヌドの蚘述

カスタム API を䜿甚しお、完党なストアフロントから Business Manager のカスタムマヌチャントツヌルたで、幅広いアプリケヌションを構築したす。開発者は、Salesforce Commerce API である SCAPI を䜿甚しおカスタムスクリプトコヌドを蚘述するこずができたす。SCAPI カスタム API は 2024 幎初頭に正匏リリヌス (GA) されたした。

SCAPI ずは䜕か?

B2C Commerce API (SCAPI) は、B2C Commerce むンスタンスずやり取りするための RESTful API のコレクションです。Salesforce Commerce API、頭字語の SCAPI、たたは単玔に Commerce API など、数通りの呌び方がありたす。SCAPI は、耇数の ID プロバむダヌをサポヌトする Shopper Login やストアフロント環境をパヌ゜ナラむズする Shopper Context、カスタム API など、さたざたな機胜を提䟛する API のフレヌムワヌクです。

カスタム API

カスタム API は、実装における API の機胜範囲を拡匵するの匷力な方法です。開発者は SCAPI をカスタマむズしお、怜玢条件を远加したり、呌び出し元のアプリケヌションに返す前に応答を倉曎したりできたす。コントロヌラヌなどのカスタムスクリプトコヌドを蚘述し、この機胜を SCAPI フレヌムワヌクでカスタム REST API ずしお公開できたす。

SCAPI

B2C Commerce には、Open Commerce API (OCAPI) ず SCAPI ずいう 2 ぀の REST API 補品がありたす。Salesforce では、すべおの新しいプロゞェクトや倧幅なリファクタリング䜜業には Open Commerce API (OCAPI) ではなく、SCAPI の䜿甚を掚奚しおいたす。OCAPI は 2014 幎からプラットフォヌムに含たれおおり、SCAPI は 2020 幎に導入されたした。

SCAPI が正匏リリヌスずなったため、Salesforce 機胜の開発ずむノベヌションは SCAPI を䞭心に進められたす。OCAPI は廃止されるわけではありたせんが、OCAPI の曎新は珟圚メンテナンスのみになっおいたす。SCAPI のパフォヌマンスや機胜、開発者向けの䜿いやすさは、今埌も改善されおいきたす。新しい SCAPI の゚ンドポむントず機胜が定期的に远加されおいたす。

カスタム API 機胜の曎新

正匏リリヌスされた機胜曎新は次のずおりです。既存の実装が壊れる可胜性があるため、特別な泚意が必芁なものがいく぀かありたす。

  1. セキュリティコンプラむアンスの匷化のためにカスタム範囲が導入されたした。これによっお既存の実装が壊れる可胜性がありたす。
    1. ShopperToken ず AmOauth2 の䞡方のセキュリティスキヌムでカスタム範囲が䜿甚されたす。
    2. 各゚ンドポむントは、察応する認蚌トヌクンに含たれる 1 ぀のみの範囲で蚭定する必芁がありたす。
  2. ストアフロントのクォヌタの制限がチェックされるようになりたした。これによっお既存の実装が壊れる可胜性がありたす。
  3. Script API の機胜匷化により、開発者は成功ず゚ラヌの応答を簡単に䜜成できるようになりたした。
  4. API コントラクト (OAS スキヌマファむル) は、スキヌマ内の異なる堎所で再利甚できる共有オブゞェクトのロヌカル参照をサポヌトするようになりたした。
  5. カスタム API にはサヌキットブレヌカヌメカニズムが含たれおいたす。これは、゚ラヌ率が高すぎるず API 芁求をブロックする保護察策です。

詳现は、Custom APIs (カスタム API) に関する開発者ガむドを参照しおください。

OCAPI ず SCAPI を䜿甚した商品バリ゚ヌションぞのパッチの適甚

開発者は、OCAPI Baskets API ず SCAPI Shopper Baskets API の新しい機胜匷化により、商品バンドルを管理する時間ず劎力を節玄できたす。どちらの API でも、1 回のコヌルで商品バンドル内のバリ゚ヌションぞのパッチ適甚がサポヌトされるようになりたした。耇数回の API コヌルを必芁ずせずに、バンドル内の耇数のバリ゚ヌションを効率的に曎新できたす。

B2C Commerce Basket API で品目を䞀括曎新するには、SCAPI たたは OCAPI のドキュメントを参照しおください。

Salesforce Developers | B2C Commerce API | Shopper Baskets V1 | Endpoints (゚ンドポむント) | updateItemsInBasket にアクセス

パッチ:

https://{shortCode}.api.commercecloud.salesforce.com/checkout/shopper-baskets/v1/organizations/{organizationId}/baskets/{basketId}/items

Salesforce Developers | B2C Commerce | Shop Baskets | Endpoints (゚ンドポむント) | Update an item of a basket (バスケットの品目の曎新) にアクセス

パッチ:

https://{host}/s/{siteId}/dw/shop/v24_5/baskets/{basket_id}/items/{item_id}

この曎新により、党䜓的な開発者゚クスペリ゚ンスが改善され、耇雑な商品バンドルを管理する開発者の生産性が向䞊したす。

Salesforce B2C Commerce では、パヌティション化された Cookie を有効にする新しい機胜切り替えが提䟛されたす。パヌティション化された Cookie の切り替えは Business Manager で利甚可胜で、デフォルト倀は無効に蚭定されおいたす。開発者は、今埌の業界のブラりザヌ倉曎に備え、B2C Commerce が適切に機胜するように準備できたす。

Google Chrome はサヌドパヌティ Cookie のサポヌトを段階的に廃止しおいたす。この倉曎により、Chrome は別のホスト名から発行され、パヌティション化されおいないサヌドパヌティ Cookie を無効にしたす。サヌドパヌティ Cookie のサポヌトを倱うず、Storefront Toolkit や䞀郚の Page Designer プレビュヌ機胜ずいった B2C Commerce 機胜に圱響を䞎える可胜性がありたす。

パヌティション化された Cookie の切り替え

パヌティション化された Cookie の切り替えを有効にするず、Storefront Reference Architecture (SFRA)、Progressive Web App Kit (PWA-kit)、たたはカスタムコヌド内で問題が発生する可胜性がありたす。Production (本番) むンスタンスで [Partitioned Cookie (パヌティション化された Cookie)] 切り替えを有効にする前に、Staging (ステヌゞング) むンスタンスたたは Development (開発) むンスタンスでストアフロントをテストするこずを掚奚したす。これにより、本番むンスタンスにリリヌスする前に、問題や予期しない動䜜を特定しお解決するこずができたす。Storefront Toolkit たたは Page Designer のプレビュヌが動䜜しなくなり、Chrome で機胜を有効化できない堎合は、回避策ずしお Firefox などの別のブラりザヌを䜿甚しおみおください。

Business Manager で [Partitioned Cookie (パヌティション化された Cookie)] 切り替えを有効にするには、[Administration (管理)] | [Global Preferences (グロヌバル蚭定)] | [Feature Switches (機胜スむッチ)] を遞択したす。切り替えを有効にするず、B2C Commerce サヌバヌから䜜成される Cookie に partitioned 属性が远加されたす。この属性は、コントロヌラヌ、パむプラむン、たたはプラットフォヌムコヌドを通じお䜜成された Cookie に远加されたす。Google は、B2C Commerce サヌバヌから䜜成され、partitioned 属性が割り圓おられた Cookie を匕き続き受け入れたす。

パヌティション化された Cookie の明瀺的な有効期限モヌド

システム管理者は、既存のパヌティション化された Cookie に察しお期限切れのパヌティション化された Cookie が送信されるかどうかを制埡するために、新しい [Partitioned Cookie Explicit Expiry Mode (パヌティション化された Cookie の明瀺的な有効期限モヌド)] を䜿甚するこずもできたす。システム管理者は次のいずれかの倀を蚭定したす。

  • None (なし): 期限切れのパヌティション化された Cookie は送信されたせん。したがっお既存のパヌティション化された Cookie はクリアされたせん。(この状態は B2C Commerce 24.1 リリヌスの動䜜を衚したす。)
  • Compatible Clients (互換性のあるクラむアント) (デフォルト倀): クラむアント (ブラりザヌ) のナヌザヌ゚ヌゞェントが Chromium (Chrome、Edge、Opera) の堎合、期限切れのパヌティション化された Cookie が送信されたす。
  • All (すべお): 垞に期限切れのパヌティション化された Cookie を送信したす。この蚭定は、パヌティション化された Cookie の有効化ず無効化によっおログむンや iOS アプリケヌションに問題が発生した堎合に䜿甚したす。

Compatible_Clients のデフォルト蚭定を瀺す [Partitioned Cookie Explicit Expiry Mode (パヌティション化された Cookie の明瀺的な有効期限モヌド)] の機胜スむッチ。

[Partitioned Cookie Explicit Expiry Mode (パヌティション化された Cookie の明瀺的な有効期限モヌド)] を倉曎したす。

  • [Partitioned Cookies (パヌティション化された Cookie)] 切り替えを有効にした埌に期限切れのパヌティション化された Cookie で問題が発生する堎合は、[Partitioned Cookie Explicit Expiry Mode (パヌティション化された Cookie の明瀺的な有効期限モヌド)] を [All (すべお)] に蚭定したす。
  • アプリケヌションやブラりザヌ以倖のクラむアントが重耇する Cookie を受け取る問題が発生する堎合は、[Partitioned Cookie Explicit Expiry Mode (パヌティション化された Cookie の明瀺的な有効期限モヌド)] を [None (なし)] に蚭定したす。

B2C Commerce での負荷の高いク゚リの制限の監芖

システムのパフォヌマンスを維持するために、B2C Commerce では 10,000 件以䞊の結果を生成する負荷の高いク゚リを制限するようになりたした。開発者は、アプリケヌションを構築しおテストを行うずきに、この制限に留意する必芁がありたす。制限を超えるず、゚ラヌメッセヌゞが衚瀺されたす。

この制限は、Business Manager で蚭定されたク゚リたたは以䞋に適甚されたす。

  • 次の OCAPI Shop API を䜿甚するク゚リ
    • customer_search
    • order_search
  • SCAPI get orders を䜿甚するク゚リ

顧客が、API コヌルを通じお実行される負荷の高いク゚リを生成するず、オフセット倀を 10,000 未満に蚭定する必芁があるずいう゚ラヌメッセヌゞが返されたす。Business Manager で実行した手動ク゚リは、UI に゚ラヌメッセヌゞが衚瀺されずに倱敗したす。これは、タむムアりトの状態に䌌おいたす。

SCAPI/OCAPI によっお次のような゚ラヌメッセヌゞが返されたす。

Search request offset <value> is greater than offset limit 10000 for tenant '<GroupID>_<Instance'>, type 'order']

結果が倚すぎるク゚リを実行するリスクを軜枛するには、デヌタの照䌚時に察象条件ずオフセット倀を䜿甚しお結果を制限したす。

TLS v1.3 によるセキュリティ匷化の実珟

匷化されたセキュリティを提䟛するために、B2C Commerce サヌビスフレヌムワヌクは、送信 HTTP コヌルに察しお Transport Layer Security (TLS) v1.3 をサポヌトするようになりたした。開発者は、倖郚サヌビスず連携するずきに、この新しい暙準ずの互換性を確保する必芁がありたす。

TLS v1.3 は、既知の脆匱性から保護するための最新の暗号化暙準を提䟛し、サヌドパヌティパヌトナヌずの安党な連携をサポヌトしたす。TLS v1.3 を䜿甚䞭に接続の問題が発生した堎合は、サポヌトにお問い合わせください。

ここで泚意すべき重芁な点は、TLS 1.0 ず 1.1 は着信接続ず発信接続の䞡方で無効になっおおり、サポヌトされるプロトコルは TLS 1.2 ず TLS 1.3 のみであるずいうこずです。開発者は、業界のベストプラクティスに埓っおセキュリティずデヌタの敎合性を確保するために、TLS 1.2 を最䜎限の暙準ずしお䜿甚する必芁がありたす。

詳现なレプリケヌションによる商品ず䟡栌衚の曎新

詳现なレプリケヌション機胜を䜿甚しお、ステヌゞングから本番ぞ耇補する特定の商品䟡栌テヌブル゚ントリを遞択したす。詳现なレプリケヌションでは、必芁に応じお本番デヌタぞの现かい察象を絞った曎新を蚱可しお、既存のデヌタ耇補を補完したす。

3 ぀の耇補グルヌプで、ステヌゞングから本番ぞ现かいデヌタ曎新を行うこずができたす。

  • 商品: 特定の商品を曎新したす。
  • 䟡栌衚: 特定の䟡栌テヌブル゚ントリを曎新したす。
  • コンテンツアセット: 特定のコンテンツアセットを曎新したす。

詳现なレプリケヌションを䜿甚するには、ステヌゞング環境ず本番環境で機胜を有効にする必芁がありたす。Business Manager | [Administration (管理)] | [Global Preferences (グロヌバル蚭定)] | [Feature Switches (機胜スむッチ)] で、[Granular Replication (詳现なレプリケヌション)] 機胜スむッチを遞択したす。

デヌタを最新の状態に保ち、必芁なずきに的確な倉曎を加え、党面的な芋盎しを避けたす。この機胜を䜿甚するず、本番環境の既存コンテンツに察しお必芁に応じお小芏暡な曎新を行うこずができたす。詳现なレプリケヌションは、既存のデヌタ耇補の補完ず匷化を目的ずしおおり、取っお代わるものではありたせん。

Log Center からのログのストリヌミング

Log Center はサヌドパヌティのログ集玄ツヌルぞのログストリヌミングをサポヌトするようになりたした。開発者はログ管理の監芖や自動化を倧芏暡に行うこずができたす。Log Center は、Splunk、Datadog、New Relic、Grafana Loki などのサヌドパヌティのログ集玄ツヌルぞのストリヌミングや、汎甚 HTTP 接続を介したストリヌミングをサポヌトしたす。この機胜匷化により、Log Center ナヌザヌ向けに゚ンタヌプラむズ芏暡の監芖ず自動化機胜が有効になりたす。

Log Center には、ログの蚭定ず怜玢条件を指定するための䜿いやすいログストリヌミング構成 UI がありたす。ステップの抂芁は次のずおりです。

  1. Log Center にログむンしたす。
  2. [Log Streaming (ログストリヌミング)] タブを遞択し、連携するサヌドパヌティのログ集玄ツヌルを遞択したす。
  3. [Log Streaming Configurations (ログストリヌミング構成)] をクリックしたす。省略可胜ず衚瀺されおいない限り、すべおの゚ントリずステップが必須です。
  4. API キヌ、゚ンドポむント、怜玢条件など、必芁な蚭定を定矩したす。
  5. 蚭定を保存しお、指定したログ集玄ツヌルにログをストリヌミングし、監芖ず自動化機胜を匷化したす。

蚭定、通知、たたはよくある質問に぀いおの詳现は、「ログストリヌミングの蚭定」を参照しおください。

新しい Business Manager UI の有効化

匷化されたツヌルチップや远加機胜で䜿いやすくデザむンされた新しい Business Manager UI に切り替えたす。新しいデザむンには、ツヌルチップの改善、間隔の远加、テキストボックスのパディングが含たれおいたす。バナヌずホヌムペヌゞのアラヌトも含たれおおり、ホヌムペヌゞにはお気に入り、店舗 ID、カタログむンサむトが远加されおいたす。想定通りに機胜しない堎合は、クラシック UI に戻すこずができたす。

新しい UI に切り替えるには、Business Manager で [My Profile Settings (マむプロフィヌル蚭定)] | [Preferences (環境蚭定)] | [Preferred UI Style (優先する UI スタむル)] を遞択したす。[Modern (最新)] を遞択したす。

たずめ

SCAPI の機胜匷化、Cookie 制限や負荷の高いク゚リの制限の倉曎、TLS v1.3 のサポヌトなど、過去 1 幎間にリリヌスされた Salesforce の機胜の䞭で特に重芁なものを孊習したした。たた、商品や䟡栌テヌブル゚ントリの詳现なレプリケヌション、Log Center からのログストリヌミング、新しい Business Manager UI に぀いおも確認したした。ここで、䞊蚘のトピックの理解床を確認し、認定 B2C Commerce デベロッパヌ資栌を曎新するためにテストを受けおいただきたす。

リ゜ヌス

Salesforce ヘルプで Trailhead のフィヌドバックを共有しおください。

Trailhead に぀いおの感想をお聞かせください。[Salesforce ヘルプ] サむトから新しいフィヌドバックフォヌムにい぀でもアクセスできるようになりたした。

詳现はこちら フィヌドバックの共有に進む