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

Die Artikelnummer (SKU) des Produkts, eindeutig innerhalb einer App.

status

enum (Status)

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

purchaseType

enum (PurchaseType)

Der Typ des Produkts, z.B. ein wiederkehrendes Abo.

defaultPrice

object (Price)

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

prices

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

Preise pro Käuferregion. Keine dieser Werte darf null sein, da In-App-Produkte nie 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: Liste der lokalisierten Titel- und Beschreibungsdaten. Der Kartenschlüssel ist die Sprache der lokalisierten Daten gemäß BCP-47, 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

Die Standardsprache der lokalisierten Daten gemäß BCP-47, 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

Testzeitraum im ISO 8601-Format. Zulässige Werte sind P7D (7 Tage) bis P999D (999 Tage).

gracePeriod

string

Kulanzzeitraum des Abos im ISO 8601-Format. Damit können Entwickler ihren Abonnenten einen Kulanzzeitraum gewähren, wenn die Zahlung für den neuen wiederkehrenden Zeitraum abgelehnt wird. Zulässige Werte sind P0D (null Tage), P3D (drei Tage), P7D (sieben 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 Aboprodukte.

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 Store 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 – einmaliger Kauf.
subscription In-App-Produkt mit wiederkehrendem Zeitraum

InAppProductListing

Store-Eintrag eines einzelnen In-App-Produkts.

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

string

Titel für den Store-Eintrag.

description

string

Beschreibung des Store-Eintrags.

benefits[]

string

Lokalisierte Leistungsvorteile für ein Abo.

ManagedProductTaxAndComplianceSettings

Details zu Steuern und rechtlicher Compliance 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 finden Sie in diesem Hilfeartikel.

taxRateInfoByRegionCode

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

Eine Zuordnung des Regionscodes zu Steuersatzdetails. Die Schlüssel sind Regionscodes, wie sie von Unicodes „CLDR“ definiert sind.

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

isTokenizedDigitalAsset

boolean

Ob dieses In-App-Produkt als Produkt deklariert ist, 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

Ein In-App-Produkt wird abgerufen. Das kann ein verwaltetes Produkt oder ein Abo sein.

insert

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

list

Hier werden alle In-App-Produkte aufgelistet, 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).