Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

Aktualizuje grupę stanów ofert subskrypcji.

Aby uzyskać maksymalną przepustowość aktualizacji, ustaw pole Tolerancja czasu oczekiwania w przypadku zagnieżdżonych żądań 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.

Wartość musi być równa wartości pola packageName w przypadku wszystkich zaktualizowanych zasobów subscriptionOffer.
productId

string

Wymagane. Identyfikator produktu subskrypcji nadrzędnej, jeśli wszystkie zaktualizowane oferty należą do tej samej subskrypcji. Jeśli to żądanie obejmuje kilka subskrypcji, ustaw w tym polu wartość „-”. To ustawienie musi być ustawione.
basePlanId

string

Wymagane. Nadrzędny abonament podstawowy (identyfikator), w przypadku którego oferty mają być aktualizowane. Można określić jako „-” , aby aktualizować 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 żądań aktualizacji zawierająca maksymalnie 100 elementów. Każda prośba musi aktualizować różne oferty.

Treść odpowiedzi

Komunikat z odpowiedzią na Offer.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

Poproś o wiadomość z prośbą o aktualizację 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 sumy state_transition_type. Typ przejścia stanu, który ma zostać zastosowany. Należy ustawić dokładnie jeden z nich. state_transition_type może mieć tylko jedną z tych wartości:
activateSubscriptionOfferRequest

object (ActivateSubscriptionOfferRequest)

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

object (DeactivateSubscriptionOfferRequest)

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

ActivateSubscriptionOfferRequest

Prośba o wiadomości dotyczące ActivateSubscriptionOffer.

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

string

Wymagane. Nadrzędna aplikacja (nazwa pakietu) oferty, którą chcesz aktywować.
productId

string

Wymagane. Nadrzędna subskrypcja (identyfikator) oferty, która ma zostać aktywowana.
basePlanId

string

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

string

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

enum (ProductUpdateLatencyTolerance)

Opcjonalnie: Tolerancja czasu oczekiwania na rozpowszechnienie tej aktualizacji usługi. Domyślnie uwzględniany jest czas oczekiwania.

DeactivateSubscriptionOfferRequest

Prośba o wiadomość offer.deactivate.

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

string

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

string

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

string

Wymagane. Identyfikator nadrzędnego abonamentu podstawowego w ofercie, która ma zostać zdezaktywowana.
offerId

string

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

enum (ProductUpdateLatencyTolerance)

Opcjonalnie: Tolerancja czasu oczekiwania na rozpowszechnienie tej aktualizacji usługi. Domyślnie uwzględniany jest czas oczekiwania.