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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "subscriptionTaxesAndComplianceSettings": {
    object (SubscriptionTaxAndComplianceSettings)
  },
  "managedProductTaxesAndComplianceSettings": {
    object (ManagedProductTaxAndComplianceSettings)
  }
  // End of mutually exclusive fields.
}
Felder
packageName

string

Paketname der übergeordneten App.
sku

string

Artikelnummer (SKU) 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 wiederkehrendes Abo.
defaultPrice

object (Price)

Standardpreis. Darf nicht null sein, da In-App-Produkte nie kostenlos sind. Immer in der Checkout-Händlerwährung des Entwicklers.
prices

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

Preise nach Käuferregion. Keiner 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 mit lokalisierten Titel- und Beschreibungsdaten. Der Map-Schlüssel ist die Sprache der lokalisierten Daten, wie durch 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
(deprecated)

string

Eingestellt: Abos werden in der InAppProducts API nicht mehr unterstützt. Verwende stattdessen die Subscriptions API.
trialPeriod
(deprecated)

string

Eingestellt: Abos werden in der InAppProducts API nicht mehr unterstützt. Verwende stattdessen die Subscriptions API.
gracePeriod
(deprecated)

string

Eingestellt: Abos werden in der InAppProducts API nicht mehr unterstützt. Verwende stattdessen die Subscriptions API.
Im Folgenden finden Sie eine Liste der Felder, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
subscriptionTaxesAndComplianceSettings
(deprecated)

object (SubscriptionTaxAndComplianceSettings)

Eingestellt: Abos werden in der InAppProducts API nicht mehr unterstützt. Verwende stattdessen die Subscriptions API.
managedProductTaxesAndComplianceSettings

object (ManagedProductTaxAndComplianceSettings)

Details zu Steuern und Compliance. Gilt nur für verwaltete Produkte.
Ende der sich gegenseitig ausschließenden Felder.

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 – Einmalkauf.
subscription

Eingestellt: Abos werden in der InAppProducts API nicht mehr unterstützt. Verwende stattdessen die Subscriptions API.

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 für den Store-Eintrag.
benefits[]
(deprecated)

string

Eingestellt: Abos werden in der InAppProducts API nicht mehr unterstützt. Verwende stattdessen die Subscriptions API.

ManagedProductTaxAndComplianceSettings

Details zu Steuern und Compliance für verwaltete Produkte.

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

enum (WithdrawalRightType)

Klassifizierung als digitale Inhalte oder Dienst für Produkte, die an Nutzer im Europäischen Wirtschaftsraum (EWR) vertrieben werden. Die Widerrufsregelung, die im Rahmen der Verbraucherschutzgesetze im EWR gilt, richtet sich nach dieser Einstufung. Weitere Informationen finden Sie in diesem Hilfeartikel.
taxRateInfoByRegionCode

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

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

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 ist, das ein tokenisiertes digitales Asset darstellt.
regionalProductAgeRatingInfos[]

object (RegionalProductAgeRatingInfo)

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

string

Der Code der Produktsteuerkategorie, der dem In-App-Produkt zugewiesen werden soll. Die Produktsteuerkategorie bestimmt die Transaktionssteuersätze, die auf das Produkt angewendet werden. Weitere Informationen finden Sie in diesem Hilfeartikel.

Methoden

batchDelete

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

batchGet

 Liest mehrere In-App-Produkte, bei denen es sich um verwaltete Produkte oder Abos handeln kann.

batchUpdate

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

delete

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

get

 Ruft ein In-App-Produkt ab, 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

 Patcht 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