Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

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

Définissez le champ "latenceTolerance" des requêtes imbriquées sur PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT pour atteindre le 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 du package) des offres d'abonnement mises à jour.

Doit être égal au champ packageName sur 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 requête couvre 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. Peut être spécifié sous la forme "-" 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 de demandes de mise à jour comportant jusqu'à 100 éléments. Chaque demande doit mettre à jour des offres différentes.

Corps de la réponse

Message de réponse pour offer.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 des offres d'abonnement mise à jour.

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 n'est plus disponible pour les nouveaux abonnés, mais les abonnés existants conservent 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 de latence pour la propagation de cette mise à jour du produit. Sensible par défaut à 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 de latence pour la propagation de cette mise à jour du produit. Sensible par défaut à la latence.