Tip:
Highlight text to annotate it
X
DANNY HERMES:嗨
大家好
歡迎參加這場網路研討會 我們的主題是
如何維持商品資料的即時性
我是 Danny Hermes
我在 Google 的商務小組中
擔任開發人員公關的職務
我們負責宣傳與 API 相關的資訊
提供協助和意見 並舉辦像這類型的
網路研討會
今天和我一起出席的有 Ali Afshar Amanda Surya 和 Jasmine Kahn
他們會在線上透過即時通訊 協助您解決各種問題
請儘量發問
這裡有個選項是舉手
但請不要舉手 直接提出問題
他們會盡其所能回答
那麼讓我們馬上進入主題吧
今天我們希望可以解答
關於 Content API 的一些重要問題
首先,Content API 是什麼?
其次,什麼是資料更新政策?
如何套用到 API?
為什麼要使用 API?
我們會針對 API 和 Data Feed
比較兩者有何異同
以及有關實作的部分
如何使用 API?
整個過程中,如果您對 任何一張投影片有任何問題
請透過即時通訊功能提出 我們會提供您
適當的答覆
首先,什麼是 Content API for Shopping?
在我們說明之前 必須先談談
Google 商品搜尋
在您將商品上載至 Google Merchant Center 之後
這些產品會出現 Google 商品搜尋中
而商品資料會儲存在 Merchant Center
然後傳送到電腦上的
Google 商品搜尋
以及行動版 Google Shopper 和一些其他平台
例如 Google Affiliate Network
和 Google Commerce Search
舉例來說 假如您有三台數位相機
準備要出售
您將相關資料上載到 Google Merchant Center
然後有人在 Google
搜尋數位相機
在這裡可以看到 您上載的三台數位相機
以藍色強調顯示
就像我說的 為了讓商品在 Google 商品搜尋
獲得曝光機會 您必須將商品資料上載到
Google Merchant Center
主要可以透過兩種方式
Google 商品資訊提供 以及我們今天的主題
Content API for Shopping
什麼是 Content API for Shopping?
我提過要說明這個問題
這是一個以 HTTP、REST 和 GData 為基礎的 API
這代表什麼意思呢?
當您對所有商品資料提出要求時
可能取得、發佈、放置或刪除資料
這是 REST API 的四種動作
您將要求傳送到
我們在 googleapis.com 運作的資源
我們則透過 XML 回應
關於 API...
API 是一種程式化的方式 讓您可和 Google 伺服器
或現在提到的 Google Merchant Center
進行互動
但這種方式只能讓
兩個程式之間彼此溝通
相較之下 Data Feed 只是
包含您商品所有資訊的檔案
這與透過 Content API 傳送的要求十分相似
但這只是一個 .txt 檔案
或 XML 檔案
在這些檔案中 您運用屬性和實體
指定特定的商品資料
而這些.txt 或 XML 檔案
會直接上載到 Merchant Center
所以 Content API for Shopping
可讓您的開發人員以 程式化的方式
將所有資料上載到 Google 的購物網站
如果您擁有自己的線上市集
旗下有多位賣家 或多個子商店
那麼,您就可以藉此管理自己的子帳戶
此外您還能建立 Data Feed
所以如果您想要 混合搭配使用
Content API 和 Data Feed
可透過 API 管理資訊提供
上載資料後
即可透過 Google Merchant Center 資訊主頁
瞭解效能並進行其他設定
這個資訊主頁包含 下列相關資訊
您目前使用的資訊提供 目前已上載的商品
資料品質 以及其他效能統計資訊
此外,您可以使用這個 API 追蹤使用者的點擊行為
透過投影片中的這個連結 提出要求....
在這裡我就不從頭到尾操作一次了
不過您必須指定開始日期
結束日期及特定商品 然後返回
在日期範圍中按一下追蹤
這是 API 的一項額外優點
接著是更新政策
當有人造訪 Google 搜尋 並尋找某項商品
如果這個商品 像您在這裡看到的一樣
標價 $102 美元 使用者就會認為可以用
$102 美元買到這項商品
如果您的底價與總價不同
使用者會想知道有什麼不同
他們也想知道最後要付多少錢
對吧?
對於 Google 商品搜尋來說
我們關心三種對象
第一,我們關心使用者
我們希望儘可能讓使用者感到滿意
我們希望他們能找到 想找的東西
我們希望他們可以得到
準確的商品資訊
第二,我們關心零售商與賣家
我們關心他們販售商品的情況
因為我們希望他們在 透過 Google 商品搜尋
販售商品時 也能對我們的服務感到滿意
第三,是我們自己
我們想要讓每一方都滿意
以此為目標 Google 資料更新政策
在使用者造訪時會...
我不必唸完這整篇
如果您要閱讀這份政策 請造訪這張投影片底下
的簡短網址 goo.gl/C5P8X
其中概述資料更新的 相關事項
不過請注意 使用者是我們優先考量的對象
然後是你們 再來是我們
那麼這要如何套用到 Content API?
具體的例子是 如果您經常變更價格和數量
希望能讓您在 Google Shopping 的商品
反映這些變更
如果您使用的是資訊提供 就只能在指定的日期
多次更新
這種方式會限制您
更新價格和數量的頻率
如果您使用的是 Content API for Shopping
就可以立即變更價格
而且變更會馬上生效
此外,如果您有大量商品目錄
每天進行維護和上載 大量的商品資訊提供
是很繁重不便的工作
不妨一次上載 大量商品目錄
之後就透過 API 進行小幅更新
為什麼要使用 Content API?
當然,最後那張投影片 已說明概念
這裡是整體的概略比較
像我說的 商品的 Data Feed 比較適用於
小型的靜態商品目錄
量少且不常變更
當然,因為這只是 .txt 或逗號分隔值檔案
執行起來不會太耗力
另一方面 Content API for Shopping
適用於變動快速的 大型商品目錄
但需要在開發上花費一些心力
Content API 很棒的一點在於
變更會即時生效
添加新商品非常迅速
大約只需幾秒鐘
就能將新商品上架
然後您會立即收到 Google 的回應
無論商品是否已上架
同樣的,如果您更新 商品的價格和數量
也無需額外的程序
將一項商品上載到 Merchant Center 之後
有一些程序可供我們 在向使用者提供服務之前
先確認品質,對吧?
如果您已上載一項商品 只是要更新價格或數量
更新會立即完成
這是透過我們稱為 快捷管道的方式進行
這是 Content API 很棒的部分
快捷管道適用於 價格和數量的變更
此外,Content API 是自動的
在這裡 您從 API 傳送的意見回饋
與您傳送要求的格式相同
意見回饋是按商品逐項建立的
所以當您插入、上載或刪除 每一項商品時
都會收到針對該商品的回應
還有,如我先前提到的 回應是立即性的
所以,當您提出要求時
會立即收到 來自 Google 的回應
讓您確認更新成功或失敗
相較之下,資訊提供 的意見回饋是透過電子郵件
大部分只是摘要 而非逐項對應
且格式相似的回應
兩者執行面相較之下
就像我說的 商品資訊提供是單純的
逗號分隔值檔案、.txt 檔案
或是 XML 檔案
不過您並不需要開發人員 為您處理
尤其是規模較小的時候
而 Content API 則需要
最基本的 XML 知識 才能處理
您也必須具備一些
開發技術
當然,如果我們更新規格 對 API 進行某些調整
以期改善用戶的滿意度 也改善我們提供給
商品搜尋使用者的資料
這時您就必須為您傳送的內容
進行一些維護
您可將這一點納入考量 不過 Content API 有一些很棒的功能
是資訊提供缺乏的
第一,如我之前說的
如果您有下游賣家 或是要管理多個商店
您可以透過 Content API 管理子帳戶
如果您要以一筆 Data Feed 上載整個商品目錄
然後透過 Content API 進行小幅變更
那麼您可以利用 Content API 管理 Data Feed
您可以透過 Content API
管理特定的 Data Feed
另一項很棒的功能是 您可以透過大量批次要求
一次處理新商品上架和 刪除商品等要求
我會在實作部分
詳細介紹相關功能
所以要如何使用?
實作方式為何?
這裡有一些 XML
是內含商品資訊的要求
準備傳送給 Google
這裡有個標題 上面還有一些物件
是些程序中必要的
小東西
這些內容是關於您的 商品、價格、狀態
這些屬性在使用者 搜尋商品時
都十分重要
再談談 XML
XML 是一種標記語言
與 HTML 很相似
是種結構化的語言
用來傳送機器能理解的資料
因此上一張投影片 看起來有點複雜
有點難讀
因為那是設計讓機器理解的
並不是要以這種顯示方式
讓一般人閱讀的
這裡有個 XML 的範例
用來定義一個註解
假設這是 Ali 傳給我的
他指定的主題是 XML
內文是 XML 太棒了!
總之 XML 就是一種 用來讓電腦讀取的
結構化資料
當我們擁有某項商品的 結構化資料後
就可以發佈
發佈是這個 API 的 四項動作之一
您要發佈到一個特定的連結
您必須經過驗證才能發佈 所以您要有授權憑證
這在說明文件中有相關說明
傳送到 Google 之後
我們會給您傳送成功的回應
有些東西
在最上面有一個 HTTP 代碼 201
表示成功
也請注意下面這邊
這裡顯示您所插入的商品位置
這很重要
請記下來
這個位置是您所插入的商品的
非重複網址
在這個網址中有一個根
content.googleapis.com/content/v1
然後是您的 ID
還有路徑和計劃 這也是一些
給 API 讀取的東西
在結尾有個非常重要的東西
商品 ID
這個商品 ID 是唯一的
專屬於您所插入的特定商品
您將商品插入目錄之後
可以透過這個連結返回
也可以藉此更新和刪除商品
當您傳送這個位置
也會收到 201 回應
如我之前說的 Google 傳給您的回應
與要求的格式相同
這裡有個回應的範例
其中標題、內容、ID 等元素 大部分都相同
另外還有已發佈和已編輯的記錄
這些資料來自 Google 包含您的上載時間
上次編輯時間、傳送時間
以及過期時間
預設是 30 天
在您進入實作部分之前
我們提供一個互動式的
線上示範版
只要您透過 Google 搜尋 查詢 Content API for Shopping
就能找到
這個示範版允許您 實際進行所有操作
可讓您插入新商品 更新現有的商品
刪除商品、管理子帳戶等
透過這個簡便的線上介面 可以操作在 API 中所能進行
的每個項目
當您提出這些要求
也會收到應有的回應 包括 HTTP 狀態回應
以及回應的內容
就跟您透過 API 實作時 收到的內容一樣
經過試用後 如果您決定進行實作
我們提供四種開放原始碼 用戶端程式庫
分別以 .net、Java、python 和 php 編寫
這些程式庫去除了 一些困難的部分
例如 ID 連結中
某些難記且不必要的東西
以及一些實作上 完全不需要的東西
這些部分完全省略 這些用戶端程式庫
是您提出要求、自行驗證 的絕佳管道
可執行透過 API 能進行所有事項
而且可讓您的開發人員 使用熟悉的語言操作
這張投影片最下方 有一個連結
可供您進一步瞭解 用戶端程式庫
我和一些開發人員 例如目前也在線上的 Ali
努力充實這些程式庫
目前仍在持續擴充
這些程式庫大部分 由許多 Google 工程師支援
但程式庫是開放原始碼
您隨時可以查看原始程式碼
您隨時可以查看更新
甚至可以自行更新
我在這查看了訪客清單
的確看到有些人為程式庫
解決了一些問題
也許可以為其他人帶來一些想法
如同之前說的 Conten API 有一項卓越功能
可以批次傳送要求
請注意旁邊這張圖片
您可以在一項發佈要求中 包含多項商品和操作
這是很棒的功能
您可將多項商品和多項操作 放進單一要求中
如果您要刪除一些商品
並更新其他商品 也可以辦到。
如果您還想插入新商品
並變更其他商品售價 也沒問題
只要運用批次操作即可
目前批次操作有其限制
每個要求最大 1 MB
但您可以用 gzip 或其他壓縮方式
縮減檔案大小
您會收到回應 就像一般插入或更新時
收到的回應一樣
同樣地,回應的格式 與傳送的格式相同
內容包含每項商品個別的
錯誤或成功訊息
其中一項好處是 只需傳送一個要求
不必為 100 項商品 傳送 100 個要求
而且可以儲存在要求冊中
接下來介紹 Content API 另一項很棒的實作功能
繼續進行之前
我必須說明一些背景
新增這項功能時 我們正在等待資訊提供的
規格變更
在場許多人可能 都已經知道這一點
我們在 9 月 22 日變更了 資訊提供的規格
讓使用者使用商品搜尋時
能夠更加得心應手
所以在 9 月 22 日之前
透過 Content API 傳送的 某些東西有效
9 月 22 日之後卻變成無效
所以我們提供 讓您提前收到警告的辦法
警告參數是您可以 附加在網址結尾處的一個簡單參數
無論要求插入或更新 或任何改變狀態的操作
以及任何改變商品目錄的操作
用來傳送要求的網址 都可以附加警告參數
當您放置了警告參數
會在連結的結尾以粗體顯示
如果您在要求的結尾置入參數
回應的內容不僅會告知 成功或失敗
也會包含關於某些事項
可能會失敗的警告
或者在我們提出 非必要屬性的建議時
會以警告方式顯示
這個建議
除了警告參數以外
我們也提供試行參數
所謂的試行就是沙箱的概念
顧名思義是預先執行
讓您可以傳送要求
模擬更新資料、進行修改
但實際上並不會插入資料
也不會實際修改任何內容
不過您還是可以收到回應
回應的內容就像您實際送出要求 所得到的回應一樣
但沒有實際發生變更
這比互動式線上示範版更先進
不過原理相同
您可以藉此先測試實作
然後才變更 Merchant Center 中的
商品資料
另一項優良的功能 一般來說對 API 非常有用
不過在此僅適用於商家和零售商
如果您有企業資源計劃 (ERP) 系統
那麼每次新增、插入或變更商品時
您都可以透過 ERP 系統
以程式化方式回應這些動作
並且呼叫 Content API for Shopping
對您在 Google Merchant Center 中的商品目錄進行相似的變更
如此一來,您就可以 讓自己的商品目錄系統與
我們的商品目錄系統隨時 同步保持最新狀態
希望您喜歡今天介紹的內容
如果您有興趣深入瞭解 我們提供一個運作中的
線上社群
這是一個 Google 網上論壇
您只要在 Google 網上論壇 搜尋 Content API for Shopping
就可以找到
這裡也提供您連結
我自己會閱讀論壇上的訊息 我們許多的工程師
也都會使用這個論壇
您隨時都可以在其中搜尋解答
如果有人之前已經提過相同的問題
您就可以找到答案
並且更新自己的實作方式
如果您想尋找特定的支援
請與您的帳戶管理員聯絡
我們另有一些其他解決方案
最後,我自己也負責
維護一些說明文件 隨時都要更新這些文件的內容
讓使用者能夠得到最新的資訊 您可以在我們的網站上找到這些文件:
code.google.com/ api/shopping/content
同樣地,您不必記住這個網址
只要在 Google 搜尋 Content API for Shopping
第一個連結就是了
這是第一筆搜尋結果
最後,如果您要取得 常見問題以外的意見回饋
可以參加一週後 在 11 月 3 日上班時間舉行的
Google+ Hangouts 視訊聚會
我之後也可以提供額外資訊
給使用者
此外,如果您對於這場網路研討會 有任何感想或意見
我們提供了一個連結
只要開啟這個連結: goo.gl/7PjFA
就可以提供與今天的網路研討會
相關的建議與指教
如果大家有任何問題 歡迎提問