Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

Met à jour un lot d'états d'offres d'abonnement.

Définissez le champ latenceTolerance des requêtes imbriquées sur PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT pour atteindre un débit de mise à jour maximal.

Requête HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers:batchUpdateStates

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
packageName

string

Obligatoire. Application parente (nom de package) des offres d'abonnement mises à jour.

Doit être égal au champ packageName de toutes les ressources SubscriptionOffer mises à jour.
productId

string

Obligatoire. ID produit de l'abonnement parent, si toutes les offres mises à jour appartiennent au même abonnement. Si cette demande concerne plusieurs abonnements, définissez ce champ sur "-". Doit être défini.
basePlanId

string

Obligatoire. Forfait de base (ID) parent pour lequel les offres doivent être mises à jour. Elle peut être indiquée par "-" pour mettre à jour les offres de plusieurs forfaits de base.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "requests": [
    {
      object (UpdateSubscriptionOfferStateRequest)
    }
  ]
}
Champs
requests[]

object (UpdateSubscriptionOfferStateRequest)

Obligatoire. Liste des demandes de mise à jour comportant jusqu'à 100 éléments. Toutes les demandes doivent mettre à jour des offres différentes.

Corps de la réponse

Message de réponse pouroffers.batchUpdateStates.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "subscriptionOffers": [
    {
      object (SubscriptionOffer)
    }
  ]
}
Champs
subscriptionOffers[]

object (SubscriptionOffer)

Liste mise à jour des offres d'abonnement.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

UpdateSubscriptionOfferStateRequest

Message de requête pour mettre à jour l'état d'une offre d'abonnement.

Représentation 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.
}
Champs
Champ d'union state_transition_type. Type de transition d'état à appliquer. Un seul doit être défini. state_transition_type ne peut être qu'un des éléments suivants :
activateSubscriptionOfferRequest

object (ActivateSubscriptionOfferRequest)

Active une offre. Une fois activée, l'offre sera disponible pour les nouveaux abonnés.
deactivateSubscriptionOfferRequest

object (DeactivateSubscriptionOfferRequest)

Désactive une offre. Une fois désactivée, l'offre ne sera plus disponible pour les nouveaux abonnés, mais les abonnés existants conserveront leur abonnement.

ActivateSubscriptionOfferRequest

Message de requête pour ActivateSubscriptionOffer.

Représentation JSON 
{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "offerId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
Champs
packageName

string

Obligatoire. Application parente (nom de package) de l'offre à activer.
productId

string

Obligatoire. Abonnement parent (ID) de l'offre à activer.
basePlanId

string

Obligatoire. Forfait de base parent (ID) de l'offre à activer.
offerId

string

Obligatoire. Identifiant unique de l'offre à activer.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

Facultatif. Tolérance à la latence pour la propagation de cette mise à jour du produit. La valeur par défaut est sensible à la latence.

DeactivateSubscriptionOfferRequest

Message de requête pour offer.deactivate.

Représentation JSON 
{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "offerId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
Champs
packageName

string

Obligatoire. Application parente (nom de package) de l'offre à désactiver.
productId

string

Obligatoire. Abonnement parent (ID) de l'offre à désactiver.
basePlanId

string

Obligatoire. Forfait de base parent (ID) de l'offre à désactiver.
offerId

string

Obligatoire. Identifiant unique de l'offre à désactiver.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

Facultatif. Tolérance à la latence pour la propagation de cette mise à jour du produit. La valeur par défaut est sensible à la latence.