本頁面由 Cloud Translation API 翻譯而成。

批次動態饋給中的 v1 版本

在批次動態饋給中，實體的版本會透過動態饋給信封中的 dateModified 欄位決定：

{
  "@context": "http://schema.googleapis.com",
  "dateModified": "2018-12-28T06:30:00:123-07:00",
  "@type": "DataFeed",
  "dataFeedElement": [
    /* All the items that are part of this feed go here */
  ]
}

dataFeedElement 欄位中列出的所有實體都會具有相同的時間戳記，如信封中所列。

舉例來說，你可以使用下列含有兩個實體的動態饋給：

{
  "@context": "http://schema.googleapis.com",
  "@type": "DataFeed",
  "dateModified": "2018-12-28T06:30:00:123-07:00",
  "dataFeedElement": [
    {
      "@type": "Restaurant",
      "@id": "http://www.provider.com/somerestaurant",
      ...
    },
    {
      "@type": "Menu",
      "@id": "http://www.provider.com/somerestaurant/menu/1"
      ...
    }
  ]
}

菜單和餐廳實體在收到及處理後，會分別設為「2018-12-28T06:30:00:123-07:00」。

使用分批更新進行版本管理

使用商品目錄更新傳送實體時，系統會透過 update_time 欄位 (新增/更新呼叫) 或 delete_time 欄位 (刪除呼叫) 設定版本。由於這些欄位為選用欄位，因此預設時間戳記會設為 Google 收到呼叫的時間。

範例 1：明確設定 update_time

假設系統在 2018-12-28T06:30:10:123-07:00 收到以下增量呼叫，該呼叫是針對全新餐廳發出。假設資料動態饋給使用 v1 商品目錄架構，以下是該實體的 HTTP POST 要求，其 ID 為「http://www.provider.com/somerestaurant」：

POST v2/apps/provider-project/entities/http%3A%2F%2Fwww.provider.com%2Fnewrestaurant:push
Host: actions.googleapis.com
Content-Type: application/ld+json

以下 JSON 酬載主體包含 update_time 欄位。實體的 ID 為「http://www.provider.com/somerestaurant」，因此這個實體的版本會是 6:30:00，而非收到的時間 (十秒後的 6:30:10)：

{
// This envelope is to be used for incremental.
  "entity": {
    // Note: "data" is not serialized as a string in our example for readability.
    "data": "[entity in JSON format serialized as a string]",
    "vertical": "FOODORDERING"
  },
  "update_time":"2018-12-28T06:30:00:123-07:00"
}

範例 2：隱含設定 update_time

假設系統在 2018-12-28T06:30:10:123-07:00 收到以下增量呼叫，該呼叫是針對全新餐廳發出。假設動態饋給使用 v1 商品目錄架構，以下是該實體的 HTTP POST 要求，其 ID 為「http://www.provider.com/somerestaurant」：

POST v2/apps/provider-project/entities/http%3A%2F%2Fwww.provider.com%2Fnewrestaurant:push
Host: actions.googleapis.com
Content-Type: application/ld+json

以下 JSON 酬載主體「不含」欄位 update_time。因此，ID 為「http://www.provider.com/somerestaurant」的實體會以 6:30:10 的版本編號顯示：

{
// This envelope is to be used for incremental.
  "entity": {
    //Note: "data" is not serialized as a string in our example for readability.
    "data": "[entity in JSON format serialized as a string]",
    "vertical": "FOODORDERING"
  }
}

批次和增量之間的版本管理

只有在實體為最新版本時，系統才會處理並放送該實體。請注意，透過批次傳送的實體通常需要幾天才能處理完畢，而透過增量 API 傳送的實體則會立即處理。

最佳做法

根據實體在系統中修改的時間，分別在增量和批次中設定 update_time 和 dateModified 欄位。
如果批次動態饋給 (檔案) 列出多個頂層實體 (例如，您將餐廳與服務和菜單配對)，請在實體資料更新時更新時間戳記。
在遞增呼叫中，我們強烈建議您明確設定 update_time 欄位。
一旦發出增量呼叫，必須在 Google 再次擷取前，先更新對應的動態饋給時間戳記 (dateModified)。

範例

Google 會在 2018-12-28 上午 11 點，針對全新餐廳擷取下列檔案：

{
  "@context": "http://schema.googleapis.com",
  "@type": "DataFeed",
  "dateModified": "2018-12-28T06:30:00-07:00",
  "dataFeedElement": [
    {
      "@type": "Restaurant",
      "@id": "http://www.provider.com/newrestaurant",
      ...
    },
    {
      "@type": "Menu",
      "@id": "http://www.provider.com/newrestaurant/menu/1"
      ...
    }
    {
      "@type": "Service",
      "@id": "http://www.provider.com/newrestaurant/service/1"
      ...
    }
  ]
}

這些實體已順利處理，版本為「2018-12-28T06:30:00-07:00」。由於批次動態饋給需要時間處理，因此通常會在 2 天後才會放送。

不過，在下午 1 點時，合作夥伴的系統更新了餐廳的電話號碼，因此 Google 在 13:05 (5 秒後) 收到以下遞增式呼叫：

POST v2/apps/provider-project/entities/http%3A%2F%2Fwww.provider.com%2Fnewrestaurant:push
Host: actions.googleapis.com
Content-Type: application/ld+json
{
// This envelope is to be used for incremental.
  "entity": {
    //Note: "data" is not serialized as a string in our example for readability.
    "data": "[entity in JSON format serialized as a string]",
    "vertical": "FOODORDERING"
  },
  "update_time":"2018-12-28T13:00:00-07:00"
}

update_time 已明確提供，且大於先前版本 (同一天的上午 6 點 30 分)，因此餐廳實體的版本現在為「2018-12-28T13:00:00-07:00」。不過，選單和服務實體的版本仍為「2018-12-28T06:30:00-07:00」。

系統會發出漸進式呼叫，因此批次動態饋給會更新為新的對應時間戳記。此外，系統也會將相應的變更套用至相關實體 (餐廳實體的電話號碼已更新)。

{
  "@context": "http://schema.googleapis.com",
  "@type": "DataFeed",
  "dateModified": "2018-12-28T13:00:00-07:00",
  "dataFeedElement": [
    {
      "@type": "Restaurant",
      "@id": "http://www.provider.com/newrestaurant",
      ...
    },
    {
      "@type": "Menu",
      "@id": "http://www.provider.com/newrestaurant/menu/1"
      ...
    }
    {
      "@type": "Service",
      "@id": "http://www.provider.com/newrestaurant/service/1"
      ...
    }
  ]
}

隔天 (2018-12-29) 晚上 11 點，系統會再次擷取動態消息。餐廳仍使用相同的版本 (12 月 28 日下午 1 點)，因此這個實體會遭到刪除，而目前的版本則會保留。不過，Menu 和 Service 實體會更新為新版本。

Sitemap 時間戳記

網站地圖中的 last-modified 回應標頭「不會」影響實體的版本。這會影響 Google 擷取動態饋給的時間。

最佳做法

只有在所有檔案都已更新並可供擷取時，才更新回應標頭。
在增量中明確使用 update_time 和 delete_time。
將 update_time、delete_time 和 dateModified 設為資料變更時的時間。