Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

Aktualizuje grupę stanów ofert 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/{basePlanId}/offers: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 ofert subskrypcji.

Musi być taka sama jak wartość pola packageName we wszystkich zaktualizowanych zasobach SubscriptionOffer.

productId

string

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

basePlanId

string

To pole jest wymagane. Nadrzędny abonament podstawowy (identyfikator), w którego przypadku mają zostać zaktualizowane oferty. Aby aktualizować oferty z wielu abonamentów podstawowych, możesz użyć znaku „-”.

Treść żądania

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

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

object (UpdateSubscriptionOfferStateRequest)

To pole jest wymagane. Lista żądań aktualizacji zawierająca maksymalnie 100 elementów. Każda prośba musi zostać zaktualizowana.

Treść odpowiedzi

Wiadomość 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ść, aby zaktualizować stan 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. Musisz określić dokładnie jeden rodzaj zmiany stanu. 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ść dotyczącą ActivateSubscriptionOffer.

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

string

To pole jest wymagane. Nadrzędna aplikacja (nazwa pakietu) oferty do aktywowania.

productId

string

To pole jest wymagane. Subskrypcja nadrzędna (identyfikator) oferty do aktywowania.

basePlanId

string

To pole jest wymagane. Nadrzędny abonament podstawowy (ID) oferty do aktywowania.

offerId

string

To pole jest wymagane. Unikalny identyfikator oferty, która ma zostać aktywowana.

latencyTolerance

enum (ProductUpdateLatencyTolerance)

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

DeactivateSubscriptionOfferRequest

Poproś o wiadomość dotyczącą offer.deactivate.

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

string

To pole jest wymagane. Nadrzędna aplikacja (nazwa pakietu) oferty do dezaktywacji.

productId

string

To pole jest wymagane. Subskrypcja nadrzędna (identyfikator) oferty do dezaktywacji.

basePlanId

string

To pole jest wymagane. Nadrzędny abonament podstawowy (identyfikator) oferty do dezaktywacji.

offerId

string

To pole jest wymagane. Unikalny identyfikator oferty, którą chcesz dezaktywować.

latencyTolerance

enum (ProductUpdateLatencyTolerance)

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