- Yêu cầu HTTP
- Tham số đường dẫn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- UpdateOneTimeProductOfferStateRequest
- CancelOneTimeProductOfferRequest
- DeactivateOneTimeProductOfferRequest
- Hãy làm thử!
Cập nhật một loạt trạng thái ưu đãi của sản phẩm tính phí một lần.
Yêu cầu HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchUpdateStates
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Tham số | |
|---|---|
packageName |
Bắt buộc. Ứng dụng mẹ (tên gói) của ưu đãi sản phẩm tính phí một lần đã cập nhật. |
productId |
Bắt buộc. Mã sản phẩm của sản phẩm tính phí một lần chính, nếu tất cả ưu đãi được cập nhật đều thuộc cùng một sản phẩm tính phí một lần. Nếu lần cập nhật theo lô này áp dụng cho nhiều sản phẩm tính phí một lần, hãy đặt trường này thành "-". |
purchaseOptionId |
Bắt buộc. Mã lựa chọn mua của lựa chọn mua chính, nếu tất cả ưu đãi được cập nhật đều thuộc cùng một lựa chọn mua. Nếu nội dung cập nhật theo lô này áp dụng cho nhiều lựa chọn mua, hãy đặt trường này thành "-". |
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:
| Biểu diễn dưới dạng JSON |
|---|
{
"requests": [
{
object ( |
| Trường | |
|---|---|
requests[] |
Bắt buộc. Danh sách yêu cầu cập nhật có tối đa 100 phần tử. Tất cả các yêu cầu phải cập nhật các ưu đãi khác nhau. |
Nội dung phản hồi
Thông báo phản hồi cho offers.batchUpdateStates.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
| Biểu diễn dưới dạng JSON |
|---|
{
"oneTimeProductOffers": [
{
object ( |
| Trường | |
|---|---|
oneTimeProductOffers[] |
Danh sách ưu đãi sản phẩm tính phí một lần đã cập nhật, theo cùng thứ tự như yêu cầu. |
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/androidpublisher
UpdateOneTimeProductOfferStateRequest
Thông báo yêu cầu cập nhật trạng thái của ưu đãi sản phẩm tính phí một lần.
| Biểu diễn dưới dạng JSON |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "activateOneTimeProductOfferRequest": { object ( |
| Trường | |
|---|---|
| Loại chuyển đổi trạng thái cần áp dụng, bạn phải đặt chính xác một loại. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi: | |
activateOneTimeProductOfferRequest |
Kích hoạt ưu đãi. Sau khi được kích hoạt, ưu đãi sẽ được cung cấp cho người dùng, miễn là họ đáp ứng các điều kiện của ưu đãi. |
cancelOneTimeProductOfferRequest |
Huỷ một ưu đãi. Sau khi bị huỷ, ưu đãi sẽ không còn được cung cấp cho người dùng. Mọi đơn đặt hàng đang chờ xử lý liên quan đến ưu đãi này sẽ bị huỷ. Quá trình chuyển đổi trạng thái này chỉ dành riêng cho đơn đặt hàng trước. |
deactivateOneTimeProductOfferRequest |
Huỷ kích hoạt ưu đãi. Sau khi bị huỷ kích hoạt, ưu đãi sẽ không còn được cung cấp cho người dùng nữa. Quá trình chuyển đổi trạng thái này dành riêng cho ưu đãi giảm giá và ưu đãi phần thưởng trong trò chơi. |
| Kết thúc các trường loại trừ lẫn nhau. | |
CancelOneTimeProductOfferRequest
Thông báo yêu cầu cho offers.cancel.
| Biểu diễn dưới dạng JSON |
|---|
{
"packageName": string,
"productId": string,
"purchaseOptionId": string,
"offerId": string,
"latencyTolerance": enum ( |
| Trường | |
|---|---|
packageName |
Bắt buộc. Ứng dụng mẹ (tên gói) của ưu đãi cần huỷ. |
productId |
Bắt buộc. Sản phẩm tính phí một lần gốc (mã nhận dạng) của ưu đãi cần huỷ. |
purchaseOptionId |
Bắt buộc. Lựa chọn mua chính (mã nhận dạng) của ưu đãi cần huỷ. |
offerId |
Bắt buộc. Mã ưu đãi của ưu đãi cần huỷ. |
latencyTolerance |
Không bắt buộc. Độ trễ cho phép đối với việc truyền tải bản cập nhật này. Giá trị mặc định là nhạy cảm với độ trễ. |
DeactivateOneTimeProductOfferRequest
Thông báo yêu cầu cho offers.deactivate.
| Biểu diễn dưới dạng JSON |
|---|
{
"packageName": string,
"productId": string,
"purchaseOptionId": string,
"offerId": string,
"latencyTolerance": enum ( |
| Trường | |
|---|---|
packageName |
Bắt buộc. Ứng dụng mẹ (tên gói) của ưu đãi cần huỷ kích hoạt. |
productId |
Bắt buộc. Sản phẩm tính phí một lần gốc (mã nhận dạng) của ưu đãi cần huỷ kích hoạt. |
purchaseOptionId |
Bắt buộc. Lựa chọn mua chính (mã nhận dạng) của ưu đãi cần huỷ kích hoạt. |
offerId |
Bắt buộc. Mã ưu đãi của ưu đãi cần huỷ kích hoạt. |
latencyTolerance |
Không bắt buộc. Độ trễ cho phép đối với việc truyền tải bản cập nhật này. Giá trị mặc định là nhạy cảm với độ trễ. |