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

สต็อกคีปปิ้งยูนิต (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 (0 วัน), P3D (3 วัน), P7D (7 วัน), P14D (14 วัน) และ P30D (30 วัน)

ฟิลด์ Union TaxAndComplianceType

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

object (SubscriptionTaxAndComplianceSettings)

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

object (ManagedProductTaxAndComplianceSettings)

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

สถานะ

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

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

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

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

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

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

รหัสข้อผิดพลาด เหตุผล ความละเอียด
5xx ข้อผิดพลาดทั่วไปในเซิร์ฟเวอร์ Google Play ลองส่งคำขออีกครั้ง

หากยังคงพบปัญหาอยู่ โปรดติดต่อผู้จัดการลูกค้า Google Play หรือส่งคำขอรับการสนับสนุน โปรดตรวจสอบแดชบอร์ดสถานะของ Play เพื่อดูการหยุดทำงานที่ทราบ

409 ข้อผิดพลาดในการอัปเดตพร้อมกัน

มีการพยายามอัปเดตออบเจ็กต์ที่กำลังอัปเดตอยู่ เช่น การตอบรับการซื้อ จะทำได้โดยการเรียกใช้เมธอด acknowledgePurchase() ของ Play Billing Library และเรียกใช้ purchases.products.acknowledge ของ Play Developer API พร้อมกัน

 ลองส่งคำขออีกครั้ง