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 wird im ISO 8601-Format angegeben. 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,
  "regionalProductAgeRatingInfos": [
    {
      object (RegionalProductAgeRatingInfo)
    }
  ],
  "productTaxCategoryCode": string
}
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.
regionalProductAgeRatingInfos[]

object (RegionalProductAgeRatingInfo)

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

string

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

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 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.