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

建立動態饋給

媒體動態饋給為 JSON 物件，包含一組實體，用來代表自己目錄中的媒體內容，例如電視影集、電影、歌曲、專輯等。新手上路流程就是開始開發動態饋給檔案準備就緒後，請代管檔案使用其中一種支援的代管方法定期擷取動態饋給。

動態饋給檔案格式規定

動態饋給檔案必須符合下列規定：

動態饋給檔案的副檔名為 .json。
不要加密動態饋給檔案。
以 UTF-8 編碼動態饋給檔案 (請檢查檔案編輯器設定)。
如果動態饋給檔案大於 1 GB (未壓縮)，請將檔案分割為多個檔案。
建議您為每種實體類型 (例如 tvseries.json、tvseasons.json、tvepisodes.json、movies.json 等) 建立檔案。
- 如果這些檔案超過 1 GB，請將實體分割成多個檔案 (例如 tvepisodes_01.json、tvepisodes_02.json 等)。
- 只要檔案大小不超過 1 GB，單一檔案可包含的實體數量則沒有限制。
確認檔案已根據 JSON 規格使用 BOM 編碼。如要檢查 Linux OS，hexdump file.json | head -n 1 的開頭不得為 0x00 的 BBEF。

動態饋給類型

正式版動態饋給

這代表一組 JSON 動態饋給檔案，一起代表整個目錄。。如要瞭解如何建立動態饋給，請參閱下一節。
這是首次與 Google 整合時所需的動態饋給。
將這類動態饋給提交給 Google 後，會進行全面分析及反覆修正就得達到品質門檻，包括擷取的資訊量及才最後擷取並啟動模型

暫存動態饋給

在某些情況下，必須擴充正式版動態饋給。一些例子有以下情況：
- 擴充動態饋給，納入先前未推出的新實體類型。
- 擴充動態饋給，加入大量新實體/中繼資料並推出新動態饋給語言代碼。
- 將動態饋給擴大至新的平台類型。舉例來說，只在以下情況下，而您想擴展到 Google TV 的上市。
在這種情況下，就需要使用測試環境動態饋給。這項動態饋給是正式版動態饋給的副本，但含有額外中繼資料，例如新平台的深層連結、新語言代碼的中繼資料依此類推
與正式版動態饋給類似，我們也會進行全面分析及疊代數次，能夠改善品質與擷取的資訊量和正確性達到品質標準後，這個動態饋給會取代目前的正式版動態饋給，成為最新正式環境動態饋給
透過這個動態饋給，我們可以將初次推出與額外推出的項目分開，並執行所有進行必要的測試，而不影響正式版動態饋給。確保服務端不會中斷使用者體驗

請與 Google 代表合作，釐清您對上述做法的疑問。

建立動態饋給檔案

建立動態饋給時，請遵循下列最佳做法：

使用少量實體建立範例動態饋給

如要建立包含所有目錄中所有內容的動態饋給，建議您先建立只包含少量實體的範例動態饋給處理動態饋給時以負載平衡機制分配流量即可降低應用程式發生效能問題的風險限制實體組合的大小您就能排除這些錯誤顯示警告
驗證樣本動態饋給

我們提供的工具可確保您的動態饋給符合規格。建議做法請使用這些工具解決範例動態饋給中的所有錯誤和警告。
建立正式版動態饋給

確認一小組實體的結構良好後，即可為整個目錄建立動態饋給。

建立樣本動態饋給

從目錄中選取一個代表性實體。請選擇結構合理但實體，在目錄中的實體也屬於典型的項目。

使用資料動態饋給驗證工具檢查語法錯誤和缺少的必要屬性。(詳情請參閱下一節)。

含有單一 Movie 實體的動態饋給範例

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    {
      "@context": ["http://schema.org", {"@language": "en"}],
      "@type": "Movie",
      "@id": "http://www.example.com/my_favorite_movie",
      "url": "http://www.example.com/my_favorite_movie",
      "name": "My Favorite Movie",
      "potentialAction": {
        "@type": "WatchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
          "inLanguage": "en",
          "actionPlatform": [
            "http://schema.org/DesktopWebPlatform",
            "http://schema.org/MobileWebPlatform",
            "http://schema.org/AndroidPlatform",
            "http://schema.org/AndroidTVPlatform",
            "http://schema.org/IOSPlatform",
            "http://schema.googleapis.com/GoogleVideoCast"
          ]
        },
        "actionAccessibilityRequirement": {
          "@type": "ActionAccessSpecification",
          "category": "subscription",
          "requiresSubscription": {
            "@type": "MediaSubscription",
            "name": "Example Package",
            "commonTier": true,
            "@id": "[partner determined string]"
          },
          "availabilityStarts": "2018-07-21T10:35:29Z",
          "availabilityEnds": "2019-10-21T10:35:29Z",
          "eligibleRegion": [
            {
              "@type": "Country",
              "name": "US"
            },
            {
              "@type": "Country",
              "name": "CA"
            }
          ]
        }
      },
      "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
      "releasedEvent": {
        "@type": "PublicationEvent",
        "startDate": "2008-01-20",
        "location": {
          "@type": "Country",
          "name": "US"
        }
      },
      "description": "This is my favorite movie.",
      "actor": [
        {
          "@type": "Person",
          "name": "John Doe",
          "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
        },
        {
          "@type": "Person",
          "name": "Jane Doe",
          "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
        }
      ],
      "identifier": [
        {
          "@type": "PropertyValue",
          "propertyID": "IMDB_ID",
          "value":  "tt0123456"
        }
      ]
    }
  ]
}

驗證樣本動態饋給

下列工具可協助您使用 Google 結構化資料驗證範例動態饋給媒體動態饋給的規格

資料動態饋給驗證工具

資料動態饋給驗證工具一次只能驗證單一實體。使用這項工具驗證樣本來找出結構錯誤和常見內容錯誤。你可以到進一步瞭解這項工具。
JSON 結構定義驗證工具

JSON 結構定義驗證工具可以驗證動態饋給中的所有檔案。在開發資訊提供，以避免常見的結構錯誤。想進一步瞭解工具，請按一下這裡。

建立正式版動態饋給

解決範例動態饋給中的所有錯誤和警告後，請展開動態饋給以納入所有目錄中的實體
使用資料動態饋給驗證工具一次驗證動態饋給中少量實體 (貼上大量實體) 可能會凍結網路瀏覽器)。請確認動態饋給包含所有實體在你的目錄中比較實體數量和商品數量目錄

找出價格

代管動態饋給