REST Resource: monetization.onetimeproducts

Ressource : OneTimeProduct

Un seul produit ponctuel pour une application.

Représentation JSON 
{
  "packageName": string,
  "productId": string,
  "listings": [
    {
      object (OneTimeProductListing)
    }
  ],
  "taxAndComplianceSettings": {
    object (OneTimeProductTaxAndComplianceSettings)
  },
  "purchaseOptions": [
    {
      object (OneTimeProductPurchaseOption)
    }
  ],
  "restrictedPaymentCountries": {
    object (RestrictedPaymentCountries)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "regionsVersion": {
    object (RegionsVersion)
  }
}
Champs
packageName

string

Obligatoire. Immuable. Nom du package de l'application parente.
productId

string

Obligatoire. Immuable. ID unique du produit. Unique dans l'application parente. Les ID produit doivent commencer par un chiffre ou une lettre minuscule, et peuvent contenir des chiffres (0-9), des lettres minuscules (a-z), des traits de soulignement (_) et des points (.).
listings[]

object (OneTimeProductListing)

Obligatoire. Ensemble de données de titre et de description localisées. Ne doit pas comporter d'entrées en double avec le même code de langue.
taxAndComplianceSettings

object (OneTimeProductTaxAndComplianceSettings)

Informations sur les taxes et la conformité juridique.
purchaseOptions[]

object (OneTimeProductPurchaseOption)

Obligatoire. Ensemble des options d'achat pour ce produit ponctuel.
restrictedPaymentCountries

object (RestrictedPaymentCountries)

Facultatif. Pays où ce produit ponctuel ne peut être acheté qu'avec les modes de paiement enregistrés dans le pays concerné. Si ce champ est vide, aucune restriction n'est imposée concernant les lieux de paiement.
offerTags[]

object (OfferTag)

Facultatif. Liste de 20 tags personnalisés maximum spécifiés pour ce produit ponctuel et renvoyés à l'application via la bibliothèque de facturation. Les options d'achat et les offres pour ce produit recevront également ces tags dans la bibliothèque de facturation.
regionsVersion

object (RegionsVersion)

Uniquement en sortie. Version de la configuration des régions utilisée pour générer le produit ponctuel.

OneTimeProductListing

Fiche de magasin régionale pour un produit ponctuel.

Représentation JSON 
{
  "languageCode": string,
  "title": string,
  "description": string
}
Champs
languageCode

string

Obligatoire. Langue de cette fiche, telle que définie par BCP-47 (par exemple, "en-US".
title

string

Obligatoire. Titre de ce produit dans la langue de cette fiche. La longueur ne doit pas dépasser 55 caractères.
description

string

Obligatoire. Description de ce produit dans la langue de cette fiche. Il ne doit pas dépasser 200 caractères.

OneTimeProductTaxAndComplianceSettings

Informations sur la fiscalité, les règles Google Play et la conformité juridique pour les produits ponctuels.

Représentation JSON 
{
  "regionalTaxConfigs": [
    {
      object (RegionalTaxConfig)
    }
  ],
  "isTokenizedDigitalAsset": boolean
}
Champs
regionalTaxConfigs[]

object (RegionalTaxConfig)

Configuration des taxes régionales.
isTokenizedDigitalAsset

boolean

Indique si ce produit ponctuel est déclaré comme représentant un contenu numérique tokenisé.

RegionalTaxConfig

Informations sur la fiscalité dans une région géographique donnée.

Représentation JSON 
{
  "regionCode": string,
  "taxTier": enum (TaxTier),
  "eligibleForStreamingServiceTaxRate": boolean,
  "streamingTaxType": enum (StreamingTaxType)
}
Champs
regionCode

string

Obligatoire. Code de la région à laquelle s'applique cette configuration, tel que défini par la norme ISO 3166-2 (par exemple, "US").
taxTier

enum (TaxTier)

Niveau de taxes permettant de spécifier un taux de taxe réduit. Les développeurs qui vendent des contenus d'actualités, des magazines, des journaux, des livres ou des livres audio numériques dans différentes régions peuvent bénéficier de taux de TVA réduits.

En savoir plus
eligibleForStreamingServiceTaxRate

boolean

Vous devez nous indiquer si votre application contient des produits de streaming pour que nous puissions vous facturer correctement la taxe de vente locale et d'État. Champ disponible uniquement aux États-Unis.
streamingTaxType

enum (StreamingTaxType)

Afin de collecter les taxes sur les communications ou les divertissements aux États-Unis, sélectionnez la catégorie de taxe appropriée.

En savoir plus

OneTimeProductPurchaseOption

Option d'achat unique pour un produit ponctuel.

Représentation JSON 
{
  "purchaseOptionId": string,
  "state": enum (State),
  "regionalPricingAndAvailabilityConfigs": [
    {
      object (RegionalPricingAndAvailabilityConfig)
    }
  ],
  "newRegionsConfig": {
    object (OneTimeProductPurchaseOptionNewRegionsConfig)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "taxAndComplianceSettings": {
    object (PurchaseOptionTaxAndComplianceSettings)
  },

  // Union field purchase_option_type can be only one of the following:
  "buyOption": {
    object (OneTimeProductBuyPurchaseOption)
  },
  "rentOption": {
    object (OneTimeProductRentPurchaseOption)
  }
  // End of list of possible types for union field purchase_option_type.
}
Champs
purchaseOptionId

string

Obligatoire. Immuable. Identifiant unique de cette option d'achat. Cet ID doit être unique dans le produit ponctuel. 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 de l'option d'achat (active ou non). 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)

Informations sur la tarification et la disponibilité régionales pour cette option d'achat.
newRegionsConfig

object (OneTimeProductPurchaseOptionNewRegionsConfig)

Informations sur les tarifs pour les nouveaux pays ou régions dans lesquels Play sera disponible à l'avenir. Si vous l'omettez, l'option d'achat ne sera pas automatiquement disponible dans les nouveaux pays où Play sera lancé à l'avenir.
offerTags[]

object (OfferTag)

Facultatif. Liste de 20 tags personnalisés maximum spécifiés pour cette option d'achat et renvoyés à l'application via la bibliothèque Billing. Les offres pour cette option d'achat recevront également ces tags dans la bibliothèque de facturation.
taxAndComplianceSettings

object (PurchaseOptionTaxAndComplianceSettings)

Facultatif. Informations sur les taxes et la conformité juridique.
Champ d'union purchase_option_type. Type d'option d'achat. Un seul doit être défini. purchase_option_type ne peut être qu'un des éléments suivants :
buyOption

object (OneTimeProductBuyPurchaseOption)

Option d'achat disponible.
rentOption

object (OneTimeProductRentPurchaseOption)

Option d'achat pouvant être louée.

État

État actuel de l'option d'achat.

Enums
STATE_UNSPECIFIED Valeur par défaut, ne doit jamais être utilisée.
DRAFT L'option d'achat n'est pas et n'a jamais été disponible pour les utilisateurs.
ACTIVE L'option d'achat est disponible pour les utilisateurs.
INACTIVE L'option d'achat n'est plus disponible pour les utilisateurs.
INACTIVE_PUBLISHED L'option d'achat n'est plus disponible à l'achat, mais nous continuons à exposer son offre via la bibliothèque Play Billing pour assurer la rétrocompatibilité. Seules les options d'achat migrées automatiquement peuvent être dans cet état.

OneTimeProductBuyPurchaseOption

Option d'achat disponible.

Représentation JSON 
{
  "legacyCompatible": boolean,
  "multiQuantityEnabled": boolean
}
Champs
legacyCompatible

boolean

Facultatif. Indique si cette option d'achat sera disponible dans les anciens flux PBL qui ne sont pas compatibles avec le modèle de produits ponctuels.

Vous pouvez marquer une option d'achat "Acheter" comme rétrocompatible.
multiQuantityEnabled

boolean

Facultatif. Indique si cette option d'achat autorise les quantités multiples. Les quantités multiples permettent aux acheteurs d'acheter plusieurs articles en une seule fois.

OneTimeProductRentPurchaseOption

Option d'achat pouvant être louée.

Représentation JSON 
{
  "rentalPeriod": string,
  "expirationPeriod": string
}
Champs
rentalPeriod

string

Obligatoire. Durée pendant laquelle un utilisateur dispose du droit d'accès. Commence à la fin du parcours d'achat. Spécifiée au format ISO 8601.
expirationPeriod

string

Facultatif. Délai dont dispose l'utilisateur après avoir commencé à utiliser le droit d'accès avant qu'il ne soit révoqué. Spécifiée au format ISO 8601.

RegionalPricingAndAvailabilityConfig

Configuration de la disponibilité et de la tarification régionales pour une option d'achat.

Représentation JSON 
{
  "regionCode": string,
  "price": {
    object (Money)
  },
  "availability": enum (Availability)
}
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".
price

object (Money)

Prix de l'option d'achat dans la région spécifiée. Doit être défini dans la devise associée à la région spécifiée.
availability

enum (Availability)

Disponibilité de l'option d'achat.

Disponibilité

Disponibilité de l'option d'achat.

Enums
AVAILABILITY_UNSPECIFIED Disponibilité non spécifiée. Ne doit pas être utilisé.
AVAILABLE L'option d'achat est disponible pour les utilisateurs.
NO_LONGER_AVAILABLE Les utilisateurs n'ont plus accès à l'option d'achat. Cette valeur ne peut être utilisée que si la disponibilité a été définie précédemment sur "DISPONIBLE".
AVAILABLE_IF_RELEASED L'option d'achat n'est pas disponible au départ, mais elle le devient grâce à une offre de précommande publiée.

OneTimeProductPurchaseOptionNewRegionsConfig

Informations sur les tarifs pour les nouvelles régions dans lesquelles Play pourrait être lancé à l'avenir.

Représentation JSON 
{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  },
  "availability": enum (Availability)
}
Champs
usdPrice

object (Money)

Obligatoire. Prix en USD à utiliser pour les nouvelles régions dans lesquelles Play pourrait être lancé.
eurPrice

object (Money)

Obligatoire. Prix en EUR à utiliser pour les nouvelles régions dans lesquelles Play pourrait être lancé.
availability

enum (Availability)

Obligatoire. Disponibilité régionale pour la nouvelle configuration des régions. Si vous sélectionnez "DISPONIBLE", les informations tarifaires seront utilisées pour toutes les nouvelles régions dans lesquelles Play sera lancé à l'avenir.

Disponibilité

Disponibilité de la nouvelle configuration des régions.

Enums
AVAILABILITY_UNSPECIFIED Disponibilité non spécifiée. Ne doit pas être utilisé.
AVAILABLE La configuration sera utilisée pour toutes les nouvelles régions dans lesquelles Play sera lancé à l'avenir.
NO_LONGER_AVAILABLE La configuration n'est plus disponible et ne sera pas utilisée pour les nouvelles régions dans lesquelles Play sera lancé à l'avenir. Cette valeur ne peut être utilisée que si la disponibilité a été définie précédemment sur "DISPONIBLE".

PurchaseOptionTaxAndComplianceSettings

Informations sur la fiscalité, le règlement Google Play et la conformité juridique pour les options d'achat de produits ponctuels.

Représentation JSON 
{
  "withdrawalRightType": enum (WithdrawalRightType)
}
Champs
withdrawalRightType

enum (WithdrawalRightType)

Facultatif. Classification comme contenu numérique ou service pour les produits distribués aux utilisateurs dans les régions éligibles.

Si cette valeur n'est pas définie, la valeur par défaut est WITHDRAWAL_RIGHT_DIGITAL_CONTENT.

Pour en savoir plus, consultez l'article du Centre d'aide.

Méthodes

batchDelete

 Supprime un ou plusieurs produits ponctuels.

batchGet

 Lit un ou plusieurs produits ponctuels.

batchUpdate

 Crée ou met à jour un ou plusieurs produits ponctuels.

delete

 Supprime un produit ponctuel.

get

 Lit un seul produit ponctuel.

list

 Liste tous les produits ponctuels d'une application donnée.

patch

 Crée ou met à jour un produit ponctuel.