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

你可以讓第三方合作夥伴透過 Apple 提供的 API 管理品牌。

使用「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 商務」中設定地點屬性

有幫助？