記事のサマリー(TL;DR)
CheckoutBrandingFooterContentとCheckoutAndAccountsConfigurationBrandingFooterContentのvisibilityフィールドは、加盟店が設定可能なフッターコンテンツのみを制御するものであることが明確化されました。- このvisibility設定にかかわらず、チェックアウトはShopifyが提供する取引情報をフッターに表示できます。
- 既存アプリはGraphQL Admin APIへのリクエストを変更する必要はありませんが、チェックアウトのブランディングをプレビューまたはテストするアプリは、HIDDENに設定した場合にフッターが空になるという前提を置くべきではありません。
対象と前提条件
この変更は、レガシーのCheckout Branding API、またはCheckout and Accounts Configuration APIを通じてShopify Plusストアのチェックアウトブランディングをカスタマイズしているアプリに影響します。特に、フッターの表示設定を管理しているアプリや、プレビューを描画しているアプリが対象です。チェックアウトのフッター表示設定を管理していないアプリには影響しません。
この仕様の明確化は、該当するブランディング型が存在するすべてのGraphQL Admin APIバージョンに適用されます。新しいAPIバージョンに紐づくものではありません。
詳細
何が変わったか
チェックアウトは、対象となる注文について、Shopifyが提供するコピーをフッターに表示できるようになりました。このコンテンツはチェックアウトの一部であり、フッターコンテンツのvisibility設定によって制御されるものではなく、チェックアウトブランディングを通じて設定できるものでもありません。
visibility設定は、引き続き加盟店ポリシーへのリンクや著作権表記などの、加盟店が設定可能なフッターコンテンツを制御します。この設定をHIDDENにすると、Shopify提供のフッターコンテンツを非表示にすることなく、加盟店設定可能なコンテンツのみが非表示になります。
以下のGraphQL Admin APIフィールドの説明が、この境界を明確にするよう更新されました。
CheckoutBrandingFooterContent.visibilityCheckoutBrandingFooterContentInput.visibilityCheckoutAndAccountsConfigurationBrandingFooterContent.visibilityCheckoutAndAccountsConfigurationBrandingFooterContentInput.visibility
フィールド、入力型、enum値、アクセススコープ、ミューテーションに変更はありません。
影響を受ける対象
すべてのチェックアウトおよびThank Youページで、追加のShopify提供フッターコピーが表示されるようになります。チェックアウトのフッター表示設定を管理していないアプリは影響を受けません。
なぜ重要か
この変更により、加盟店が設定可能なブランディングと、チェックアウトが提供するコンテンツとの境界が明確になります。加盟店ポリシーや著作権コンテンツの管理を引き続き行いながら、チェックアウトはメインのチェックアウトレイアウトを変更することなく、関連する注文情報をフッターに表示できます。
ブランディングのプレビューや自動テストでは、Shopify提供のフッターコンテンツを加盟店設定可能なコンテンツとは別に扱えるようになったため、描画されるチェックアウトフッターをより正確に表現できます。
対応が必要な内容
既存の統合を動作させ続けるために必要な対応はありません。既存のミューテーションや保存済みのブランディング設定は、変更なく動作し続けます。
チェックアウトブランディングを管理またはプレビューしているアプリについては、以下を確認してください。
visibility: HIDDENによってすべてのフッターコンテンツが削除されるという前提を置いていないか確認する。- visibility設定が加盟店設定可能なコンテンツのみを非表示にする場合でも、Shopify提供の取引情報が表示され続けることを許容するよう、プレビューと視覚テストを更新する。
関連ドキュメント
- CheckoutBrandingFooterContentリファレンス
- CheckoutBrandingFooterContentInputリファレンス
- CheckoutAndAccountsConfigurationBrandingFooterContentリファレンス
- CheckoutAndAccountsConfigurationBrandingFooterContentInputリファレンス