Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdateStates

Aktualizuje stan pakietu ofert produktów kupowanych 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) z aktualizowanymi ofertami produktów jednorazowych.

productId

string

Wymagane. Identyfikator produktu kupowanego raz, który jest produktem nadrzędnym, jeśli wszystkie zaktualizowane oferty należą do tego samego produktu kupowanego raz. Jeśli ta aktualizacja zbiorcza obejmuje wiele produktów jednorazowych, ustaw w tym polu wartość „-”.

purchaseOptionId

string

Wymagane. Identyfikator opcji zakupu nadrzędnej, jeśli wszystkie zaktualizowane oferty należą do tej samej opcji zakupu. Jeśli ta aktualizacja zbiorcza obejmuje wiele opcji zakupu, ustaw w tym polu wartość „-”.

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

Wiadomość odpowiedzi dla metody 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 produktów kupowanych raz, w tej samej kolejności co w żądaniu.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

UpdateOneTimeProductOfferStateRequest

Wiadomość z prośbą o zaktualizowanie stanu oferty produktu kupowanego raz.

Zapis JSON
{

  // Union field state_transition_type can be only one of the following:
  "activateOneTimeProductOfferRequest": {
    object (ActivateOneTimeProductOfferRequest)
  },
  "cancelOneTimeProductOfferRequest": {
    object (CancelOneTimeProductOfferRequest)
  },
  "deactivateOneTimeProductOfferRequest": {
    object (DeactivateOneTimeProductOfferRequest)
  }
  // End of list of possible types for union field state_transition_type.
}
Pola
Pole unii state_transition_type. Typ przejścia stanu do zastosowania. Musisz ustawić dokładnie jeden typ. state_transition_type może mieć tylko jedną z tych wartości:
activateOneTimeProductOfferRequest

object (ActivateOneTimeProductOfferRequest)

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

cancelOneTimeProductOfferRequest

object (CancelOneTimeProductOfferRequest)

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

deactivateOneTimeProductOfferRequest

object (DeactivateOneTimeProductOfferRequest)

Dezaktywuje ofertę. Po dezaktywacji oferta nie będzie już dostępna dla użytkowników. Ta zmiana stanu dotyczy tylko ofert z rabatem.

CancelOneTimeProductOfferRequest

Wiadomość żądania dla 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 do anulowania.

productId

string

Wymagane. Nadrzędny produkt kupowany raz (identyfikator) oferty do anulowania.

purchaseOptionId

string

Wymagane. Nadrzędna opcja zakupu (identyfikator) oferty do anulowania.

offerId

string

Wymagane. Identyfikator oferty do anulowania.

latencyTolerance

enum (ProductUpdateLatencyTolerance)

Opcjonalnie. Tolerancja opóźnienia w propagowaniu tej aktualizacji. Domyślnie jest to opcja „Wrażliwe na opóźnienia”.

DeactivateOneTimeProductOfferRequest

Prośba o wiadomość w przypadku wyłączenia oferty.

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

string

Wymagane. Aplikacja nadrzędna (nazwa pakietu) oferty do dezaktywacji.

productId

string

Wymagane. Nadrzędny produkt kupowany raz (identyfikator) oferty do dezaktywacji.

purchaseOptionId

string

Wymagane. Opcja zakupu nadrzędnego (identyfikator) oferty do dezaktywacji.

offerId

string

Wymagane. Identyfikator oferty do dezaktywacji.

latencyTolerance

enum (ProductUpdateLatencyTolerance)

Opcjonalnie. Tolerancja opóźnienia w propagowaniu tej aktualizacji. Domyślnie jest to opcja „Wrażliwe na opóźnienia”.