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 le 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 produit de l'abonnement parent, si tous les forfaits de base mis à jour appartiennent au même abonnement. Si cette mise à jour groupée s'applique à 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 de demandes de mise à jour comportant jusqu'à 100 éléments. Toutes les requêtes 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. Dans cette liste, les requêtes seront mises en correspondance 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 (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 n'est plus disponible pour les nouveaux abonnés, mais les abonnés existants conservent 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 du produit. Sensible par défaut à 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 de 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 du produit. Sensible par défaut à la latence.