編輯

您可以透過 Google Play Developer Publishing API 編輯方法準備 Google Play 應用程式的多項變更，然後一次部署這些變更。做法是建立編輯，其中包含您想要對應用程式進行的所有變更。編輯內容會保存下列資訊：

• 與應用程式相關聯的 APK，以及每個 APK 的「軌跡」。

  每個群組都與一個「軌跡」相關聯，用於決定哪些使用者會看到。此可讓您為測試人員提供 Alpha 和 Beta 版的應用程式版本。此外，您可以提供限量推出的「階段推出」應用程式版本；這個應用程式會自動提供給少數應用程式使用者 (取決於您設定的推出百分比)，讓您可以逐步部署新的正式版應用程式。

• Google Play 商店資訊的應用程式語言和地區專屬版本

  每個地區版本的商店資訊可包含螢幕截圖和其他宣傳圖片，以及本地化說明文字等。

注意：並非所有 Google Play Developer API 提供的方法都會使用新的交易式「編輯」功能。無論應用程式有無編輯編輯內容，inappproducts、products 和 subscriptions 資源的方法會立即生效。每項資源的 API 參考資料頁面都會明確註記該資源的方法是否使用「quot;edits"模型」。

第一次編輯時，編輯是指應用程式目前部署狀態的副本。接著，您可以呼叫編輯方法來修改編輯內容。當編輯內容準備就緒時，就可以提交變更內容，並使變更生效。您也可以隨時捨棄編輯內容，捨棄變更並離開應用程式。

您只能使用這個 API 變更「現有」應用程式 (已上傳至少一個 APK)；因此，您必須透過 Play 管理中心上傳至少一個 APK，才能使用這個 API。此外，您無法使用這個 API 將應用程式狀態從「已發布」改為「未發布」，也無法填寫發布所需的法律同意聲明。請使用 Play 管理中心發布應用程式。

注意：如果在編輯作業期間，任何人透過 Google Play 管理中心對應用程式進行任何變更，系統會捨棄您的編輯，Play 管理中心變更也會生效。

工作流程

本節說明您將使用 Google Play Developer Publishing API 編輯方法的一般修改應用程式。

1. 呼叫 Edits: Insert 並指定要修改的應用程式，即可建立新的編輯內容。

   這項操作會針對指定應用程式建立新的編輯內容。應用程式的初始設定 (APK、商店資訊、擴充檔案等) 會從已部署的應用程式版本複製。

2. 視需要修改內容。

   您可以透過 Google Play 管理中心進行大部分變更。方法是呼叫適當的 Google Play Developer API 方法，並傳遞要修改的應用程式 ID 並進行編輯。詳細說明：

   • 您可以呼叫 Edits.apks: upload 上傳新的 APK。這樣做會將 APK 儲存在儲存空間區域，因此您可以將 APK 指派至這個版本或後續編輯中的測試群組。
   • 您可以呼叫 Edits.tracks: update，將 APK 指派給測試群組。您也可以呼叫 Edits.tracks:patch，變更現有 APK 的測試群組指派情形。
   • 您可以呼叫 Edits.listings: update 來建立新的本地化商店資訊。您可以透過呼叫 Edits.listings: 修補程式，修改現有的商店資訊。
   • 您可以呼叫 Edits.expansionfiles 資源方法來新增或修改擴充檔案。

   這些方法會變更您正在進行的編輯，但「不會」修改應用程式的使用中版本。您可以在不影響使用者體驗的情況下，進行更多變更或捨棄進行中的編輯作業。

   注意：每位使用者一次只能開啟一項編輯內容。建立新的編輯內容後，系統可能會開啟所有目前開啟的編輯內容。此外，如果有人透過 Play 管理中心提交編輯內容或變更應用程式，所有其他應用程式 (由任何使用者擁有) 的編輯內容都會失效。如果您嘗試修訂無效的編輯，作業將擲回例外狀況且沒有任何效果。

3. 修訂編輯內容。

   當您呼叫 Edits: Commit 時，如果沒有任何驗證錯誤，則編輯資源中指定的所有變更都會變為「Live」(立即) 取代應用程式目前的狀態。這些變更可能需要數小時才會生效，就像您透過 Play 管理中心進行變更時一樣。