Method: monetization.subscriptions.basePlans.batchUpdateStates

Aktywuje lub dezaktywuje abonamenty podstawowe w ramach 1 lub kilku subskrypcji.

W polu Tolerancji czasu oczekiwania w zagnieżdżonych żądaniach ustaw wartość PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT, aby uzyskać maksymalną przepustowość aktualizacji.

Żą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

To pole jest wymagane. Aplikacja nadrzędna (nazwa pakietu) zaktualizowanych abonamentów podstawowych.
productId

string

To pole jest 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 w tym polu wartość „-”. Wartość ta musi być ustawiona.

Treść żądania

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

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

object (UpdateBasePlanStateRequest)

To pole jest wymagane. Lista żądań aktualizacji zawierająca maksymalnie 100 elementów. W przypadku wszystkich żądań trzeba zaktualizować różne abonamenty podstawowe.

Treść odpowiedzi

Komunikat z odpowiedzią na temat 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 dopasowywała żądania do jednego w tej samej kolejności.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

UpdateBasePlanStateRequest

Wyślij wiadomość z prośbą o zaktualizowanie stanu abonamentu podstawowego 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 sumy state_transition_type. Musisz określić dokładnie jeden rodzaj zmiany stanu. 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

Prośba o wiadomość dotyczącą ActivateBasePlan.

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

string

To pole jest wymagane. Aplikacja nadrzędna (nazwa pakietu) abonamentu podstawowego do aktywowania.
productId

string

To pole jest wymagane. Subskrypcja nadrzędna (identyfikator) abonamentu podstawowego do aktywowania.
basePlanId

string

To pole jest wymagane. Unikalny identyfikator abonamentu podstawowego do aktywowania.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

Opcjonalnie. Tolerancja czasu oczekiwania na rozpowszechnianie tej aktualizacji usługi. Wartość domyślna jest uwzględniana w czasie oczekiwania.

DeactivateBasePlanRequest

Komunikat z żądaniem dotyczący basePlans.deactivate.

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

string

To pole jest wymagane. Aplikacja nadrzędna (nazwa pakietu) abonamentu podstawowego do dezaktywowania.
productId

string

To pole jest wymagane. Subskrypcja nadrzędna (identyfikator) abonamentu podstawowego do dezaktywowania.
basePlanId

string

To pole jest wymagane. Unikalny identyfikator abonamentu podstawowego do dezaktywowania.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

Opcjonalnie. Tolerancja czasu oczekiwania na rozpowszechnianie tej aktualizacji usługi. Wartość domyślna jest uwzględniana w czasie oczekiwania.