Method: monetization.subscriptions.basePlans.batchUpdateStates

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

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

productId

string

Obligatoire. ID produit de l'abonnement parent, si tous les forfaits de base mis à jour appartiennent au même abonnement. Si cette mise à jour groupée concerne plusieurs abonnements, définissez ce champ sur "-". 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 des demandes de mise à jour comportant jusqu'à 100 éléments. Toutes les demandes doivent mettre à jour des forfaits de base différents.

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 mettra en correspondance les 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 permettant de 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. Un seul doit être défini. 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 désactivé, le forfait de base deviendra indisponible pour les nouveaux abonné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 du forfait de base unique du forfait de base à 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.

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