Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdateStates

Aktualizuje stan zbioru ofert na produkty kupowane raz.

Żądanie HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchUpdateStates

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
packageName

string

Wymagane. Aplikacja nadrzędna (nazwa pakietu) zaktualizowanych ofert na produkty kupowane raz.

productId

string

Wymagane. Identyfikator produktu nadrzędnego produktu kupowanego raz, jeśli wszystkie zaktualizowane oferty należą do tego samego produktu kupowanego raz. Jeśli ta aktualizacja zbiorcza obejmuje wiele produktów kupowanych raz, ustaw to pole na „-”.

purchaseOptionId

string

Wymagane. Identyfikator nadrzędnej opcji zakupu, jeśli wszystkie zaktualizowane oferty należą do tej samej opcji zakupu. Jeśli ta aktualizacja zbiorcza obejmuje wiele opcji zakupu, ustaw to pole na „-”.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "requests": [
    {
      object (UpdateOneTimeProductOfferStateRequest)
    }
  ]
}
Pola
requests[]

object (UpdateOneTimeProductOfferStateRequest)

Wymagane. Lista żądań aktualizacji zawierająca maksymalnie 100 elementów. Wszystkie żądania muszą aktualizować różne oferty.

Treść odpowiedzi

Komunikat odpowiedzi dla offers.batchUpdateStates.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "oneTimeProductOffers": [
    {
      object (OneTimeProductOffer)
    }
  ]
}
Pola
oneTimeProductOffers[]

object (OneTimeProductOffer)

Zaktualizowana lista ofert na produkty kupowane raz w tej samej kolejności co w żądaniu.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/androidpublisher

UpdateOneTimeProductOfferStateRequest

Komunikat żądania aktualizacji stanu oferty produktu kupowanego raz.

Zapis JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "activateOneTimeProductOfferRequest": {
    object (ActivateOneTimeProductOfferRequest)
  },
  "cancelOneTimeProductOfferRequest": {
    object (CancelOneTimeProductOfferRequest)
  },
  "deactivateOneTimeProductOfferRequest": {
    object (DeactivateOneTimeProductOfferRequest)
  }
  // End of mutually exclusive fields.
}
Pola
Typ przejścia stanu do zastosowania. Musi być ustawiony dokładnie jeden. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
activateOneTimeProductOfferRequest

object (ActivateOneTimeProductOfferRequest)

Aktywuje ofertę. Po aktywacji oferta jest dostępna dla użytkowników, o ile spełniają oni jej warunki.

cancelOneTimeProductOfferRequest

object (CancelOneTimeProductOfferRequest)

Anuluje ofertę. Po anulowaniu oferta nie będzie już dostępna dla użytkowników. Wszystkie oczekujące zamówienia powiązane z tą ofertą zostaną anulowane. Ta zmiana stanu dotyczy tylko zamówień w przedsprzedaży.

deactivateOneTimeProductOfferRequest

object (DeactivateOneTimeProductOfferRequest)

Dezaktywuje ofertę. Po dezaktywowaniu oferta nie będzie już dostępna dla użytkowników. Ta zmiana stanu dotyczy ofert rabatowych i nagród w grze.

Koniec pól wykluczających się wzajemnie.

CancelOneTimeProductOfferRequest

Wiadomość z prośbą o offers.cancel.

Zapis JSON
{
  "packageName": string,
  "productId": string,
  "purchaseOptionId": string,
  "offerId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
Pola
packageName

string

Wymagane. Aplikacja nadrzędna (nazwa pakietu) oferty, którą chcesz anulować.

productId

string

Wymagane. Nadrzędny produkt kupowany raz (identyfikator) oferty, którą chcesz anulować.

purchaseOptionId

string

Wymagane. Nadrzędna opcja zakupu (identyfikator) oferty, którą chcesz anulować.

offerId

string

Wymagane. Identyfikator oferty, którą chcesz anulować.

latencyTolerance

enum (ProductUpdateLatencyTolerance)

Opcjonalnie: Tolerancja opóźnienia w propagacji tej aktualizacji. Domyślna wartość to latency-sensitive.

DeactivateOneTimeProductOfferRequest

Komunikat żądania dla offers.deactivate.

Zapis JSON
{
  "packageName": string,
  "productId": string,
  "purchaseOptionId": string,
  "offerId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
Pola
packageName

string

Wymagane. Aplikacja nadrzędna (nazwa pakietu) oferty, którą chcesz dezaktywować.

productId

string

Wymagane. Nadrzędny produkt kupowany raz (identyfikator) oferty, którą chcesz dezaktywować.

purchaseOptionId

string

Wymagane. Nadrzędna opcja zakupu (identyfikator) oferty, którą chcesz dezaktywować.

offerId

string

Wymagane. Identyfikator oferty, którą chcesz dezaktywować.

latencyTolerance

enum (ProductUpdateLatencyTolerance)

Opcjonalnie: Tolerancja opóźnienia w propagacji tej aktualizacji. Domyślna wartość to latency-sensitive.