REST Resource: monetization.onetimeproducts.purchaseOptions.offers

Ressource : OneTimeProductOffer

Offre unique pour un produit ponctuel.

Représentation JSON 
{
  "packageName": string,
  "productId": string,
  "purchaseOptionId": string,
  "offerId": string,
  "state": enum (State),
  "regionalPricingAndAvailabilityConfigs": [
    {
      object (RegionalPricingAndAvailabilityConfig)
    }
  ],
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "regionsVersion": {
    object (RegionsVersion)
  },

  // Union field offer_type can be only one of the following:
  "preOrderOffer": {
    object (OneTimeProductPreOrderOffer)
  },
  "discountedOffer": {
    object (OneTimeProductDiscountedOffer)
  }
  // End of list of possible types for union field offer_type.
}
Champs
packageName

string

Obligatoire. Immuable. Nom du package de l'application à laquelle appartient le produit parent.
productId

string

Obligatoire. Immuable. ID du produit parent auquel appartient cette offre.
purchaseOptionId

string

Obligatoire. Immuable. ID de l'option d'achat à laquelle cette offre est associée.
offerId

string

Obligatoire. Immuable. ID de cette offre de produit. Cet ID doit être unique dans l'option d'achat. Il doit commencer par un chiffre ou une lettre minuscule, et il ne peut inclure que des lettres minuscules (a-z), des chiffres (0-9) et des traits d'union (-). La longueur maximale est de 63 caractères.
state

enum (State)

Uniquement en sortie. État actuel de cette offre. Ce champ ne peut pas être modifié en mettant à jour la ressource. Utilisez plutôt les points de terminaison dédiés.
regionalPricingAndAvailabilityConfigs[]

object (RegionalPricingAndAvailabilityConfig)

Ensemble d'informations sur la tarification et la disponibilité régionales pour cette offre. Ne doit pas comporter d'entrées en double avec le même code de région.
offerTags[]

object (OfferTag)

Facultatif. Liste de 20 tags personnalisés maximum spécifiés pour cette offre et renvoyés à l'application via la bibliothèque de facturation.
regionsVersion

object (RegionsVersion)

Uniquement en sortie. Version de la configuration des régions utilisée pour générer l'offre de produit ponctuel.
Champ d'union offer_type. Type de cette offre. Un seul doit être défini. offer_type ne peut être qu'un des éléments suivants :
preOrderOffer

object (OneTimeProductPreOrderOffer)

Offre de précommande
discountedOffer

object (OneTimeProductDiscountedOffer)

Une offre de remise

État

État actuel de l'offre.

Enums
STATE_UNSPECIFIED Valeur par défaut, ne doit jamais être utilisée.
DRAFT L'offre n'est pas et n'a jamais été disponible pour les utilisateurs.
ACTIVE L'offre est disponible pour les utilisateurs tant que ses conditions sont remplies.
CANCELLED Cet état est spécifique aux précommandes. L'offre est annulée et n'est plus disponible pour les utilisateurs. Toutes les commandes en attente associées à cette offre ont été annulées.
INACTIVE Cet état est spécifique aux offres à prix réduit. L'offre n'est plus disponible pour les utilisateurs.

OneTimeProductPreOrderOffer

Configuration spécifique aux offres de précommande.

Représentation JSON 
{
  "startTime": string,
  "endTime": string,
  "releaseTime": string,
  "priceChangeBehavior": enum (PreOrderPriceChangeBehavior)
}
Champs
startTime

string (Timestamp format)

Obligatoire. Heure à laquelle la précommande sera disponible.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Obligatoire. Heure à laquelle la précommande ne sera plus disponible.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
releaseTime

string (Timestamp format)

Obligatoire. Heure à laquelle le produit associé à la précommande sera disponible et les commandes de précommande traitées.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
priceChangeBehavior

enum (PreOrderPriceChangeBehavior)

Obligatoire. Immuable. Spécifie l'impact des modifications de prix sur les précommandes existantes.

PreOrderPriceChangeBehavior

Spécifie l'impact des modifications de prix sur les précommandes existantes.

Enums
PRE_ORDER_PRICE_CHANGE_BEHAVIOR_UNSPECIFIED Comportement de changement de prix non spécifié. Ne doit pas être utilisé.
PRE_ORDER_PRICE_CHANGE_BEHAVIOR_TWO_POINT_LOWEST L'acheteur est facturé au prix le plus bas entre le prix initial au moment de la précommande et le prix de l'offre finale à la date de sortie.
PRE_ORDER_PRICE_CHANGE_BEHAVIOR_NEW_ORDERS_ONLY L'acheteur bénéficie du même prix que celui de la précommande, quels que soient les changements de prix qui ont pu avoir lieu après la précommande.

OneTimeProductDiscountedOffer

Configuration spécifique aux offres à prix réduit.

Représentation JSON 
{
  "startTime": string,
  "endTime": string,
  "redemptionLimit": string
}
Champs
startTime

string (Timestamp format)

Heure à laquelle l'offre sera disponible.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Heure à laquelle l'offre ne sera plus disponible.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
redemptionLimit

string (int64 format)

Facultatif. Nombre de fois où cette offre peut être utilisée. Si elle n'est pas définie ou est définie sur 0, les utilisateurs peuvent profiter d'un nombre illimité d'offres. Sinon, il doit s'agir d'un nombre compris entre 1 et 50 (inclus).

RegionalPricingAndAvailabilityConfig

Configuration de la disponibilité et de la tarification régionales pour une offre de produit ponctuel.

Représentation JSON 
{
  "regionCode": string,
  "availability": enum (Availability),

  // Union field price_override can be only one of the following:
  "noOverride": {
    object (OneTimeProductOfferNoPriceOverrideOptions)
  },
  "relativeDiscount": number,
  "absoluteDiscount": {
    object (Money)
  }
  // End of list of possible types for union field price_override.
}
Champs
regionCode

string

Obligatoire. Code de région auquel s'applique cette configuration, tel que défini par la norme ISO 3166-2, par exemple "US".
availability

enum (Availability)

Obligatoire. Disponibilité pour cette région.
Champ d'union price_override. Le remplacement du prix de cette offre. Un seul doit être défini. price_override ne peut être qu'un des éléments suivants :
noOverride

object (OneTimeProductOfferNoPriceOverrideOptions)

Le prix défini dans l'option d'achat pour cette région sera utilisé.
relativeDiscount

number

Fraction du prix de l'option d'achat que l'utilisateur paie pour cette offre. Par exemple, si le prix de l'option d'achat pour cette région est de 12 $, une remise de 50 % correspondrait à un prix de 6 $. La remise doit être spécifiée sous forme de fraction strictement supérieure à 0 et strictement inférieure à 1. Le prix obtenu sera arrondi à l'unité facturable la plus proche (par exemple, les centimes pour l'USD). La remise relative est considérée comme non valide si le prix remisé est inférieur au prix minimal autorisé dans cette région.
absoluteDiscount

object (Money)

Valeur absolue de la remise soustraite du prix de l'option d'achat.

Elle doit être comprise entre 0 et le prix de l'option d'achat.

OneTimeProductOfferNoPriceOverrideOptions

Ce type ne comporte aucun champ.

Options pour les offres de produits ponctuels sans remplacement du prix régional.

Disponibilité

Disponibilité de l'offre.

Enums
AVAILABILITY_UNSPECIFIED Disponibilité non spécifiée. Ne doit pas être utilisé.
AVAILABLE L'offre est disponible pour les utilisateurs.
NO_LONGER_AVAILABLE L'offre n'est plus disponible pour les utilisateurs. Cette valeur ne peut être utilisée que si la disponibilité a été définie précédemment sur "DISPONIBLE".

Méthodes

activate

 Active une offre de produit ponctuel.

batchDelete

 Supprime une ou plusieurs offres de produits ponctuels.

batchGet

 Lit une ou plusieurs offres de produits ponctuels.

batchUpdate

 Crée ou met à jour une ou plusieurs offres de produits ponctuels.

batchUpdateStates

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

cancel

 Annule une offre de produit ponctuel.

deactivate

 Désactive une offre de produit ponctuel.

list

 Liste toutes les offres associées à une application, un produit ou une option d'achat donnés.

Codes d'erreur

Les opérations de cette ressource renvoient les codes d'erreur HTTP suivants :

Code d'erreur Motif Solution
5xx Erreur générique sur le serveur Google Play. Réessayez d'envoyer votre demande.

Si le problème persiste, contactez votre responsable de compte Google Play ou envoyez une demande d'assistance. Pensez à consulter le tableau de bord d'état Play pour connaître les éventuelles interruptions de service connues.
409 Erreur de mise à jour simultanée.

Une tentative de mise à jour d'un objet en cours de mise à jour a été effectuée. Par exemple, un achat est confirmé en appelant la méthode acknowledgePurchase() de la bibliothèque Play Billing et la méthode purchases.products.acknowledge de l'API Play Developer en même temps.

 Réessayez d'envoyer votre demande.