Method: monetization.subscriptions.basePlans.batchUpdateStates

Aktywuje lub dezaktywuje abonamenty podstawowe w 1 lub wielu subskrypcjach.

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:batchUpdateStates

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
packageName

string

Wymagane. Aplikacja nadrzędna (nazwa pakietu) zaktualizowanych abonamentów podstawowych.
productId

string

Wymagane. Identyfikator usługi subskrypcji nadrzędnej, jeśli wszystkie zaktualizowane abonamenty podstawowe należą do tej samej subskrypcji. Jeśli ta aktualizacja zbiorcza obejmuje wiele subskrypcji, ustaw w tym polu wartość „-”. To ustawienie musi być ustawione.

Treść żądania

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

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

object (UpdateBasePlanStateRequest)

Wymagane. Lista żądań aktualizacji zawierająca maksymalnie 100 elementów. Każda prośba musi aktualizować różne abonamenty podstawowe.

Treść odpowiedzi

Komunikat odpowiedzi dotyczący basePlans.batchUpdateStates.

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

Zapis JSON 
{
  "subscriptions": [
    {
      object (Subscription)
    }
  ]
}
Pola
subscriptions[]

object (Subscription)

Lista zaktualizowanych subskrypcji. Lista zostanie dopasowana do każdego żądania w tej samej kolejności.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

UpdateBasePlanStateRequest

Wiadomość z prośbą o aktualizację stanu abonamentu podstawowego.

Zapis JSON 
{

  // Union field state_transition_type can be only one of the following:
  "activateBasePlanRequest": {
    object (ActivateBasePlanRequest)
  },
  "deactivateBasePlanRequest": {
    object (DeactivateBasePlanRequest)
  }
  // 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:
activateBasePlanRequest

object (ActivateBasePlanRequest)

Aktywuje abonament podstawowy. Po aktywowaniu abonamenty podstawowe będą dostępne dla nowych subskrybentów.
deactivateBasePlanRequest

object (DeactivateBasePlanRequest)

Dezaktywuje abonament podstawowy. Po dezaktywacji abonament podstawowy stanie się niedostępny dla nowych subskrybentów, ale dotychczasowi subskrybenci zachowają subskrypcję

ActivateBasePlanRequest

Komunikat dotyczący żądania ActivateBasePlan.

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

string

Wymagane. Aplikacja nadrzędna (nazwa pakietu) abonamentu podstawowego, który chcesz aktywować.
productId

string

Wymagane. Identyfikator subskrypcji nadrzędnej abonamentu podstawowego, który ma być aktywowany.
basePlanId

string

Wymagane. Unikalny identyfikator abonamentu podstawowego, który chcesz aktywować.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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

DeactivateBasePlanRequest

Wiadomość z prośbą o basePlans.deactivate.

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

string

Wymagane. Aplikacja nadrzędna (nazwa pakietu) abonamentu podstawowego, który ma zostać zdezaktywowany.
productId

string

Wymagane. Identyfikator subskrypcji nadrzędnej abonamentu podstawowego, który ma zostać zdezaktywowany.
basePlanId

string

Wymagane. Unikalny identyfikator abonamentu podstawowego, który chcesz dezaktywować.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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