「Apple 商務」品牌 API 存取權限

你可以允許第三方合作夥伴，透過「Apple 商務」品牌 API（不包括裝置、預設集和設定 API）來管理「Apple 商務」中的品牌。

使用「Apple 商務」品牌 API 提交標誌和封面照片

若要透過「Apple 商務」品牌 API 套用封面照片和標誌，機構與第三方合作夥伴都需要註冊「Apple 商務」，且機構必須成功將管理權限委派給第三方合作夥伴。請參閱〈透過合作夥伴機構 ID 與第三方合作夥伴共享你的內容〉。

使用「Apple 商務」品牌 API 建立展示卡

若要使用「Apple 商務」品牌 API 建立展示卡，機構與第三方合作夥伴都需要註冊「Apple 商務」，且機構必須成功將管理權限委派給第三方合作夥伴。請參閱〈透過合作夥伴機構 ID 與第三方合作夥伴共享你的內容〉。

如需瞭解展示卡的視覺元素和設定（例如 CTA、標題和正文內容、照片，以及視障者專用的替代文字），請登入並查看「展示卡創意」。若要查看發佈狀態並設定時間範圍、資源詳細資訊與 ID，請登入並查看展示卡。

服務帳號

服務帳號是一種特殊類型的帳號，專門用於代表特定系統，使其能透過身分驗證並獲得授權，進而存取「Apple 商務」品牌 API。

你可以讓開發者透過 Apple 提供的品牌 API 連線到「Apple 商務」。若要為服務帳號申請存取權限，你須為經 Apple 核准的第三方合作夥伴的「機構管理員」或「行銷管理員」。

檢視《API Onboarding Guide》（API 入門指南）

在「Apple 商務」中，以具備「機構管理員」或「行銷管理員」職務的使用者身分登入。
若要檢視職務與權限，請參閱〈職務與權限簡介〉。
在你的瀏覽器中，依序選擇「設定」>「整合」>「API」。
選取「API 存取權限」旁的選項以查看《API Onboarding Guide》（API 入門指南）。
你現在可以要求 API 存取權，並與你的 Apple 業務代表合作。

申請品牌 API 存取權限

在「Apple 商務」中，以具備「機構管理員」或「行銷管理員」職務的使用者身分登入。
若要檢視職務與權限，請參閱〈職務與權限簡介〉。
在你的瀏覽器中，依序選擇「設定」>「整合」>「API」。
選取「要求 API 存取權」，然後選擇以下任一項目：
- 商品目錄管理
- 銷售點軟體
- 審查管理
- 行銷
- 報導內容
- 其他
選取「下一步」，然後回答問題：
- 你是否直接與設有實體地點的業主合作？
- 誰是主要客戶？
選取「下一步」，然後選擇資料類型並輸入總數。
選取「傳送要求」。
Apple 將審查該要求。審查完成後，你會收到電子郵件通知。

建立服務帳號

在「Apple 商務」中，以具備「機構管理員」或「行銷管理員」職務的使用者身分登入。
若要檢視職務與權限，請參閱〈職務與權限簡介〉。
在你的瀏覽器中，依序選擇「設定」>「整合」>「API」。
選取「API 整合」旁的。
如有需要，你可以手動新增一名新使用者來擔任「服務帳號」職務。請參閱〈手動新增使用者〉。
選取「新增服務帳號」。
提供服務名稱、團隊聯絡資訊，並設定服務帳號的職務權限：「讀取與寫入」或「唯讀」。
選取「新增」。
畫面上會顯示該服務帳號的用戶端 ID 和用戶端密鑰。
請拷貝這些資訊並保存在安全的地方。
【重要事項】如果你在未拷貝用戶端密鑰的情況下關閉此視窗，你需要重新產生新的密鑰。
選取「完成」。
你已成功建立服務帳號。

驗證 API 整合

在「Apple 商務」中，以具備「機構管理員」或「行銷管理員」職務的使用者身分登入。
若要檢視職務與權限，請參閱〈職務與權限簡介〉。
在你的瀏覽器中，依序選擇「設定」>「整合」>「API」。
依序選取「API 整合」和「驗證 API 整合」，然後按一下「傳送」。
具備下列職務的使用者將在審查完成時收到電子郵件：
- 機構管理員
- 行銷管理員
- 服務帳號

驗證 API 資料品質

在 API 整合驗證完成之後，你就可以驗證資料品質。

在「Apple 商務」中，以具備「機構管理員」或「行銷管理員」職務的使用者身分登入。
若要檢視職務與權限，請參閱〈職務與權限簡介〉。
在你的瀏覽器中，依序選擇「設定」>「整合」>「API」。
選取「資料資格條件」旁的。
選擇下列其中一項操作：
- 選取現有的服務帳號。
- 選取「新增服務帳號」。請參閱〈建立服務帳號〉。
選取「驗證資料品質」，然後選取「傳送」。
具備下列職務的使用者將在審查完成時收到電子郵件：
- 機構管理員
- 行銷管理員
- 服務帳號

將內容發佈到實際運作環境

使用「品牌和地點」API 將你的資料提交至實際運作環境，以在「地圖」和整個 Apple 系統中顯示。

在「Apple 商務」中，以具備「機構管理員」或「行銷管理員」職務的使用者身分登入。
若要檢視職務與權限，請參閱〈職務與權限簡介〉。
在你的瀏覽器中，依序選擇「設定」>「整合」>「API」。
選取「實際運作環境」旁的。
選擇下列其中一項操作：
- 選取現有的服務帳號。
- 選取「新增服務帳號」。請參閱〈建立服務帳號〉。
選取你的 API。

移除服務帳號

在「Apple 商務」中，以具備「機構管理員」或「行銷管理員」職務的使用者身分登入。
若要檢視職務與權限，請參閱〈職務與權限簡介〉。
在你的瀏覽器中，依序選擇「設定」>「整合」>「API」。
選取「API 整合」。
在想要移除的服務帳號旁選取「編輯」。
選取「移除」，然後選取「移除」。
服務帳號會被移除，且其與「Apple 商務」之間所有相關的 API 連線也會一併撤銷。

也請參閱「Apple 商務」對於照片和文字的標準與規範在「Apple 商務」中建立第三方合作夥伴動作在「Apple 商務」中設定地點屬性

有幫助？