- 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
- UpdateSubscriptionOfferStateRequest
- ActivateSubscriptionOfferRequest
- DeactivateSubscriptionOfferRequest
- Hãy làm thử!
Cập nhật một loạt trạng thái ưu đãi của gói thuê bao.
Đặt trường độ trễTolerance trên các yêu cầu lồng nhau thành PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT để đạt được thông lượng cập nhật tối đa.
Yêu cầu HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers:batchUpdateStates
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Thông số | |
---|---|
packageName |
Bắt buộc. Ứng dụng gốc (tên gói) của ưu đãi gói thuê bao đã cập nhật. Phải bằng với trường packageName trên tất cả các tài nguyên SubscriptionOffer đã cập nhật. |
productId |
Bắt buộc. Mã sản phẩm của gói thuê bao chính, trong trường hợp tất cả ưu đãi cập nhật đều thuộc về cùng một gói thuê bao. Nếu yêu cầu này áp dụng cho nhiều gói thuê bao, hãy đặt trường này thành "-". Bạn phải đặt trường này. |
basePlanId |
Bắt buộc. Gói cơ bản (mã nhận dạng) chính mà bạn cần cập nhật ưu đãi. Có thể được chỉ định là "-" để cập nhật ưu đãi từ nhiều gói cơ bản. |
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{
"requests": [
{
object ( |
Các trường | |
---|---|
requests[] |
Bắt buộc. Danh sách yêu cầu cập nhật gồm tối đa 100 phần tử. Tất cả các yêu cầu phải cập nhật ưu đãi khác nhau. |
Nội dung phản hồi
Thông báo phản hồi cho offer.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 |
---|
{
"subscriptionOffers": [
{
object ( |
Các trường | |
---|---|
subscriptionOffers[] |
Danh sách ưu đãi mới cho gói thuê bao. |
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/androidpublisher
UpdateSubscriptionOfferStateRequest
Thông báo Yêu cầu cập nhật trạng thái của ưu đãi cho gói thuê bao.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Các trường | |
---|---|
Trường nhóm state_transition_type . Loại chuyển đổi trạng thái cần áp dụng, phải đặt đúng một loại. state_transition_type chỉ có thể là một trong những trạng thái sau đây: |
|
activateSubscriptionOfferRequest |
Kích hoạt ưu đãi. Sau khi kích hoạt, ưu đãi sẽ dành cho người đăng ký mới. |
deactivateSubscriptionOfferRequest |
Huỷ kích hoạt ưu đãi. Sau khi bị vô hiệu hoá, người đăng ký mới sẽ không sử dụng được ưu đãi này, nhưng những người đăng ký hiện tại sẽ vẫn duy trì gói thuê bao đó |
ActivateSubscriptionOfferRequest
Thông báo yêu cầu cho ActivateSubscriptionOffer.
Biểu diễn dưới dạng JSON |
---|
{
"packageName": string,
"productId": string,
"basePlanId": string,
"offerId": string,
"latencyTolerance": enum ( |
Các trường | |
---|---|
packageName |
Bắt buộc. Ứng dụng gốc (tên gói) của ưu đãi để kích hoạt. |
productId |
Bắt buộc. Gói thuê bao chính (mã nhận dạng) của ưu đãi để kích hoạt. |
basePlanId |
Bắt buộc. Mã cơ bản (mã) chính của ưu đãi dùng để kích hoạt. |
offerId |
Bắt buộc. Mã ưu đãi duy nhất của ưu đãi bạn muốn kích hoạt. |
latencyTolerance |
Không bắt buộc. Dung sai về độ trễ khi truyền bản cập nhật sản phẩm này. Giá trị mặc định là phụ thuộc vào độ trễ. |
DeactivateSubscriptionOfferRequest
Yêu cầu tin nhắn cho offer.deactivate.
Biểu diễn dưới dạng JSON |
---|
{
"packageName": string,
"productId": string,
"basePlanId": string,
"offerId": string,
"latencyTolerance": enum ( |
Các trường | |
---|---|
packageName |
Bắt buộc. Ứng dụng gốc (tên gói) của ưu đãi để huỷ kích hoạt. |
productId |
Bắt buộc. Gói thuê bao chính (Mã nhận dạng) của ưu đãi để huỷ kích hoạt. |
basePlanId |
Bắt buộc. Gói cơ bản (mã nhận dạng) chính của ưu đãi để huỷ kích hoạt. |
offerId |
Bắt buộc. Mã ưu đãi duy nhất của ưu đãi để huỷ kích hoạt. |
latencyTolerance |
Không bắt buộc. Dung sai về độ trễ khi truyền bản cập nhật sản phẩm này. Giá trị mặc định là phụ thuộc vào độ trễ. |