REST Resource: inappproducts

แหล่งข้อมูล: InAppProduct

ไอเทมที่ซื้อในแอป ทรัพยากรสำหรับ InappproductsService

การแสดง JSON 
{
  "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.
}
ช่อง
packageName

string

ชื่อแพ็กเกจของแอปหลัก
sku

string

Stock-keeping-unit (SKU) ของผลิตภัณฑ์ซึ่งไม่ซ้ำกันภายในแอป
status

enum (Status)

สถานะของผลิตภัณฑ์ เช่น ผลิตภัณฑ์ทำงานอยู่หรือไม่
purchaseType

enum (PurchaseType)

ประเภทผลิตภัณฑ์ เช่น การสมัครใช้บริการตามรอบ
defaultPrice

object (Price)

ราคาเริ่มต้น ต้องไม่ใช่ 0 เพราะไอเทมที่ซื้อในแอปไม่มีทางให้ฟรี ใช้สกุลเงินผู้ขายใน Checkout ของนักพัฒนาซอฟต์แวร์เสมอ
prices

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

ราคาต่อภูมิภาคของผู้ซื้อ สิ่งเหล่านี้เป็น 0 ไม่ได้เลย เพราะไอเทมที่ซื้อในแอปไม่มีทางให้ฟรี คีย์แผนที่คือรหัสภูมิภาคตามที่กำหนดโดย ISO 3166-2

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่างเช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }
listings

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

inappproducts.list ของข้อมูลชื่อและคำอธิบายที่แปลแล้ว คีย์แผนที่คือภาษาของข้อมูลที่แปลแล้ว ตามที่กำหนดโดย BCP-47 เช่น "en-US"

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่างเช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }
defaultLanguage

string

ภาษาเริ่มต้นของข้อมูลที่แปลแล้ว ตามที่กำหนดโดย BCP-47 เช่น "en-US"
subscriptionPeriod

string

ระยะเวลาการสมัครใช้บริการที่ระบุในรูปแบบ ISO 8601 ค่าที่ยอมรับ ได้แก่ P1W (1 สัปดาห์), P1M (1 เดือน), P3M (3 เดือน), P6M (6 เดือน) และ P1Y (1 ปี)
trialPeriod

string

ระยะทดลองที่ระบุในรูปแบบ ISO 8601 ค่าที่ยอมรับได้คือค่าใดก็ได้ระหว่าง P7D (7 วัน) ถึง P999D (999 วัน)
gracePeriod

string

ระยะเวลาผ่อนผันของการสมัครใช้บริการ ซึ่งระบุในรูปแบบ ISO 8601 อนุญาตให้นักพัฒนาแอปให้ระยะเวลาผ่อนผันแก่สมาชิกเมื่อการชำระเงินสำหรับช่วงเวลาการเกิดซ้ำใหม่ถูกปฏิเสธ ค่าที่ยอมรับได้ ได้แก่ P0D (ศูนย์วัน), P3D (3 วัน), P7D (7 วัน), P14D (14 วัน) และ P30D (30 วัน)

ฟิลด์การรวม TaxAndComplianceType

TaxAndComplianceType ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
subscriptionTaxesAndComplianceSettings

object (SubscriptionTaxAndComplianceSettings)

รายละเอียดเกี่ยวกับภาษีและการปฏิบัติตามข้อกำหนดทางกฎหมาย ใช้ได้กับผลิตภัณฑ์ที่ต้องสมัครใช้บริการเท่านั้น
managedProductTaxesAndComplianceSettings

object (ManagedProductTaxAndComplianceSettings)

รายละเอียดเกี่ยวกับภาษีและการปฏิบัติตามข้อกำหนดทางกฎหมาย ใช้ได้กับผลิตภัณฑ์ที่มีการจัดการเท่านั้น

สถานะ

สถานะของไอเทมที่ซื้อในแอป

Enum
statusUnspecified สถานะที่ไม่ได้ระบุ
active ผลิตภัณฑ์ได้รับการเผยแพร่และใช้งานอยู่ในร้านค้า
inactive ผลิตภัณฑ์ยังไม่ได้เผยแพร่จึงไม่มีการใช้งานในร้านค้า

PurchaseType

ประเภทของผลิตภัณฑ์

Enum
purchaseTypeUnspecified ไม่ได้ระบุประเภทการซื้อ
managedUser ประเภทผลิตภัณฑ์เริ่มต้น - การซื้อครั้งเดียว
subscription ไอเทมที่ซื้อในแอปตามรอบ

InAppProductListing

ข้อมูลผลิตภัณฑ์ใน Store ของไอเทมที่ซื้อในแอปรายการเดียว

การแสดง JSON 
{
  "title": string,
  "description": string,
  "benefits": [
    string
  ]
}
ช่อง
title

string

ชื่อของข้อมูลผลิตภัณฑ์ใน Store
description

string

คำอธิบายสำหรับข้อมูลผลิตภัณฑ์ใน Store
benefits[]

string

สิทธิประโยชน์ของการให้สิทธิ์ที่แปลแล้วสำหรับการสมัครใช้บริการ

ManagedProductTaxAndComplianceSettings

รายละเอียดเกี่ยวกับภาษีและการปฏิบัติตามข้อกำหนดทางกฎหมายสำหรับผลิตภัณฑ์ที่มีการจัดการ

การแสดง JSON 
{
  "eeaWithdrawalRightType": enum (WithdrawalRightType),
  "taxRateInfoByRegionCode": {
    string: {
      object (RegionalTaxRateInfo)
    },
    ...
  },
  "isTokenizedDigitalAsset": boolean
}
ช่อง
eeaWithdrawalRightType

enum (WithdrawalRightType)

การจัดหมวดหมู่เนื้อหาดิจิทัลหรือบริการสำหรับผลิตภัณฑ์ที่จัดจำหน่ายให้แก่ผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) กฎเกณฑ์ในการถอนตัวภายใต้กฎหมายคุ้มครองผู้บริโภคของ EEA จะขั้นอยู่กับการแยกประเภทนี้ ดูข้อมูลเพิ่มเติมได้ที่บทความในศูนย์ช่วยเหลือ
taxRateInfoByRegionCode

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

การเชื่อมโยงจากรหัสภูมิภาคไปยังรายละเอียดอัตราภาษี คีย์เป็นรหัสภูมิภาคตามที่กำหนดโดย "CLDR" ของ Unicode

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่างเช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }
isTokenizedDigitalAsset

boolean

ระบุว่าไอเทมที่ซื้อในแอปนี้ได้รับการประกาศว่าเป็นผลิตภัณฑ์ที่แสดงถึงเนื้อหาดิจิทัลที่แปลงข้อมูลเป็นโทเค็นหรือไม่

วิธีการ

batchDelete

 ลบไอเทมที่ซื้อในแอป (ไอเทมที่มีการจัดการหรือการสมัครใช้บริการ)

batchGet

 อ่านไอเทมที่ซื้อในแอปหลายรายการ ซึ่งอาจเป็นไอเทมที่มีการจัดการหรือการสมัครใช้บริการก็ได้

batchUpdate

 อัปเดตหรือแทรกไอเทมที่ซื้อในแอปอย่างน้อย 1 รายการ (ไอเทมที่มีการจัดการหรือการสมัครใช้บริการ)

delete

 ลบไอเทมที่ซื้อในแอป (ไอเทมที่มีการจัดการหรือการสมัครใช้บริการ)

get

 รับไอเทมที่ซื้อในแอป ซึ่งอาจเป็นไอเทมที่มีการจัดการหรือการสมัครใช้บริการก็ได้

insert

 สร้างไอเทมที่ซื้อในแอป (ไอเทมที่มีการจัดการหรือการสมัครใช้บริการ)

list

 แสดงรายการไอเทมที่ซื้อในแอปทั้งหมด ทั้งผลิตภัณฑ์ที่มีการจัดการและการสมัครใช้บริการ

patch

 แพตช์ไอเทมที่ซื้อในแอป (ไอเทมที่มีการจัดการหรือการสมัครใช้บริการ)

update

 อัปเดตไอเทมที่ซื้อในแอป (ไอเทมที่มีการจัดการหรือการสมัครใช้บริการ)