REST Resource: inappproducts

Ressource: InAppProduct

Ein In-App-Produkt Die Ressource für InappproductsService.

JSON-Darstellung
{
  "packageName": string,
  "sku": string,
  "status": enum (Status),
  "purchaseType": enum (PurchaseType),
  "defaultPrice": {
    object (Price)
  },
  "prices": {
    string: {
      object (Price)
    },
    ...
  },
  "listings": {
    string: {
      object (InAppProductListing)
    },
    ...
  },
  "defaultLanguage": string,
  "subscriptionPeriod": string,
  "trialPeriod": string,
  "gracePeriod": string,

  // Union field TaxAndComplianceType can be only one of the following:
  "subscriptionTaxesAndComplianceSettings": {
    object (SubscriptionTaxAndComplianceSettings)
  },
  "managedProductTaxesAndComplianceSettings": {
    object (ManagedProductTaxAndComplianceSettings)
  }
  // End of list of possible types for union field TaxAndComplianceType.
}
Felder
packageName

string

Paketname der übergeordneten App.

sku

string

Artikelnummer des Produkts, die innerhalb einer App eindeutig ist.

status

enum (Status)

Der Status des Produkts, z.B. ob es aktiv ist.

purchaseType

enum (PurchaseType)

Der Typ des Produkts, z.B. ein Abo mit automatischer Verlängerung.

defaultPrice

object (Price)

Standardpreis. Darf nicht null sein, da In-App-Produkte nie kostenlos sind. Immer in der Währung des Händlers, die für die Abrechnung festgelegt ist.

prices

map (key: string, value: object (Price))

Preise nach Käuferregion. Keiner dieser Werte darf null sein, da In-App-Produkte niemals kostenlos sind. Der Kartenschlüssel ist der Regionscode gemäß ISO 3166-2.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }

listings

map (key: string, value: object (InAppProductListing))

inappproducts.list mit lokalisierten Titel- und Beschreibungsdaten. Der Kartenschlüssel ist die Sprache der lokalisierten Daten, wie in BCP-47 definiert, z.B. „en-US“.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }

defaultLanguage

string

Standardsprache der lokalisierten Daten, wie in BCP-47 definiert, z. B. „en-US“.

subscriptionPeriod

string

Abozeitraum im ISO 8601-Format. Zulässige Werte sind P1W (eine Woche), P1M (ein Monat), P3M (drei Monate), P6M (sechs Monate) und P1Y (ein Jahr).

trialPeriod

string

Der Testzeitraum im ISO 8601-Format. Zulässige Werte liegen zwischen P7D (7 Tage) und P999D (999 Tage).

gracePeriod

string

Kulanzzeitraum des Abos im ISO 8601-Format. Entwickler können ihren Abonnenten einen Kulanzzeitraum gewähren, wenn die Zahlung für den neuen Abrechnungszeitraum abgelehnt wird. Zulässige Werte sind P0D (0 Tage), P3D (3 Tage), P7D (7 Tage), P14D (14 Tage) und P30D (30 Tage).

Union-Feld TaxAndComplianceType.

Für TaxAndComplianceType ist nur einer der folgenden Werte zulässig:

subscriptionTaxesAndComplianceSettings

object (SubscriptionTaxAndComplianceSettings)

Details zu Steuern und rechtlicher Compliance. Gilt nur für Abo-Produkte.

managedProductTaxesAndComplianceSettings

object (ManagedProductTaxAndComplianceSettings)

Details zu Steuern und rechtlicher Compliance. Gilt nur für verwaltete Produkte.

Status

Der Status eines In‑App-Produkts.

Enums
statusUnspecified Nicht angegebener Status.
active Das Produkt ist veröffentlicht und im Shop aktiv.
inactive Das Produkt ist nicht veröffentlicht und daher im Store inaktiv.

PurchaseType

Der Typ des Produkts.

Enums
purchaseTypeUnspecified Nicht angegebener Kauftyp.
managedUser Der Standardprodukttyp ist „Einmalkauf“.
subscription In-App-Produkt mit einem wiederkehrenden Zeitraum.

InAppProductListing

Store-Eintrag für ein einzelnes In-App-Produkt.

JSON-Darstellung
{
  "title": string,
  "description": string,
  "benefits": [
    string
  ]
}
Felder
title

string

Titel für den Store-Eintrag.

description

string

Beschreibung für den Store-Eintrag.

benefits[]

string

Lokalisierte Leistungsberechtigungen für ein Abo.

ManagedProductTaxAndComplianceSettings

Details zur Besteuerung und zur Einhaltung gesetzlicher Bestimmungen für verwaltete Produkte.

JSON-Darstellung
{
  "eeaWithdrawalRightType": enum (WithdrawalRightType),
  "taxRateInfoByRegionCode": {
    string: {
      object (RegionalTaxRateInfo)
    },
    ...
  },
  "isTokenizedDigitalAsset": boolean
}
Felder
eeaWithdrawalRightType

enum (WithdrawalRightType)

Einstufung als digitale Inhalte oder Dienstleistungen für Produkte, die an Nutzer im Europäischen Wirtschaftsraum (EWR) vertrieben werden. Die Widerrufsregelung, die im Rahmen des Verbraucherrechts des EWR gilt, richtet sich nach dieser Einstufung. Weitere Informationen

taxRateInfoByRegionCode

map (key: string, value: object (RegionalTaxRateInfo))

Eine Zuordnung von Regionscode zu Steuersatzdetails. Die Schlüssel sind Regionscodes, wie sie von Unicode in „CLDR“ definiert werden.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }

isTokenizedDigitalAsset

boolean

Gibt an, ob dieses In-App-Produkt als Produkt deklariert wurde, das ein tokenisiertes digitales Asset darstellt.

Methoden

batchDelete

Löscht In-App-Produkte (verwaltete Produkte oder Abos).

batchGet

Liest mehrere In-App-Produkte, die verwaltete Produkte oder Abos sein können.

batchUpdate

Aktualisiert oder fügt ein oder mehrere In-App-Produkte (verwaltete Produkte oder Abos) ein.

delete

Löscht ein In-App-Produkt (ein verwaltetes Produkt oder ein Abo).

get

Er erhält ein In-App-Produkt, das ein verwaltetes Produkt oder ein Abo sein kann.

insert

Erstellt ein In-App-Produkt (ein verwaltetes Produkt oder ein Abo).

list

Listet alle In-App-Produkte auf, sowohl verwaltete Produkte als auch Abos.

patch

Patches für ein In-App-Produkt (ein verwaltetes Produkt oder ein Abo).

update

Aktualisiert ein In-App-Produkt (ein verwaltetes Produkt oder ein Abo).

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.