評論動態饋給

查看動態饋給語意

評論動態饋給的語意略有差異:

快照評論動態饋給:

  • 如果評論動態饋給中的服務供應商目前不在 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 否