XML 架構參考資料

Google 產品評論動態饋給的 XML 架構會定義 XML 動態饋給可接受的結構。XML 架構使用 .xsd 副檔名。與 DTD 檔案類似，XML 結構描述會定義 XML 文件中可顯示的元素和屬性。

如要進一步瞭解 XML 架構，請參閱這份 XML 架構入門指南。

如要查看產品評論動態饋給的 XML 架構，請參閱： http://www.google.com/shopping/reviews/schema/product/2.4/product_reviews.xsd

以下說明這個結構定義的動態饋給結構。在本說明中，前置字元為 xs: 的型別名稱是指 XML 命名空間 http://www.w3.org/2001/XMLSchema 中的內建 XML 結構定義型別。

系統一律會預期收到完整動態消息。先前提交的評論如果未包含在下一個完整動態饋給中，就會遭到刪除。因此，提交動態饋給時，請務必一併提交所有評論。

頂層 <feed> 元素

<feed> 元素包含下列元素，且順序如清單所示。

元素 出現次數 類型 說明
<version> 必要 (1) xs:string 指出目前使用的產品評論動態饋給架構版本。目前僅支援 <version>2.4</version>。
<aggregator> 選用 (1) aggregatorType 發布者可能會使用評論集結網站管理評論並提供動態饋給。這個元素表示使用集結網站，並包含集結網站的相關資訊。
<publisher> 必要 (1) publisherType 發布者資訊，發布者可能是零售商、製造商、評論服務公司，或任何發布產品評論的實體。
<reviews> 選用 (1) xs:sequence 包含產品評論。

<feed> 會定義動態饋給中使用的元素獨一性限制。

子項元素

<aggregator>

發布商可能會使用評論集結網站管理評論並提供動態饋給。這個元素表示使用集結網站，並包含集結網站的相關資訊。<aggregator> 元素包含下列元素，且順序如清單所示。

元素 出現次數 類型 說明
<name> 必填 (1) nonEmptyStringType 產品評論匯總工具的名稱。

<publisher>

發布者資訊，可能是零售商、製造商、評論服務公司，或任何發布產品評論的實體。<publisher> 元素包含這些元素，順序如清單所示。

元素 出現次數 類型 說明
<name> 必填 (1) nonEmptyStringType 產品評論發布者的名稱。
<favicon> 選用 (1) httpUrlType 發布者的公司 Favicon 連結。圖片尺寸應為 Favicon 大小：16x16 像素。圖片格式應為 GIF、JPG 或 PNG。

<reviews>

包含產品評論。<reviews> 元素包含下列元素，且順序如清單所示。

元素 出現次數 類型 說明
<review> 必要 (1 個以上) reviewType 個別產品的專屬評論。如果評論與發布商目錄中的多項產品相關，請指定一次評論，並在 <products> 元素中加入多個 <product> 元素。

<review>

個別產品的專屬評論。如果評論與發布商目錄中的多項產品相關，請指定一次評論，並在 <products> 元素中加入多個 <product> 元素。<review> 元素包含這些元素，順序如下。

元素 出現次數 類型 說明
<review_id> 必填 (1) nonEmptyStringType 發布者系統中產品評論的永久專屬 ID。
<reviewer> 必填 (1) reviewerType 產品評論的作者。
<is_verified_purchase> 選用 (1) xs:boolean 指出是否已驗證評論者購買產品。
<is_incentivized_review> 選用 (1) xs:boolean 指出評論者是否因獲得獎勵而評論產品。
<review_timestamp> 必填 (1) xs:dateTime

評論的撰寫時間戳記。

範例：

2014-04-21T11:07:07-06:00
2014-04-21T18:00:00+01:00
2014-04-21T00:00:00Z
<title> 選用 (1) nonEmptyStringType 評論標題。
<content> 必填 (1) nonEmptyStringType 評論內容。
<review_language> 選用 (1) xs:string 評論的語言 (BCP 47)。
<review_country> 選用 (1) xs:string 評論者的國家/地區代碼 (ISO 3166-1)。
<pros> 選用 (1) xs:sequence 包含根據評論者意見列出的優點。省略樣板文字，例如「優點：」，除非是評論者撰寫的內容。
<cons> 選用 (1) xs:sequence 包含根據評論者意見提出的缺點。省略樣板文字，例如「con:」，除非是評論者撰寫的內容。
<reviewer_images> 選用 (1) xs:sequence 包含評論者提供的產品圖片連結。
<review_url> 必填 (1) reviewUrlType 評論到達網頁的網址。
<ratings> 必填 (1) xs:sequence 包含與評論相關聯的評分。
<products> 必填 (1) xs:sequence 包含與評論相關聯的產品。
<is_spam> 選用 (1) xs:boolean 指出評論是否在發布者的系統中標示為垃圾內容。
<collection_method> 選用 (1) collectionMethodType

收集評論的方法。這個值必須是下列其中一個值：

unsolicited
使用者提交評論時，並非回覆特定邀請。
post_fulfillment
使用者收到產品後，獲得邀請才提交評論。
<transaction_id> 選用 (1) nonEmptyStringType 與發布商系統中評論相關聯的交易永久專屬 ID。這個 ID 可用來指出多則評論與同一筆交易相關聯。

<reviewer>

產品評論的作者。<reviewer> 元素包含下列元素，且順序如清單所示。

元素 出現次數 類型 說明
<name> 必填 (1) reviewerNameType

評論作者的姓名。

範例：

<name>Jane</name>
<reviewer_id> 選用 (1) nonEmptyStringType

發布商系統中評論作者的永久專屬 ID。

範例：

<reviewer_id>14295</reviewer_id>

<name>

評論作者的姓名。<name> 元素是 nonEmptyStringType 的擴充功能，內含評論者的名稱或別名。<name> 元素包含這些屬性。

屬性 出現次數 類型 說明
is_anonymous 選用 xs:boolean

指出評論者是否匿名。

範例：

<name is_anonymous="true">Anonymous</name>

<pros>

包含根據評論者意見列出的優點。<pros> 元素包含下列元素，且順序如清單所示。

元素 出現次數 類型 說明
<pro> 必要 (1 個以上) nonEmptyStringType

根據評論者的意見，個別優點。PRO 應按照顯示順序排列。除非是評論者撰寫，否則請省略「優點：」等樣板文字。

範例：

<pros>
  <pro>Sleek design</pro>
</pros>

<cons>

包含根據評論者意見提出的缺點。<cons> 元素包含下列元素，且順序如清單所示。

元素 出現次數 類型 說明
<con> 必要 (1 個以上) nonEmptyStringType

根據評論者的意見，個別缺點。缺點的列出順序應與顯示順序相同。除非是評論者撰寫，否則請省略「缺點：」等樣板文字。

範例：

<cons>
  <con>Pricey</con>
</cons>

<review_url>

評論到達網頁的網址。<review_url> 元素是 httpUrlType 的擴充功能，內含評論到達網頁的連結。<review_url> 元素包含這些屬性。

屬性 出現次數 類型 說明
type 必要 xs:string

類型必須是下列其中一項：

singleton
評論頁面只包含這則評論。
group
評論頁面包含一組評論，包括這則評論。

範例：

<review_url type="singleton">http://www.example.com/review_5.html</review_url>

<reviewer_images>

包含評論者提供的產品圖片。<reviewer_images> 標記包含許多 <reviewer_image> 元素。

元素 出現次數 類型 說明
<reviewer_image> 必要 (1 個以上) reviewImageType

評論作者建立的受評產品圖片。

<reviewer_image>

單一評論圖片元素。

元素 出現次數 類型 說明
<url> 必填 (1) httpUrlType

評論作者建立的受評產品圖片網址。網址不一定要以圖片副檔名結尾。

範例：

<reviewer_images>
  <reviewer_image>
    <url>https://example.com/test.jpg</url>
  </reviewer_image>
  <reviewer_image>
    <url>https://example.com/test.gif</url>
  </reviewer_image>
</reviewer_images>

<ratings>

包含與評論相關聯的評分。<ratings> 元素包含下列元素，且順序如清單所示。

元素 出現次數 類型 說明
<overall> 必填 (1) ratingType 審查人員對產品的整體評分。

<overall>

審查人員對產品的整體評分。<overall> 元素會擴充 xs:decimal simpleType，並擷取評論者給予的評分。值應在 min 和 max 屬性定義的含頭尾範圍內。<overall> 元素包含這些屬性。

屬性 出現次數 類型 說明
min 必要 xs:integer 評分的最低可能分數。這應為最差的可能評分，且不應為無評分的值。
max 必要 xs:integer 評分最高分。max 屬性的值必須大於 min 屬性的值。

<products>

包含與評論相關聯的產品。<products> 元素包含下列元素，且順序如清單所示。

元素 出現次數 類型 說明
<product> 必要 (1 個以上) productType 與評論相關聯的產品。

<product>

與評論相關聯的產品。<product> 元素包含下列元素，且順序如清單所示。

元素 出現次數 類型 說明
<product_ids> 選用 (1) productIdsType 與產品相關聯的 ID。
<product_name> 選用 (1) nonEmptyStringType 產品的描述性名稱。
<product_url> 必填 (1) httpUrlType 產品的網址。如果評論網址和產品網址相同，這個網址的值可以與 <review_url> 元素相同。

<product_ids>

與產品相關聯的 ID。<product_ids> 元素包含下列元素，且順序如清單所示。

元素 出現次數 類型 說明
<gtins> 必填 (適用於與已知全球交易品項識別碼產品相關聯的所有評論)

所有其他評論皆為選填 (1)		 gtinsType 包含與產品相關聯的全球交易品項識別碼 (GTIN)。系統支援全球交易品項識別碼的子類型 (例如：通用產品代碼、EAN、國際標準書號、JAN)。
<mpns> 必填 (適用於與已知製造商零件編號產品相關聯的所有評論)

對於所有其他評論，此為選填屬性 (1)		 mpnsType 包含與產品相關聯的製造商零件編號 (MPN)。
<skus> 必填 (與已知 SKU 的產品相關聯的所有評論)

其他所有評論則為選填屬性 (1)		 skusType 包含與產品相關聯的 SKU (存貨單位)。這通常與產品動態饋給中的產品 Offer ID 相符。
<brands> 必填 (適用於與已知品牌產品相關的所有評論)

其他所有評論則為選填 (1)		 brandsType 包含與產品相關聯的品牌名稱。
<asins> 選用 (1) asinsType 包含與產品相關聯的 ASIN (Amazon 標準識別號碼)。

<gtins>

包含與產品相關聯的全球交易品項識別碼 (GTIN)。<gtins> 元素包含下列元素，且順序如清單所示。

元素 出現次數 類型 說明
<gtin> 必要 (1 個以上) nonEmptyStringType 產品的全球交易品項識別碼。系統支援全球交易品項識別碼的子類型 (例如：通用產品代碼、EAN、國際標準書號、JAN)。

<mpns>

包含與產品相關聯的製造商零件編號 (MPN)。<mpns> 元素包含下列元素，且順序如清單所示。

元素 出現次數 類型 說明
<mpn> 必要 (1 個以上) nonEmptyStringType 產品的製造商零件編號。

<skus>

包含與產品相關聯的 SKU (存貨單位)。<skus> 元素包含下列元素，且順序如清單所示。

元素 出現次數 類型 說明
<sku> 必要 (1 個以上) nonEmptyStringType 出版商廣告空間中的產品存貨單位。

<brands>

包含與產品相關聯的品牌名稱。<brands> 元素包含下列元素，且順序如清單所示。

元素 出現次數 類型 說明
<brand> 必要 (1 個以上) nonEmptyStringType 產品的品牌名稱。

<asins>

包含與產品相關聯的 ASIN (Amazon 標準識別號碼)。<asins> 元素包含下列元素，且順序如清單所示。

元素 出現次數 類型 說明
<asin> 必要 (1 個以上) nonEmptyStringType 產品的 Amazon 標準識別號碼。每個 ASIN 長度為 10 個字元，且為英數字元。