查看動態饋給語意
評論動態饋給的語意略有差異:
快照評論動態饋給:
- 如果評論動態饋給中的服務供應商目前不在 LSA 供應商資料庫中,系統就不會擷取該供應商的評論。
- 如果評論動態饋給中的任何服務供應商目前存在於「在地生活服務」供應商資料庫,系統會按照下列方式處理供應商的評論:
- 如果動態饋給中的評論在 LSA 儲存空間中不存在,則應建立該評論。
- 如果動態饋給中的任何評論在 LSA 儲存空間中都有對應的評論,系統就會以新資訊更新該評論。
- 如果動態饋給中沒有任何評論,但 LSA 儲存空間中存在相應評論,則該評論會遭到刪除。
- 如果評論動態消息中沒有任何服務供應商,但該供應商目前存在於 LSA 供應商資料庫中,系統會刪除其評論,並停止放送該供應商的廣告。
- 請注意,評論數為 0 的供應商也應在評論動態饋給中顯示項目 (而非省略),才能放送廣告 (請參閱評論動態饋給範例 - listingId 2)。
請注意,評論動態饋給不支援增量。每個設定檔動態饋給都必須有對應的評論動態饋給。
處理評論時發生錯誤
如果評論動態饋給項目無效,系統會略過該項目,並繼續處理其餘有效的動態饋給項目。
如果評論動態饋給無效 (例如不符合結構定義),系統會停止處理整個評論動態饋給。
查看欄位
欄位名稱 | 類型 | 說明 | 範例 | 必填 | 限制 |
---|---|---|---|---|---|
serviceProviderId | 數字 | 商家資訊 (服務供應商) 的專屬 ID | 12345 | 是 | 必須符合 int64 |
ratingCount | 整數 | 經過驗證的消費者評分數量 | 10 | 是 | 必須大於或等於零。 |
作者 | 字串 | 評論作者的名稱 | 「Jack L.」 | 否 | |
reviewId | 字串 | 評論的專屬 ID。如果每則評論沒有專屬 ID,第三方必須為每則評論產生專屬 ID (例如評論文字和使用者的雜湊值),至少在同一供應商的所有評論中必須是專屬 ID。 | 「123」 | 是 | |
reviewText | 字串 | 作者撰寫的評論內容 | 「做得好!」 | 否 | |
rating | 整數 | 評分 (必須是介於 1 至 5 之間的整數) | 4 | 是 | 必須是介於 1 到 5 之間的整數。 |
serviceLocationCity | 字串 | 提供服務的城市 | 「紐約」 | 否 | |
reviewTimestampMicros | 整數 | 評論的撰寫時間戳記,以微秒為單位。 | 1.45142E+15 | 否 | |
serviceTimestampMicros | 整數 | 服務完成的時間戳記,格式為微秒。 | 1.45132E+15 | 否 | |
language | 字串 | 評論文字的語言,請使用 ISO 639-1 語言代碼 (小寫,2 個字母)。必須與供應商的指定語言一致。 | “en” | 否 | 必須與相關聯供應商指定的指定語言一致。如未指定,則預設為「en」。 |
category | 物件 | 類別結構 | 否 | ||
category->categoryId | 列舉 | 服務類別 (LSA 分類) | 「garage_door_pro」 | 否 | |
類別->工作 | 列舉 | 服務的工作類型 (工作) (在 LSA 分類中) | 「Repair a Garage Door」(維修車庫門) | 否 | |
confirmedCustomer | 布林值 | 如果評論來自已確認的顧客 (有待開發客戶) | TRUE | 否 |