說明
登入

取得頁面資料

在需要頁面資料的工作流程中，您可以使用 Get page data (取得頁面資料) 動作來從商店擷取頁面資訊。頁面是網路商店上的網頁，包含極少變更的資訊，例如「關於我們」頁面或「聯絡我們」頁面。

本頁面包含

設定

欄位

Get page data (取得頁面資料) 動作包含下列欄位：

用於取得資料動作的欄位。
欄位說明
排序資料依據必填。做為搜尋查詢傳回資料排序依據的參數。
結果數目上限必填。您選取的搜尋查詢可傳回的結果數目上限。一次最多可傳回 100 個結果。
查詢必填。請從常用查詢中選擇，或選取「進階」來建立您自己的查詢。

查詢字串

以下是取得已發布頁面的查詢範例：

published_status:published

published_status 變數是頁面查詢中提供的篩選條件，可重複使用或結合其他變數使用。

查詢資料時，以下幾點資訊很有幫助：

  • 可用的頁面篩選條件清單

  • 查詢必須遵循特定的語法

  • 查詢欄位的值不一定會記錄在說明文件中。在某些情況下，可以透過查看 API 文件找到這些值。或者，您在管理介面中進行篩選時，通常可以在網址中找到欄位值。例如，若要尋找某些「訂單」查詢值，請在管理介面中篩選「訂單」頁面，然後查看網址。

  • 您可以使用 Shopify GraphiQL app，在您的商店中執行或測試查詢。

  • 請留意查詢失敗時會發生什麼情況。API 通常會傳回所有結果 (而非沒有結果)。

傳回的資料

所有 Get data 動作都會傳回 0 到 100 個資源的清單。視您的使用案例而定，您可能會希望以各種方式使用這些資料：

  • 如果您需要個別處理每個清單項目，例如為每個項目新增標籤，則可以使用 For each 動作。
  • 如果您需要整合資料，例如計算傳回多少個結果，則可以使用 Count 或 Sum 動作。
  • 若您需要輸出清單 (例如以電子郵件寄送所有品項)，則可以直接在後續動作中使用傳回的資料。

若要在這個動作之後的步驟中存取傳回的資料，請使用名為 Get page data 的變數，這是一份頁面清單。您可以在條件和動作中使用這個變數。例如，您可以在類似如下的 Send internal email 動作中傳送頁面清單：

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}

觸發條件

您可以在任何工作流程中使用此動作，包括 Scheduled time 觸發條件。在使用 Scheduled time 觸發條件的工作流程中，工作流程會依據您指定的時間啟動，而非因為事件發生而啟動。由於商店中或 app 內並沒有啟動該工作流程的特定事件，因此系統不會自動包含任何資料。

API 參考資料

深入瞭解此動作使用的 API，請參閱頁面查詢。