Method: monetization.subscriptions.basePlans.batchUpdateStates

Active ou désactive des forfaits de base pour un ou plusieurs abonnements.

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: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 forfaits de base mis à jour.

productId

string

Obligatoire. ID du produit de l'abonnement parent, si tous les forfaits de base mis à jour appartiennent au même abonnement. Si cette mise à jour par lot s'applique à plusieurs abonnements, définissez ce champ sur "-". Ce champ doit être défini.

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 (UpdateBasePlanStateRequest)
    }
  ]
}
Champs
requests[]

object (UpdateBasePlanStateRequest)

Obligatoire. Liste de la requête de mise à jour, pouvant comporter jusqu'à 100 éléments. Toutes les requêtes doivent mettre à jour différents forfaits de base.

Corps de la réponse

Message de réponse pour basePlans.batchUpdateStates.

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

Représentation JSON
{
  "subscriptions": [
    {
      object (Subscription)
    }
  ]
}
Champs
subscriptions[]

object (Subscription)

Liste des abonnements mis à jour. Cette liste correspondra aux requêtes une à une, dans le même ordre.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

UpdateBasePlanStateRequest

Message de requête pour mettre à jour l'état d'un forfait de base d'abonnement.

Représentation 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.
}
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 :
activateBasePlanRequest

object (ActivateBasePlanRequest)

Active un forfait de base. Une fois activés, les forfaits de base seront disponibles pour les nouveaux abonnés.

deactivateBasePlanRequest

object (DeactivateBasePlanRequest)

Désactive un forfait de base. Une fois le forfait de base désactivé, les nouveaux abonnés n'y auront plus accès, mais les abonnés existants conserveront leur abonnement.

ActivateBasePlanRequest

Message de requête pour ActivateBasePlan.

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

string

Obligatoire. Application parente (nom du package) du forfait de base à activer.

productId

string

Obligatoire. Abonnement parent (ID) du forfait de base à activer.

basePlanId

string

Obligatoire. ID unique du forfait de base à 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".

DeactivateBasePlanRequest

Message de requête pour basePlans.deactivate.

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

string

Obligatoire. Application parente (nom du package) du forfait de base à désactiver.

productId

string

Obligatoire. Abonnement parent (ID) du forfait de base à désactiver.

basePlanId

string

Obligatoire. ID unique du forfait de base à 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".