Phương thức chỉnh sửa của API Phát hành dành cho nhà phát triển Google Play cho phép bạn chuẩn bị một số thay đổi cho ứng dụng của mình trên Google Play, sau đó triển khai tất cả các thay đổi đó cùng một lúc. Bạn thực hiện việc này bằng cách tạo một nội dung chỉnh sửa, trong đó chứa tất cả các thay đổi mà bạn muốn thực hiện đối với ứng dụng. Nội dung chỉnh sửa này chứa những thông tin như:
Những APK nào được liên kết với ứng dụng và "kênh" cho từng APK.
Mỗi bản phát hành được liên kết với một "kênh", xác định những người dùng nhìn thấy bản phát hành đó. Điều này cho phép bạn cung cấp các phiên bản alpha và beta của ứng dụng cho người kiểm thử. Ngoài ra, bạn có thể cung cấp một phiên bản "phát hành theo giai đoạn" phát hành có giới hạn của ứng dụng; ứng dụng này sẽ tự động được phân phối cho một số lượng người dùng có giới hạn của ứng dụng (do tỷ lệ phát hành mà bạn đặt quyết định), cho phép bạn triển khai dần một phiên bản phát hành công khai mới của ứng dụng.
Các phiên bản theo ngôn ngữ và ngôn ngữ địa phương cụ thể của trang thông tin ứng dụng trên Cửa hàng Google Play
Mỗi phiên bản trang thông tin trên Cửa hàng Play theo ngôn ngữ cụ thể có thể chứa ảnh chụp màn hình và các hình ảnh đồ hoạ quảng bá khác, văn bản mô tả đã bản địa hoá, v.v.
Khi bạn tạo một bản chỉnh sửa lần đầu tiên, bản chỉnh sửa đó sẽ là bản sao của trạng thái triển khai hiện tại của ứng dụng. Sau đó, bạn có thể sửa đổi bản chỉnh sửa bằng cách gọi các phương thức Chỉnh sửa. Khi nội dung chỉnh sửa đã sẵn sàng, bạn sẽ xác nhận nội dung đó để các thay đổi có hiệu lực. Bạn cũng có thể huỷ chỉnh sửa bất cứ lúc nào, loại bỏ các thay đổi và giữ nguyên ứng dụng.
Bạn chỉ có thể dùng API này để thay đổi một ứng dụng hiện có (đã tải lên ít nhất một APK); do đó, bạn sẽ phải tải lên ít nhất một APK thông qua Play Console trước khi có thể dùng API này. Ngoài ra, bạn không thể dùng API này để thay đổi trạng thái của ứng dụng từ "đã xuất bản" thành "chưa xuất bản" hoặc để điền vào các biểu mẫu đồng ý theo pháp luật cần thiết để xuất bản. Để xuất bản ứng dụng, bạn phải sử dụng Play Console.
Luồng công việc
Phần này trình bày cách thông thường mà bạn sẽ sử dụng phương thức chỉnh sửa của API phát hành dành cho nhà phát triển Google Play để sửa đổi một ứng dụng.
Tạo một nội dung chỉnh sửa mới bằng cách gọi Edits: Insert và chỉ định ứng dụng mà bạn muốn sửa đổi.
Thao tác này sẽ tạo một bản chỉnh sửa mới cho ứng dụng được chỉ định. Tất cả các chế độ cài đặt ban đầu của ứng dụng (APK, trang thông tin trên Cửa hàng Play, tệp mở rộng, v.v.) đều được sao chép từ phiên bản đã triển khai của ứng dụng.
Chỉnh sửa theo ý muốn.
Bạn có thể thực hiện hầu hết các thay đổi có thể thực hiện thông qua Google Play Console. Bạn thực hiện việc này bằng cách gọi phương thức API Nhà phát triển Google Play thích hợp và truyền mã nhận dạng của ứng dụng và nội dung chỉnh sửa mà bạn muốn sửa đổi. Cụ thể:
- Bạn có thể tải APK mới lên bằng cách gọi Edits.apks: upload. Thao tác này sẽ đặt APK vào một vùng lưu trữ để bạn có thể chỉ định APK cho một kênh trong lần chỉnh sửa này hoặc lần chỉnh sửa tiếp theo.
- Bạn có thể chỉ định APK cho các kênh phát hành bằng cách gọi Edits.tracks: update. Bạn cũng có thể thay đổi việc chỉ định kênh cho các APK hiện có bằng cách gọi Edits.tracks: patch.
- Bạn có thể tạo một trang thông tin mới trên Cửa hàng Play bằng cách gọi Edits.listings: update. Bạn có thể sửa đổi trang thông tin hiện có trên Cửa hàng bằng cách gọi Edits.listings: patch.
- Bạn có thể thêm hoặc sửa đổi tệp mở rộng bằng cách gọi các phương thức Edits.expansionfiles resource.
Các phương thức này sẽ thay đổi nội dung chỉnh sửa mà bạn đang thực hiện, nhưng không sửa đổi phiên bản đang hoạt động của ứng dụng. Bạn có thể thực hiện các thay đổi khác hoặc loại bỏ nội dung chỉnh sửa đang thực hiện mà không ảnh hưởng đến trải nghiệm người dùng.
Cam kết nội dung chỉnh sửa.
Khi bạn gọi Edits: commit, nếu không có lỗi xác thực nào, thì tất cả các thay đổi được chỉ định trong tài nguyên chỉnh sửa sẽ có hiệu lực, thay thế trạng thái hiện tại của ứng dụng. Những thay đổi này có thể mất vài giờ để có hiệu lực, giống như khi bạn thực hiện thay đổi thông qua Play Console.