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,

  // 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.
}
ช่อง
packageName

string

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

sku

string

สต็อกคีปปิ้งยูนิต (SKU) ของผลิตภัณฑ์ ซึ่งไม่ซ้ำกันภายในแอป

status

enum (Status)

สถานะของผลิตภัณฑ์ เช่น มีการใช้งานอยู่หรือไม่

purchaseType

enum (PurchaseType)

ประเภทของผลิตภัณฑ์ เช่น การสมัครใช้บริการที่เกิดซ้ำ

defaultPrice

object (Price)

ราคาเริ่มต้น ต้องไม่เป็น 0 เนื่องจากไอเทมที่ซื้อในแอปไม่มีแบบฟรี สกุลเงินของผู้ขาย Checkout ของนักพัฒนาแอปเสมอ

prices

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

ราคาตามภูมิภาคของผู้ซื้อ ค่าเหล่านี้ต้องไม่เป็นศูนย์ เนื่องจากไอเทมที่ซื้อในแอปไม่มีแบบฟรี คีย์แผนที่คือรหัสภูมิภาคตามที่กำหนดโดย 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
(deprecated)

string

เลิกใช้งาน: InAppProducts API ไม่รองรับการสมัครใช้บริการอีกต่อไป โปรดใช้ Subscriptions API แทน

trialPeriod
(deprecated)

string

เลิกใช้งาน: InAppProducts API ไม่รองรับการสมัครใช้บริการอีกต่อไป โปรดใช้ Subscriptions API แทน

gracePeriod
(deprecated)

string

เลิกใช้งาน: InAppProducts API ไม่รองรับการสมัครใช้บริการอีกต่อไป โปรดใช้ Subscriptions API แทน

ต่อไปนี้คือรายการช่องที่แยกกันโดยสิ้นเชิง ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
subscriptionTaxesAndComplianceSettings
(deprecated)

object (SubscriptionTaxAndComplianceSettings)

เลิกใช้งาน: InAppProducts API ไม่รองรับการสมัครใช้บริการอีกต่อไป โปรดใช้ Subscriptions API แทน

managedProductTaxesAndComplianceSettings

object (ManagedProductTaxAndComplianceSettings)

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

สิ้นสุดฟิลด์ที่แยกกัน

สถานะ

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

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

PurchaseType

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

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

เลิกใช้งาน: InAppProducts API ไม่รองรับการสมัครใช้บริการอีกต่อไป โปรดใช้ Subscriptions API แทน

InAppProductListing

ข้อมูลสินค้าใน Store ของไอเทมที่ซื้อในแอปรายการเดียว

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

string

ชื่อของข้อมูลสินค้าใน Store

description

string

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

benefits[]
(deprecated)

string

เลิกใช้งาน: InAppProducts API ไม่รองรับการสมัครใช้บริการอีกต่อไป โปรดใช้ Subscriptions API แทน

ManagedProductTaxAndComplianceSettings

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

การแสดง JSON
{
  "eeaWithdrawalRightType": enum (WithdrawalRightType),
  "taxRateInfoByRegionCode": {
    string: {
      object (RegionalTaxRateInfo)
    },
    ...
  },
  "isTokenizedDigitalAsset": boolean,
  "regionalProductAgeRatingInfos": [
    {
      object (RegionalProductAgeRatingInfo)
    }
  ],
  "productTaxCategoryCode": string
}
ช่อง
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

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

regionalProductAgeRatingInfos[]

object (RegionalProductAgeRatingInfo)

ข้อมูลการจัดประเภทตามอายุในภูมิภาค ปัจจุบันช่องนี้รองรับเฉพาะรหัสภูมิภาค US เท่านั้น

productTaxCategoryCode

string

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

เมธอด

batchDelete

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

batchGet

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

batchUpdate

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

delete

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

get

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

insert

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

list

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

patch

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

update

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

รหัสข้อผิดพลาด

การดำเนินการของทรัพยากรนี้จะแสดงรหัสข้อผิดพลาดของ HTTP ต่อไปนี้

รหัสข้อผิดพลาด เหตุผล คำอธิบาย ความละเอียด