自訂應用程式
自訂應用程式是由您或開發人員專為您的 Shopify 商店所建立的應用程式 (有別於為許多商店打造的公開應用程式)。您可以使用自訂應用程式在 Shopify 管理介面新增功能、直接使用 Shopify API 存取商店資料,或使用 Storefront API 將網路商店拓展至其他平台。
建立自訂應用程式需要相關開發知識,且可能充滿挑戰。如需為商店打造自訂應用程式的相关協助,可以聘僱 Shopify 合作夥伴。深入瞭解如何聘僱 Shopify 合作夥伴。
如果您希望協作者或員工帳戶建立、編輯或刪除自訂應用程式,您可以授予其開發應用程式許可權。協作者或員工帳戶也必須擁有相關許可權,才能設定特定的 API 範圍。
此頁面上
自訂第 2 級 PII 應用程式
權限用於控制應用程式在執行功能時,可以存取或修改您商店中的哪些資訊類型。
個人識別資訊 (PII) 是一種單獨或組合資訊,可提供識別個人身分的獨特方式。您從 Shopify App Store 安裝應用程式後,若該應用程式使用您商店、顧客、訂單或其他業務資料的相關資訊,便可存取不同類型的 PII。若要存取自訂第 2 級 PII 應用程式,您的商店必須採用 Shopify 方案或更高級方案。
透過 Shopify 管理介面來啟用自訂應用程式開發功能
您必須啟用自訂應用程式開發功能,才能為商店建立自訂應用程式。您必須是擁有啟用應用程式開發權限的商店擁有人或員工,才能啟用自訂應用程式開發功能。
步驟:
在 Shopify 管理介面中,點擊「設定」>「應用程式和銷售管道」。
點擊「開發應用程式」。
點擊允許自訂應用程式開發。
讀取提供的提醒和資訊,然後點擊允許自訂應用程式開發。
建立並安裝自訂應用程式
啟用自訂應用程式開發功能後,您可以在 Shopify 管理介面中建立並安裝自訂應用程式。您必須設定 API 範圍,以決定自訂應用程式可以存取的商店部分。安裝應用程式後,您會收到應用程式能透過 Shopify API 存取您商店資訊的存取憑證。
擁有相關許可權的商店擁有人、協作者及員工可以建立和安裝自訂應用程式。
建立應用程式
在 Shopify 管理介面中,點擊「設定」>「應用程式和銷售管道」。
點擊「開發應用程式」。
點擊建立自訂應用程式。
在互動視窗中,輸入應用程式名稱並選擇應用程式開發人員。應用程式開發人員可以是商店擁有人,或任何具有開發應用程式許可權的員工或協作者帳戶。
點擊建立應用程式。
選擇 API 範圍
建立自訂應用程式後,您可以為其指派 API 範圍。視自訂應用程式的要求,其可能具有管理介面 API 範圍、Storefront API 範圍,或兩者皆有。必須至少選取一個範圍才能安裝應用程式。
步驟:
- 點擊選取範圍。
-
在管理員 API 存取範圍區段,選擇要指派給應用程式的 API 範圍。
- 選用:設定您想要用於 Webhook 訂閱的 API 版本。
- 選用:您可以設定Google Cloud Pub/Sub來處理應用程式的 Webhook 訂閱。在 Google Cloud Pub/Sub 區段,複製您的 Shopify 服務帳號地址,將其用來設定 Google Cloud Pub/Sub 帳號。
- 選用:您可以設定 Amazon EventBridge 來處理應用程式的 Webhook 訂閱。在 Amazon EventBridge 區段中,點擊「建立來源」。
在 Storefront API 存取範圍區段,選擇要指派給應用程式的 API 範圍。
點擊「儲存」。
安裝應用程式並取得 API 存取憑證
為應用程式設定 API 範圍後,您即可以安裝該應用程式。您將在安裝後取得 API 存取憑證。視您指派給應用程式的 API 範圍不同,您將取得管理員 API 存取憑證、Storefront API 存取憑證或兩者皆有。
步驟:
- 按一下「安裝應用程式」。
- 在互動視窗中,點擊「安裝應用程式」。
- 取得存取憑證:
- 如果您為應用程式選擇管理介面 API 範圍,請前往「管理介面 API 存取憑證」區段,然後點擊「顯示憑證一次」。此頁面在使用者首次存取時會顯示完整存取憑證,但對於後續造訪只會顯示存取憑證末 4 碼以供參考。
- 若您為應用程式選取了 Storefront API 範圍,則您可以前往 Storefront API 存取憑證區段複製您的憑證。與管理員 API 存取憑證不同,此頁面會持續提供 Storefront API 存取憑證。
取得自訂應用程式的 API 憑證
您可以在應用程式的「API 憑證」頁面查看自訂應用程式的 Storefront 存取憑證、API 金鑰和 API 密鑰。您也可以檢查管理介面 API 存取憑證,但唯有首次存取此頁面時會看見存取憑證,之後造訪便只能查看憑證的末四碼。
在 Shopify 管理介面中,點擊「設定」>「應用程式和銷售管道」。
點擊「開發應用程式」。
點擊要取得憑證的應用程式名稱。
點擊 API 憑證。
更新自訂應用程式的管理介面 API 範圍
如果您是商店擁有人、協作者或具有相關許可權的員工,則可以更新自訂應用程式的範圍。
在 Shopify 管理介面中,點擊「設定」>「應用程式和銷售管道」。
點擊「開發應用程式」。
點擊您要更新的應用程式名稱。
點擊設定。
-
在管理員 API 整合區段,點擊「編輯」。
- 如果您之前未指派任何管理員 API 範圍,請點擊「設定」。
選取要指派給應用程式的範圍。
選用:設定您想要用於 Webhook 訂閱的 API 版本。
選用:您可以設定 Google Cloud Pub/Sub 來處理應用程式的 Webhook 訂閱。在 Google Cloud Pub/Sub 區段,複製您的 Shopify 服務帳號地址,將其用來設定 Google Cloud Pub/Sub 帳號。
選用:您可以設定 Amazon EventBridge 來處理應用程式的 Webhook 訂閱。在 Amazon EventBridge 區段中,點擊「建立來源」。
點擊「儲存」。
如果應用程式已安裝於商店中,則您必須選擇至少一個範圍,或已為該應用程式指派 Storefront API 範圍,否則無法點擊「儲存」。
更新自訂應用程式的 Storefront API 存取範圍
如果您是商店擁有人、協作者或具有相關許可權的員工,則可以更新自訂應用程式的範圍。
在 Shopify 管理介面中,點擊「設定」>「應用程式和銷售管道」。
點擊「開發應用程式」。
點擊您要更新的應用程式名稱。
點擊設定。
-
在 Storefront API 整合區段,點擊「編輯」。
- 如果您之前未指派任何 Storefront API 範圍,請點擊「設定」。
選取要指派給應用程式的範圍。
-
選用:如果您的應用程式與 iOS Buy 軟體開發套件 (SDK) 整合,您就可以在「iOS Buy SDK」區段進行必要變更。只有在已安裝應用程式時,您才能在此區段進行變更。
- 請參閱 iOS Buy SDK 開發人員說明文件,瞭解更多詳細資訊。
-
選用:如果您的應用程式與 Android Buy SDK 整合,您可以在 Android Buy SDK 區段進行必要變更。只有在已安裝應用程式時,您才能在此區段進行變更。
- 請參閱 Android Buy SDK 開發人員說明文件,瞭解更多詳細資訊。
點擊「儲存」。
如果應用程式已安裝於商店中,則您必須選擇至少一個範圍,或已為該應用程式指派 Storefront API 範圍,否則無法點擊「儲存」。
更新自訂應用程式的設定
您可以更新應用程式的名稱與說明,以及應用程式開發人員。
如果您將應用程式開發人員設定為員工或協作者帳戶,然後稍後再刪除該帳號,則商店擁有人會預設為應用程式開發人員。
在 Shopify 管理介面中,點擊「設定」>「應用程式和銷售管道」。
點擊「開發應用程式」。
點擊您要更新的應用程式名稱。
點擊「應用程式設定」。
若要變更名稱或說明,請輸入新的應用程式名稱或應用程式說明。
若要變更與應用程式相關聯的應用程式開發人員,請選取「主要應用程式開發人員」。
選用:若要通知其他電子郵件地址有關此應用程式的開發更新資訊,請在「開發更新內容聯絡人」下方輸入電子郵件地址。
點擊「儲存」。
解除安裝自訂應用程式
解除安裝自訂應用程式後,管理介面和 Storefront API 存取憑證將遭到撤銷,任何於應用程式註冊的 Webhook 和出貨服務也會遭移除,而您的應用程式也無法存取商店資料。如果您重新安裝應用程式,將獲得新的存取憑證。
在 Shopify 管理介面中,點擊「設定」>「應用程式和銷售管道」。
點擊「開發應用程式」。
點擊您要解除安裝的應用程式名稱。
按一下「解除安裝應用程式」。
刪除自訂應用程式
自訂應用程式一經刪除便無法復原。如果您想要暫時停用商店中的應用程式而不刪除應用程式,請解除安裝該應用程式。
在 Shopify 管理介面中,點擊「設定」>「應用程式和銷售管道」。
點擊「開發應用程式」。
點擊「應用程式設定」。
點擊「刪除應用程式」。
自訂應用程式的 API 範圍許可權
協作者和員工帳號只有在帳號擁有開發應用程式權限,以及與他們設定的 API 範圍相關的其他員工權限的情況下,才能為自訂應用程式設定 API 範圍。
您應向應用程式開發人員諮詢,決定自訂應用程式需要哪些帳號許可權和 API 範圍才能運作。請確保您瞭解授予開發人員的許可權範圍,且對該範圍感到安心自在。