如要有效使用 Merchant API,請務必瞭解註冊、驗證和授權的概念。兩者用途不同,但都能確保 Merchant Center 資料存取安全無虞。
術語
註冊、驗證和授權彼此相關,但各有不同的意義和目的。
- 驗證:在這個程序中,服務會驗證提出 API 要求的使用者或應用程式身分。Merchant API 採用標準 Google 機制,例如 OAuth 2.0。不支援使用 API 金鑰進行驗證,否則會導致驗證錯誤。詳情請參閱「驗證要求」和「以自己的帳戶身分進行驗證」。
- 授權:這項程序會決定通過驗證的使用者或應用程式,可使用 Merchant Center 帳戶執行哪些動作。這項資訊會根據 Merchant Center 帳戶中授予已驗證使用者的角色和權限,回答「你可以做什麼?」的問題。舉例來說,使用者可能有權讀取產品資料,但無法修改帳戶設定。
- 註冊:就 Merchant API 而言,這是一次性設定程序,可讓 Google 針對您管理的商家帳戶,傳送重要服務公告。註冊後,系統會將開發人員電子郵件地址新增至主要 Merchant Center 帳戶,並連結至用於驗證的 Google Cloud 專案 ID。建立連結後,應用程式就能接收您管理的所有商家帳戶服務公告。詳情請參閱「建立 Google Cloud 專案」。
註冊
註冊程序至關重要,可讓應用程式使用 Merchant API。以下是一些注意事項:
必要條件
如要註冊使用 Merchant API,必須具備下列項目:
- Merchant Center 帳戶:您必須擁有 Merchant Center 帳戶。
- 管理員存取權:您用來發起註冊呼叫的 Google 使用者帳戶,必須具備要註冊的 Merchant Center 帳戶管理員權限。
- Google Cloud 專案:應用程式必須與 Google Cloud 專案建立關聯。這項專案會提供必要的憑證 (例如 OAuth 2.0 用戶端 ID),供應用程式驗證。
為何無法註冊共用的 Google Cloud 雲端專案
Google OAuth Playground 和 APIs Explorer 等工具會使用 Google 擁有的共用 Google Cloud 專案。您無法使用共用專案註冊,原因如下:
- 僅供測試和探索,不適用於正式環境應用程式身分。
- 如果註冊,就表示共用工具與特定 Merchant Center 資料之間有連結,可能會導致不必要的通訊。
應用程式需要專屬的 Google Cloud 專案,Google 傳送的 Merchant API 通訊內容才會與實際用量相關。
不過,您可以使用 OAuth Playground 和 API Explorer 網頁應用程式,將 Merchant API 用於實驗和非正式環境。
找出 Google Cloud 專案 ID
您可以在 Google Cloud 控制台中找到專案 ID 和專案編號。詳情請參閱「尋找專案名稱、編號和 ID」。
撥打註冊電話
請使用 Accounts 子 API 中的 registerGcp 方法註冊。這項呼叫會將 Google Cloud 專案編號與 Merchant Center 帳戶建立關聯。
在過程中,請提供與您用來呼叫 API 的個別使用者相關聯的電子郵件地址。這個電子郵件地址必須屬於具備 Merchant Center 帳戶管理員存取權的使用者。
關於「email」欄位
有效溝通是關鍵。Google 會傳送重要更新、必要服務公告 (MSA)、開發人員問卷調查,以及其他與 Merchant API 相關的機會。妥善管理聯絡人,可確保這些通知能傳達給正確的人員。
- 用途:Google 會使用這個電子郵件地址做為 API 相關通訊的主要聯絡人。
- 電子郵件地址擁有者:這應是個別開發人員或負責 API 整合的主要技術聯絡人的電子郵件地址。
- 最佳做法:
- 建議做法:使用個人的公司電子郵件地址。
- 請勿:使用一般群組別名或服務帳戶電子郵件地址。我們希望通訊內容是由真人接收。
用於管理聯絡人的 users 資源
雖然註冊呼叫中的電子郵件地址會設定初始聯絡人,但管理聯絡人和權限更穩健的方式,是使用 Merchant API accounts.users 資源,或 Merchant Center UI 中的使用者管理設定。如要進一步瞭解如何使用 Merchant Center,請參閱「管理帳戶使用者」。
善用這些功能的方式如下:
- 新增所有開發人員:將負責 API 整合的開發人員新增為 Merchant Center 帳戶的使用者。
- 指派
API_DEVELOPER角色:除了標準角色 (「管理員」、「標準」) 外,您也可以指派API_DEVELOPER角色給使用者。請特別將這個角色指派給應接收 API 相關通訊的使用者。您可以將其與其他角色結合。 - 優點:
- 明確區隔:將 API 聯絡人管理與一次性註冊作業分開。
- 彈性:團隊成員異動時,可更新聯絡人。
- 指定通訊對象:確保 API 相關新聞能傳達給相關人員。
即使您在註冊時提供了電子郵件地址,我們仍強烈建議您新增具備 API_DEVELOPER 角色的使用者,以便管理 API 聯絡人。
參考資料
如要瞭解詳情,請參考下列資源: