Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

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

Définissez le champ latencyTolerance sur PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT pour obtenir 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 du package) des offres d'abonnement mises à jour.

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

string

Obligatoire. ID du produit de l'abonnement parent, si toutes les offres mises à jour appartiennent au même abonnement. Si cette requête s'étend sur plusieurs abonnements, définissez ce champ sur "-". Ce champ doit être défini.
basePlanId

string

Obligatoire. Forfait de base parent (ID) pour lequel les offres doivent être mises à jour. Vous pouvez spécifier "-" 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 la requête de mise à jour, pouvant comporter jusqu'à 100 éléments. Toutes les demandes doivent modifier des offres différentes.

Corps de la réponse

Message de réponse pour offers.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'abonnements.

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. Vous devez définir un seul type. 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 du 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. ID unique de l'offre à activer.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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

DeactivateSubscriptionOfferRequest

Message de requête pour offers.deactivate.

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

string

Obligatoire. Application parente (nom du 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. ID unique de l'offre à désactiver.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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