Method: monetization.subscriptions.basePlans.batchUpdateStates

Aktywuje lub dezaktywuje abonamenty podstawowe w co najmniej 1 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: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 produktu subskrypcji nadrzędnej, jeśli wszystkie zaktualizowane abonamenty podstawowe należą do tej samej subskrypcji. Jeśli ta aktualizacja zbiorcza obejmuje wiele subskrypcji, ustaw to pole na „-”. Musisz je ustawić.

Treść żądania

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

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

object (UpdateBasePlanStateRequest)

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

Treść odpowiedzi

Odpowiedź dla 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. Ta lista będzie się pokrywać z żądaniami w takim samym porządku.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

UpdateBasePlanStateRequest

wiadomość z prośbą o zaktualizowanie stanu abonamentu podstawowego w ramach subskrypcji

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

object (ActivateBasePlanRequest)

Aktywuje abonament podstawowy. Po ich aktywacji będą dostępne dla nowych subskrybentów.

deactivateBasePlanRequest

object (DeactivateBasePlanRequest)

Dezaktywuje abonament podstawowy. Po dezaktywowaniu abonament podstawowy nie będzie już dostępny dla nowych subskrybentów, ale obecni subskrybenci zachowają swoje subskrypcje

ActivateBasePlanRequest

wiadomość z prośbą o aktywację 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 abonamentu nadrzędnego (ID) abonamentu podstawowego, który chcesz aktywować.

basePlanId

string

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

latencyTolerance

enum (ProductUpdateLatencyTolerance)

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

DeactivateBasePlanRequest

Prośba o wiadomość dla 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 chcesz dezaktywować.

productId

string

Wymagane. Identyfikator abonamentu nadrzędnego (abonamentu podstawowego), który chcesz dezaktywować.

basePlanId

string

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

latencyTolerance

enum (ProductUpdateLatencyTolerance)

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