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. Darf keine doppelten Einträge mit demselben „languageCode“ enthalten.
taxAndComplianceSettings

object (OneTimeProductTaxAndComplianceSettings)

Details zu Steuern und rechtlicher Compliance.
purchaseOptions[]

object (OneTimeProductPurchaseOption)

Erforderlich. Die Gruppe der 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 das Feld leer ist, gelten keine Zahlungsbeschränkungen für Länder und Regionen.
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,
  "regionalProductAgeRatingInfos": [
    {
      object (RegionalProductAgeRatingInfo)
    }
  ],
  "productTaxCategoryCode": string
}
Felder
regionalTaxConfigs[]

object (RegionalTaxConfig)

Regionale Steuerkonfiguration
isTokenizedDigitalAsset

boolean

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

object (RegionalProductAgeRatingInfo)

Regionale Informationen zur Altersfreigabe Derzeit wird dieses Feld nur für den Ländercode US unterstützt.
productTaxCategoryCode

string

Code der Produktsteuerkategorie, die dem Einmalkaufprodukt zugewiesen werden soll. Die Produktsteuerkategorie bestimmt die auf das Produkt angewendeten Transaktionssteuersätze. Weitere Informationen

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, um einen ermäßigten Steuersatz anzugeben. 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. Der Text muss mit einer Zahl oder einem Kleinbuchstaben beginnen und darf nur Kleinbuchstaben (a–z), Zahlen (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 Abrechnungsbibliothek 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. Genau eines muss 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.

Bundesland

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, für den diese Konfiguration gilt, wie in ISO 3166-2 definiert, 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.
AVAILABLE_FOR_OFFERS_ONLY Die Kaufoption ist nicht verfügbar, aber die damit verknüpften Angebote (z.B. Play Points-Angebote) sind verfügbar.

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 Beschreibung Auflösung
400 invalidValue In der Anfrage wurde ein ungültiger Wert angegeben. Dieser Fehler wird häufig zurückgegeben, wenn das Kauf-Token fehlerhaft oder ungültig ist. Korrigieren Sie den ungültigen Feldwert im Anfragetext oder in den Parametern anhand der API-Referenz.
400 required In der Anfrage fehlt ein erforderliches Feld oder ein erforderlicher Parameter. In der API-Dokumentation finden Sie Informationen dazu, ob alle Pflichtfelder und ‑parameter enthalten sind.
403 userInsufficientPermission Der Nutzer hat nicht die erforderlichen Berechtigungen, um den angeforderten Vorgang auszuführen. Prüfen Sie, ob der authentifizierte Nutzer die erforderlichen Berechtigungen in der Google Play Console hat. Weitere Informationen finden Sie unter Dienstkonto verwenden.
404 notFound Die angeforderte Ressource wurde nicht gefunden. Prüfen Sie, ob die Kennzeichnungen (z.B. Kauf-Token, Paketname, Produkt-ID, Abo-ID) korrekt sind.
409 concurrentUpdate Es wurde versucht, ein Objekt zu aktualisieren, das gleichzeitig aktualisiert wird. Wiederholen Sie die Anfrage mit exponentiellem Backoff. Vermeiden Sie gleichzeitige Änderungen an derselben Ressource.
5xx Generic error 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 im Play-Status-Dashboard, ob bekannte Ausfälle vorliegen.