批次擷取

您的資料動態饋給 只要透過「端對端訂購」功能提供餐廳、服務和菜單即可。

本文說明如何代管沙箱和實際執行環境，以及使用批次擷取功能 。

資料動態饋給環境

有三種資料動態饋給環境可用於整合開發：

代管資料動態饋給

為運用端對端排序功能，以批次方式處理沙箱和正式環境資料動態饋給 擷取作業中，您必須使用 。

建議您為沙箱和實際執行環境代管資料動態饋給 。這個方法可讓您在沙箱動態饋給環境中進行開發和測試 再將變更部署至正式環境

舉例來說，如果使用 Google Cloud Storage 做為託管選項，則結果如下： 路徑：

• 沙箱動態饋給： gs://foorestaurant-google-feed-sandbox/
• 正式版動態消息： gs://foorestaurant-google-feed-prod/

如要代管廣告空間，請執行下列操作：

1. 產生資料動態饋給檔案。
2. 選擇託管解決方案。
3. 代管資料動態饋給。
4. 確保您的資料動態饋給檔案定期更新。必須更新正式版資料動態饋給 每日執行。

如要進一步瞭解如何建立商品目錄動態饋給，請參閱 Restaurant、 Service, 和Menu 實體及 建立資料動態饋給 專區。

資料動態饋給檔案規範

每個檔案 (可能包含多個實體) 不得超過 200 MB。頂層 Restaurant、Service 和 Menu 等實體，以及 子實體，全部不得超過 4 MB。

選擇託管解決方案

下表列出代管資料動態饋給的選項，以及主機如何與這些主機搭配運作 端對端排序：

連結資料動態饋給以進行批次擷取

代管動態饋給後，請在 Actions Center 中將動態饋給連結至專案。 如要進行正式版動態饋給的初始設定，請前往新手上路工作頁面。之後 任何入口網站使用者只要擁有> 管理員角色沙箱環境是用於開發和測試用途， 系統會向使用者顯示正式版動態饋給。

如果你使用 Amazon S3 代管資料動態饋給

1. 在動作中心中，依序前往「設定」> 動態饋給：

2. 按一下 [編輯]，然後填寫「更新動態饋給」表單：

   • 動態饋給提交方式：設為 Amazon S3。
   • 標記檔案：提供 marker.txt 檔案的網址。
   • 資料檔案：提供資料動態饋給所在 S3 值區的網址。
   • 存取權 ID：輸入具備從 S3 讀取權限的 IAM 存取金鑰 ID 再複習一下，機構節點 是所有 Google Cloud Platform 資源的根節點
   • 存取金鑰：輸入具備可從 S3 讀取權限的 IAM 私密存取金鑰 再複習一下，機構節點 是所有 Google Cloud Platform 資源的根節點
3. 按一下 [提交]。
4. 經過一到兩小時後，請確認批次擷取功能是否會擷取動態饋給檔案。

如果您是透過 Google Cloud Storage 託管資料動態饋給

1. 在動作中心中，依序前往「設定」> 動態饋給：

2. 按一下 [編輯]，然後填寫「更新動態饋給」表單：

   • 動態饋給提交方式：設為「Google Cloud Storage」。
   • 標記檔案：提供 marker.txt 檔案的網址。
   • 資料檔案：提供資料動態饋給所屬 GCS 值區的網址。
3. 按一下 [提交]。
4. 系統會建立服務帳戶來存取 GCS 值區。帳戶名稱會顯示在 完成加入工作後的設定 > 動態饋給 。這個服務帳戶需要「Storage 舊版物件讀取者」角色。這個角色可以 在 Google Cloud 控制台的「IAM」頁面中授予服務帳戶。
5. 經過一到兩小時後，請確認批次擷取功能是否會擷取動態饋給檔案。

如果你使用 HTTPS 代管資料動態饋給

1. 在動作中心中，依序前往「設定」> 動態饋給：

2. 按一下 [編輯]，然後填寫「更新動態饋給」表單：

   • 動態饋給放送方式：設為「HTTPS」。
   • Sitemap 檔案：提供 sitemap.xml 檔案的網址。
   • 使用者名稱：輸入使用者名稱憑證來存取 HTTPS 伺服器。
   • 密碼：輸入用於存取 HTTPS 伺服器的密碼。
3. 按一下 [提交]。
4. 經過一到兩小時後，請確認批次擷取功能是否會擷取動態饋給檔案。

路徑範例

下表列出各個代管選項的範例路徑：

HTTPS 代管服務的 Sitemap

定義 Sitemap 時，請遵循下列準則：

• Sitemap 中的連結必須指向檔案本身。
• 如果您的 Sitemap 提及雲端服務供應商而非自己的網域名稱， 請確定網址開頭，例如 https://www.yourcloudprovider.com/your_id。 是對批次工作的穩定值
• 請注意，請勿上傳部分 Sitemap (例如上傳部分資料時)。執行 因此，Google 只會擷取 Sitemap 中的檔案，導致商品目錄 等級下滑，並有可能導致動態饋給擷取功能遭到封鎖。
• 確認 Sitemap 中參照的檔案路徑並未變更。舉例來說 是否有 Sitemap 參照 https://www.yourcloudprovider.com/your_id/10000.json 今天，但參照 https://www.yourcloudprovider.com/your_id/20000.json 重新開始。

範例 Sitemap

以下是提供資料動態饋給檔案的 sitemap.xml 範例檔案：

示例 1：按照商家分類的實體 (建議使用)。

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_1.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_2.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_3.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
</urlset>

範例 2：按照類型分組的實體。

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
 <url>
   <loc>https://your_fulfillment_url.com/restaurant.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/menu.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/service.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
</urlset>

更新資料動態饋給

資料動態饋給成功連線後，Google 每小時會檢查一次更新，不過我們只會擷取 marker.txt 或 sitemap.xml 檔案傳送時，所有的資料動態饋給 已修改。資料動態饋給應每天更新一次，以免商品目錄資料過時。

如要指明資料動態饋給已修改且準備就緒，可以進行批次擷取，請更新資料的 marker.txt 檔案的 last-modified 物件中繼資料欄位 (用於 GCP， S3) 或 sitemap.xml 檔案的 last-modified 回應標頭。Google 敬上 系統會使用這些值來判斷資料動態饋給的更新程度。

系統擷取批次動態饋給時

• 目前訂購端對端庫存中沒有的新實體，且沒有任何新實體 發生錯誤
• 已經出現在商品目錄中的實體，且沒有任何錯誤 且 dateModified 比 若是目前的項目，如果沒有 dateModified，則 動態饋給擷取開始時間晚於目前輸入的時間 如果未更新，系統會將它們標示為過時。
• 先前動態饋給中的實體，但已不再包含 在沒有檔案的情況下，系統會刪除目前正在處理的批次資訊提供 動態饋給層級錯誤

時間戳記或 last-modified 回應標頭只能在所有資料完成後更新 系統隨即會產生並更新動態饋給檔案限制更新資料動態饋給的批次工作只在執行時執行 每天一次或者，每個批次工作之間有至少 3 小時的間隔。如果您不 採取這些步驟，Google 可能會擷取過時的檔案。