XML 架構參考資料

書籍:/product-review-feeds/_book.yaml

標題:XML 架構參考資料

Google 產品評論動態饋給的 XML 架構可定義 XML 動態饋給可接受的結構。XML 架構使用 .xsd 副檔名。如同 DTD 檔案,XML 架構定義了可在 XML 文件中顯示的元素和屬性。

如要進一步瞭解 XML 架構,請參閱這份 XML 架構入門

產品評論動態饋給的 XML 架構發布於以下網址:http://www.google.com/shopping/reviews/schema/product/2.3/product_reviews.xsd

此結構定義定義的動態饋給結構說明如下。在本說明中,類型前置字串為 xs: 的類型名稱是指 XML 命名空間 http://www.w3.org/2001/XMLSchema 中的內建 XML 結構定義類型。

我們的系統預計隨時會顯示完整的動態消息。系統會刪除先前提交,但未納入下一個完整動態饋給的所有評論。因此,您在提交動態饋給時請務必提交所有評論。

頂層 <feed> 元素

<feed> 元素會按照下列順序包含這些元素。

元素 發生次數 類型 說明
<version> 必要 (1) xs:string 指出目前使用的產品評論動態饋給結構定義版本。目前僅支援 <version>2.3</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 發布者的網站小圖示連結。圖片尺寸應為網站小圖示:16x16 像素。圖片格式應為 GIF、JPG 或 PNG。

<reviews>

含有產品評論。<reviews> 元素會按照這些順序包含這些元素。

元素 發生次數 類型 說明
<review> 必要 (1-無限制) reviewType 個別的獨立產品評論。如果審查涉及發布商廣告空間中的多項產品,請指定一次評論,並在 <products> 元素中加入多個 <product> 元素。

<review>

個別的獨立產品評論。如果評論與發布商廣告空間中的多項產品有關,請指定該評論一次,並在 <products> 元素中加入多個 <product> 元素。<review> 元素包含順序中的這些元素。

元素 發生次數 類型 說明
<review_id> 選填 (1) nonEmptyStringType 發布商系統中產品評論的永久專屬 ID。
<reviewer> 必要 (1) reviewerType 產品評論的作者。
<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 評論的內容。
<pros> 選填 (1) xs:sequence 根據評論者的想法提供專業服務。不使用由「評論者」撰寫的樣板文字,例如「quot;pro:」。
<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

根據評論者的意見的個人專家。展示順序必須按照顯示順序排列。不使用由「評論者」撰寫的樣板文字,除非由評論者撰寫。

範例:

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

<cons>

包含評論者的指南。<cons> 元素會按照這些順序包含這些元素。

元素 發生次數 類型 說明
<con> 必要 (1-無限制) nonEmptyStringType

根據評論者的個別觀點。列出的順序應按照顯示順序列出。省略樣板文字,例如「cont;con:」,除非審查者寫入。

範例:

<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 並擷取審查者指派的評分。這個值應位於 minmax 屬性定義的納入範圍。<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)。
<mpns> 如果與評論相關的產品沒有全球交易品項識別碼,請務必提供必填資訊 (MPN)。必須和品牌合作)

對於所有其他評論,此為選填屬性 (1)
mpnsType 含有與產品相關聯的製造商零件編號 (MPN)。
<skus> 必填 (如果與評論相關聯的產品沒有專屬全球交易品項識別碼或製造商零件編號,請務必加入 SKU,以便比對評論)。應提交品牌)

對於所有其他評論,此為選填屬性 (1)
skusType 包含與產品相關聯的 SKU (存貨單位)。這個值通常會與產品動態饋給中的產品 ID 相符。
<brands> 必填 (如果與評論相關聯的產品沒有全球交易品項識別碼,請務必加入品牌以協助評論比對。必須與製造商零件編號一併提交)

對於所有其他評論,此為選填屬性 (1)
brandsType 包含與產品相關的品牌名稱。
<asins> 選填 (1) asinsType 包含與產品相關聯的 ASIN (Amazon Standard Identification Numbers)。

<gtins>

包含與產品相關聯的全球交易品項識別碼 (GTIN)。<gtins> 元素會按照這些順序包含這些元素。

元素 發生次數 類型 說明
<gtin> 必要 (1-無限制) nonEmptyStringType 產品的全球交易品項識別碼。

<mpns>

含有與產品相關聯的製造商零件編號 (MPN)。<mpns> 元素會按照這些順序包含這些元素。

元素 發生次數 類型 說明
<mpn> 必要 (1-無限制) nonEmptyStringType 產品的製造商零件編號。

<skus>

包含與產品相關聯的 SKU (存貨單位)。<skus> 元素會按照這些順序包含這些元素。

元素 發生次數 類型 說明
<sku> 必要 (1-無限制) nonEmptyStringType 發布商商品目錄中的產品存貨單位。

<brands>

包含與產品相關的品牌名稱。<brands> 元素會按照這些順序包含這些元素。

元素 發生次數 類型 說明
<brand> 必要 (1-無限制) nonEmptyStringType 產品的品牌名稱。

<asins>

包含與產品相關聯的 ASIN (Amazon Standard Identification Numbers)。 元素依照下列順序包含這些元素。

元素 發生次數 類型 說明
<asin> 必要 (1-無限制) nonEmptyStringType 產品的 Amazon Standard Identifier 號碼。每個 ASIN 的長度上限為 10 個字元。