REST Resource: monetization.onetimeproducts

Ressource: OneTimeProduct

Ein einzelnes Einmalkaufprodukt für eine App.

JSON-Darstellung 
{
  "packageName": string,
  "productId": string,
  "listings": [
    {
      object (OneTimeProductListing)
    }
  ],
  "taxAndComplianceSettings": {
    object (OneTimeProductTaxAndComplianceSettings)
  },
  "purchaseOptions": [
    {
      object (OneTimeProductPurchaseOption)
    }
  ],
  "restrictedPaymentCountries": {
    object (RestrictedPaymentCountries)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "regionsVersion": {
    object (RegionsVersion)
  }
}
Felder
packageName

string

Erforderlich. Nicht veränderbar. Paketname der übergeordneten App.
productId

string

Erforderlich. Nicht veränderbar. Eindeutige Produkt-ID des Produkts. Eindeutig innerhalb der übergeordneten App. Produkt-IDs müssen mit einer Ziffer oder einem Kleinbuchstaben beginnen und können Ziffern (0–9), Kleinbuchstaben (a–z), Unterstriche (_) und Punkte (.) enthalten.
listings[]

object (OneTimeProductListing)

Erforderlich. Eine Reihe lokalisierter Titel- und Beschreibungsdaten. Es darf keine doppelten Einträge mit demselben „languageCode“ geben.
taxAndComplianceSettings

object (OneTimeProductTaxAndComplianceSettings)

Details zu Steuern und rechtlicher Compliance.
purchaseOptions[]

object (OneTimeProductPurchaseOption)

Erforderlich. Die Gruppe von Kaufoptionen für dieses Einmalkaufprodukt.
restrictedPaymentCountries

object (RestrictedPaymentCountries)

Optional. Länder, in denen der Kauf dieses Einmalkaufprodukts auf Zahlungsmethoden beschränkt ist, die im selben Land registriert sind. Wenn leer, werden keine Zahlungsbeschränkungen für Länder und Regionen auferlegt.
offerTags[]

object (OfferTag)

Optional. Liste mit bis zu 20 benutzerdefinierten Tags, die für dieses Einmalkaufprodukt angegeben und über die Billing Library an die App zurückgegeben werden. Kaufoptionen und Angebote für dieses Produkt erhalten diese Tags auch in der Billing Library.
regionsVersion

object (RegionsVersion)

Nur Ausgabe. Die Version der Regionskonfiguration, die zum Generieren des Einmalkaufprodukts verwendet wurde.

OneTimeProductListing

Regionaler Store-Eintrag für ein Einmalkaufprodukt

JSON-Darstellung 
{
  "languageCode": string,
  "title": string,
  "description": string
}
Felder
languageCode

string

Erforderlich. Die Sprache dieses Eintrags, wie in BCP-47 definiert, z.B. „en-US“.
title

string

Erforderlich. Der Titel dieses Produkts in der Sprache dieses Eintrags. Die maximale Länge beträgt 55 Zeichen.
description

string

Erforderlich. Die Beschreibung dieses Produkts in der Sprache dieses Eintrags. Die maximale Länge beträgt 200 Zeichen.

OneTimeProductTaxAndComplianceSettings

Details zu Steuern, Google Play-Richtlinien und rechtlicher Compliance für Einmalkaufprodukte.

JSON-Darstellung 
{
  "regionalTaxConfigs": [
    {
      object (RegionalTaxConfig)
    }
  ],
  "isTokenizedDigitalAsset": boolean
}
Felder
regionalTaxConfigs[]

object (RegionalTaxConfig)

Regionale Steuerkonfiguration.
isTokenizedDigitalAsset

boolean

Gibt an, ob dieses Einmalkaufprodukt als Produkt deklariert ist, das ein tokenisiertes digitales Asset darstellt.

RegionalTaxConfig

Details zur Besteuerung in einer bestimmten geografischen Region.

JSON-Darstellung 
{
  "regionCode": string,
  "taxTier": enum (TaxTier),
  "eligibleForStreamingServiceTaxRate": boolean,
  "streamingTaxType": enum (StreamingTaxType)
}
Felder
regionCode

string

Erforderlich. Der Regionscode, für den diese Konfiguration gilt, gemäß ISO 3166-2, z.B. „US“.
taxTier

enum (TaxTier)

Steuersatz zur Angabe eines ermäßigten Steuersatzes. Entwickler, die digitale Nachrichten, Zeitschriften, Zeitungen, Bücher oder Hörbücher in verschiedenen Regionen verkaufen, profitieren möglicherweise von niedrigeren Steuersätzen.

Weitere Informationen
eligibleForStreamingServiceTaxRate

boolean

Sie müssen angeben, ob Ihre App Streamingprodukte enthält, damit die US-amerikanische und lokale Mehrwertsteuer korrekt berechnet werden kann. Das Feld wird nur in den USA unterstützt.
streamingTaxType

enum (StreamingTaxType)

Wähle zum Erheben der Kommunikations- oder Vergnügungssteuer in den USA die entsprechende Steuerkategorie aus.

Weitere Informationen

OneTimeProductPurchaseOption

Eine einzelne Kaufoption für ein Einmalkaufprodukt.

JSON-Darstellung 
{
  "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.
}
Felder
purchaseOptionId

string

Erforderlich. Nicht veränderbar. Die eindeutige Kennung dieser Kaufoption. Die ID muss innerhalb des Einmalkaufprodukts eindeutig sein. Sie muss mit einer Ziffer oder einem Kleinbuchstaben beginnen und darf nur Kleinbuchstaben (a–z), Ziffern (0–9) und Bindestriche (-) enthalten. Die maximale Länge beträgt 63 Zeichen.
state

enum (State)

Nur Ausgabe. Der Status der Kaufoption, d.h., ob sie aktiv ist. Dieses Feld kann nicht durch Aktualisieren der Ressource geändert werden. Verwenden Sie stattdessen die entsprechenden Endpunkte.
regionalPricingAndAvailabilityConfigs[]

object (RegionalPricingAndAvailabilityConfig)

Regionale Preis- und Verfügbarkeitsinformationen für diese Kaufoption.
newRegionsConfig

object (OneTimeProductPurchaseOptionNewRegionsConfig)

Preisinformationen für alle neuen Standorte, an denen Play in Zukunft eingeführt werden könnte. Wenn Sie diese Angabe weglassen, ist die Kaufoption nicht automatisch an neuen Standorten verfügbar, an denen Google Play in Zukunft eingeführt wird.
offerTags[]

object (OfferTag)

Optional. Liste mit bis zu 20 benutzerdefinierten Tags, die für diese Kaufoption angegeben und über die Billing Library an die App zurückgegeben werden. Angebote für diese Kaufoption erhalten diese Tags auch in der Abrechnungsbibliothek.
taxAndComplianceSettings

object (PurchaseOptionTaxAndComplianceSettings)

Optional. Details zu Steuern und rechtlicher Compliance.
Union-Feld purchase_option_type. Der Typ dieser Kaufoption. Es muss genau einer festgelegt werden. Für purchase_option_type ist nur einer der folgenden Werte zulässig:
buyOption

object (OneTimeProductBuyPurchaseOption)

Eine Kaufoption, die gekauft werden kann.
rentOption

object (OneTimeProductRentPurchaseOption)

Eine Kaufoption, die ausgeliehen werden kann.

Status

Der aktuelle Status der Kaufoption.

Enums
STATE_UNSPECIFIED Standardwert, sollte nie verwendet werden.
DRAFT Die Kaufoption ist und war für Nutzer nie verfügbar.
ACTIVE Die Kaufoption ist für Nutzer verfügbar.
INACTIVE Die Kaufoption ist für Nutzer nicht mehr verfügbar.
INACTIVE_PUBLISHED Die Kaufoption ist nicht mehr verfügbar, aber wir stellen ihr Angebot aus Gründen der Abwärtskompatibilität weiterhin über die Play Billing Library zur Verfügung. Nur automatisch migrierte Kaufoptionen können diesen Status haben.

OneTimeProductBuyPurchaseOption

Eine Kaufoption, die gekauft werden kann.

JSON-Darstellung 
{
  "legacyCompatible": boolean,
  "multiQuantityEnabled": boolean
}
Felder
legacyCompatible

boolean

Optional. Gibt an, ob diese Kaufoption in alten PBL-Abläufen verfügbar ist, die das Modell für Einmalkaufprodukte nicht unterstützen.

Es kann maximal eine Kaufoption des Typs „Kaufen“ als abwärtskompatibel gekennzeichnet werden.
multiQuantityEnabled

boolean

Optional. Gibt an, ob für diese Kaufoption Käufe in variabler Stückzahl zulässig sind. Mit der Option „Mehrere Artikel“ können Käufer mehr als einen Artikel in einem einzigen Bezahlvorgang kaufen.

OneTimeProductRentPurchaseOption

Eine Kaufoption, die ausgeliehen werden kann.

JSON-Darstellung 
{
  "rentalPeriod": string,
  "expirationPeriod": string
}
Felder
rentalPeriod

string

Erforderlich. Die Dauer, für die ein Nutzer die Berechtigung hat. Beginnt mit dem Abschluss des Kaufvorgangs. Im ISO 8601-Format angegeben.
expirationPeriod

string

Optional. Die Zeit, die der Nutzer nach Beginn der Nutzung der Berechtigung hat, bevor sie widerrufen wird. Im ISO 8601-Format angegeben.

RegionalPricingAndAvailabilityConfig

Konfiguration der regionalen Preise und Verfügbarkeit für eine Kaufoption.

JSON-Darstellung 
{
  "regionCode": string,
  "price": {
    object (Money)
  },
  "availability": enum (Availability)
}
Felder
regionCode

string

Erforderlich. Regionscode, auf den sich diese Konfiguration bezieht, gemäß ISO 3166-2, z.B. „US“.
price

object (Money)

Der Preis der Kaufoption in der angegebenen Region. Muss in der Währung festgelegt werden, die mit der angegebenen Region verknüpft ist.
availability

enum (Availability)

Die Verfügbarkeit der Kaufoption.

Verfügbarkeit

Die Verfügbarkeit der Kaufoption.

Enums
AVAILABILITY_UNSPECIFIED Nicht angegebene Verfügbarkeit. Darf nicht verwendet werden.
AVAILABLE Die Kaufoption ist für Nutzer verfügbar.
NO_LONGER_AVAILABLE Die Kaufoption ist für Nutzer nicht mehr verfügbar. Dieser Wert kann nur verwendet werden, wenn die Verfügbarkeit zuvor auf AVAILABLE festgelegt wurde.
AVAILABLE_IF_RELEASED Die Kaufoption ist anfangs nicht verfügbar, wird aber über ein veröffentlichtes Vorbesteller-Angebot verfügbar gemacht.

OneTimeProductPurchaseOptionNewRegionsConfig

Preisinformationen für alle neuen Regionen, in denen Play in Zukunft eingeführt wird.

JSON-Darstellung 
{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  },
  "availability": enum (Availability)
}
Felder
usdPrice

object (Money)

Erforderlich. Preis in US-Dollar, der für alle neuen Regionen verwendet werden soll, in denen Play eingeführt wird.
eurPrice

object (Money)

Erforderlich. Preis in EUR, der für alle neuen Regionen verwendet werden soll, in denen Google Play eingeführt wird.
availability

enum (Availability)

Erforderlich. Die regionale Verfügbarkeit für die neue Regionskonfiguration. Wenn diese Option auf „VERFÜGBAR“ festgelegt ist, werden die Preisinformationen für alle neuen Regionen verwendet, in denen Google Play in Zukunft eingeführt wird.

Verfügbarkeit

Die Verfügbarkeit der neuen Regionskonfiguration.

Enums
AVAILABILITY_UNSPECIFIED Nicht angegebene Verfügbarkeit. Darf nicht verwendet werden.
AVAILABLE Die Konfiguration wird für alle neuen Regionen verwendet, in denen Google Play in Zukunft eingeführt wird.
NO_LONGER_AVAILABLE Die Konfiguration ist nicht mehr verfügbar und wird nicht für neue Regionen verwendet, die in Zukunft möglicherweise bei Google Play eingeführt werden. Dieser Wert kann nur verwendet werden, wenn die Verfügbarkeit zuvor auf AVAILABLE festgelegt wurde.

PurchaseOptionTaxAndComplianceSettings

Details zu Steuern, Google Play-Richtlinien und rechtlicher Compliance für Einmalkaufprodukte.

JSON-Darstellung 
{
  "withdrawalRightType": enum (WithdrawalRightType)
}
Felder
withdrawalRightType

enum (WithdrawalRightType)

Optional. Einstufung als digitale Inhalte oder Dienstleistungen für Produkte, die an Nutzer in berechtigten Regionen vertrieben werden.

Wenn nicht festgelegt, wird standardmäßig WITHDRAWAL_RIGHT_DIGITAL_CONTENT verwendet.

Weitere Informationen

Methoden

batchDelete

 Löscht ein oder mehrere Einmalkaufprodukte.

batchGet

 Liest ein oder mehrere Einmalkaufprodukte.

batchUpdate

 Erstellt oder aktualisiert ein oder mehrere Einmalkaufprodukte.

delete

 Löscht ein Einmalkaufprodukt.

get

 Liest ein einzelnes Einmalkaufprodukt.

list

 Listet alle Einmalprodukte unter einer bestimmten App auf.

patch

 Erstellt oder aktualisiert ein Einmalkaufprodukt.

Fehlercodes

Die Vorgänge dieser Ressource geben die folgenden HTTP-Fehlercodes zurück:

Fehlercode Grund Auflösung
5xx Allgemeiner Fehler auf dem Google Play-Server. Wiederholen Sie Ihre Anfrage.

Wenn das Problem weiterhin besteht, wenden Sie sich an Ihren Google Play-Kundenbetreuer oder senden Sie eine Supportanfrage. Prüfen Sie das Play-Status-Dashboard auf bekannte Ausfälle.
409 Fehler beim Aktualisieren der Gleichzeitigkeit.

Es wurde versucht, ein Objekt zu aktualisieren, das gerade aktualisiert wird. Beispiel: Ein Kauf wird bestätigt, indem gleichzeitig die Methode acknowledgePurchase() der Play Billing Library und die Methode purchases.products.acknowledge der Play Developer API aufgerufen werden.

 Wiederholen Sie Ihre Anfrage.