Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdateStates

Met à jour un lot d'états d'offres de produits ponctuels.

Requête HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/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 de produits ponctuels mises à jour.

productId

string

Obligatoire. ID produit du produit ponctuel parent, si toutes les offres mises à jour appartiennent au même produit ponctuel. Si cette mise à jour groupée s'étend sur plusieurs produits ponctuels, définissez ce champ sur "-".

purchaseOptionId

string

Obligatoire. ID de l'option d'achat parente, si toutes les offres mises à jour appartiennent à la même option d'achat. Si cette mise à jour groupée s'étend sur plusieurs options d'achat, définissez ce champ sur "-".

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

object (UpdateOneTimeProductOfferStateRequest)

Obligatoire. Liste des requêtes de mise à jour (jusqu'à 100 éléments). Toutes les requêtes doivent mettre à jour 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
{
  "oneTimeProductOffers": [
    {
      object (OneTimeProductOffer)
    }
  ]
}
Champs
oneTimeProductOffers[]

object (OneTimeProductOffer)

Liste des offres de produits ponctuels mises à jour, dans le même ordre que la requête.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

UpdateOneTimeProductOfferStateRequest

Message de requête pour mettre à jour l'état d'une offre de produit ponctuel.

Représentation JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "activateOneTimeProductOfferRequest": {
    object (ActivateOneTimeProductOfferRequest)
  },
  "cancelOneTimeProductOfferRequest": {
    object (CancelOneTimeProductOfferRequest)
  },
  "deactivateOneTimeProductOfferRequest": {
    object (DeactivateOneTimeProductOfferRequest)
  }
  // End of mutually exclusive fields.
}
Champs
Type de transition d'état à appliquer. Vous devez en définir un seul. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
activateOneTimeProductOfferRequest

object (ActivateOneTimeProductOfferRequest)

Active une offre. Une fois activée, l'offre est disponible pour les utilisateurs, à condition que ses conditions soient remplies.

cancelOneTimeProductOfferRequest

object (CancelOneTimeProductOfferRequest)

Annule une offre. Une fois l'offre annulée, elle n'est plus disponible pour les utilisateurs. Toutes les commandes en attente liées à cette offre seront annulées. Cette transition d'état est spécifique aux précommandes.

deactivateOneTimeProductOfferRequest

object (DeactivateOneTimeProductOfferRequest)

Désactive une offre. Une fois désactivée, l'offre n'est plus disponible pour les utilisateurs. Cette transition d'état est spécifique aux offres de remise et de récompense de jeu.

Fin des champs mutuellement exclusifs.

CancelOneTimeProductOfferRequest

Message de requête pour offers.cancel.

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

string

Obligatoire. Application parente (nom du package) de l'offre à annuler.

productId

string

Obligatoire. Produit ponctuel parent (ID) de l'offre à annuler.

purchaseOptionId

string

Obligatoire. Option d'achat parente (ID) de l'offre à annuler.

offerId

string

Obligatoire. ID de l'offre à annuler.

latencyTolerance

enum (ProductUpdateLatencyTolerance)

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

DeactivateOneTimeProductOfferRequest

Message de requête pour offers.deactivate.

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

string

Obligatoire. Application parente (nom du package) de l'offre à désactiver.

productId

string

Obligatoire. Produit ponctuel parent (ID) de l'offre à désactiver.

purchaseOptionId

string

Obligatoire. Option d'achat parente (ID) de l'offre à désactiver.

offerId

string

Obligatoire. ID de l'offre à désactiver.

latencyTolerance

enum (ProductUpdateLatencyTolerance)

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