Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

Aktualizuje zbiorczy stan oferty subskrypcji.

Aby osiągnąć maksymalną przepustowość aktualizacji, ustaw w żądaniach zagnieżdżonych pole latencyTolerance na PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT.

Żądanie HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers:batchUpdateStates

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
packageName

string

Wymagane. Aplikacja nadrzędna (nazwa pakietu) zaktualizowanych ofert subskrypcji.

Musi być taki sam jak pole packageName we wszystkich zaktualizowanych zasobach SubscriptionOffer.
productId

string

Wymagane. Identyfikator produktu abonamentu nadrzędnego, jeśli wszystkie zaktualizowane oferty należą do tego samego abonamentu. Jeśli to żądanie obejmuje kilka subskrypcji, ustaw to pole na „-”. Musi być ustawione.
basePlanId

string

Wymagane. Nadrzędni abonament podstawowy (identyfikator), dla którego należy zaktualizować oferty. Możesz użyć wartości „-”, aby zaktualizować oferty z wielu abonamentów podstawowych.

Treść żądania

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

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

object (UpdateSubscriptionOfferStateRequest)

Wymagane. Lista elementów do zaktualizowania (maksymalnie 100 elementów). Wszystkie prośby muszą dotyczyć różnych ofert.

Treść odpowiedzi

Odpowiedź na żądanie offers.batchUpdateStates.

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

Zapis JSON 
{
  "subscriptionOffers": [
    {
      object (SubscriptionOffer)
    }
  ]
}
Pola
subscriptionOffers[]

object (SubscriptionOffer)

zaktualizowana lista ofert subskrypcji;

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

UpdateSubscriptionOfferStateRequest

wiadomość z prośbą o zaktualizowanie stanu oferty subskrypcji;

Zapis JSON 
{

  // Union field state_transition_type can be only one of the following:
  "activateSubscriptionOfferRequest": {
    object (ActivateSubscriptionOfferRequest)
  },
  "deactivateSubscriptionOfferRequest": {
    object (DeactivateSubscriptionOfferRequest)
  }
  // End of list of possible types for union field state_transition_type.
}
Pola
Pole unii state_transition_type. Typ przejścia między stanami, który ma być stosowany. Musisz ustawić dokładnie 1 typ. state_transition_type może być tylko jednym z tych elementów:
activateSubscriptionOfferRequest

object (ActivateSubscriptionOfferRequest)

Aktywuje ofertę. Po aktywacji oferta będzie dostępna dla nowych subskrybentów.
deactivateSubscriptionOfferRequest

object (DeactivateSubscriptionOfferRequest)

Dezaktywuje ofertę. Po dezaktywowaniu oferta stanie się niedostępna dla nowych subskrybentów, ale dotychczasowi subskrybenci zachowają swoją subskrypcję.

ActivateSubscriptionOfferRequest

Wiadomość z prośbą o ActivateSubscriptionOffer.

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

string

Wymagane. Nazwa pakietu aplikacji nadrzędnej oferty, którą chcesz aktywować.
productId

string

Wymagane. Identyfikator nadrzędnej subskrypcji (ID) oferty, którą chcesz aktywować.
basePlanId

string

Wymagane. Identyfikator abonamentu podstawowego nadrzędnego oferty, którą chcesz aktywować.
offerId

string

Wymagane. Unikalny identyfikator oferty, którą chcesz aktywować.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

Opcjonalnie: Tolerancja opóźnienia w propagacji tej aktualizacji produktu. Domyślnie jest to wartość „Wrażliwy na opóźnienia”.

DeactivateSubscriptionOfferRequest

Prośba o wiadomość w przypadku ofert.deactivate.

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

string

Wymagane. Nazwa pakietu aplikacji nadrzędnej, której ofertę chcesz dezaktywować.
productId

string

Wymagane. Identyfikator (ID) nadrzędnej subskrypcji oferty, którą chcesz dezaktywować.
basePlanId

string

Wymagane. Identyfikator abonamentu podstawowego nadrzędnego oferty, którą chcesz dezaktywować.
offerId

string

Wymagane. Unikalny identyfikator oferty, którą chcesz dezaktywować.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

Opcjonalnie: Tolerancja opóźnienia w propagacji tej aktualizacji produktu. Domyślnie jest to wartość „Wrażliwy na opóźnienia”.