REST Resource: externaltransactions

ทรัพยากร: ExternalTransaction

รายละเอียดธุรกรรมภายนอก

การแสดง JSON 
{
  "packageName": string,
  "externalTransactionId": string,
  "originalPreTaxAmount": {
    object (Price)
  },
  "originalTaxAmount": {
    object (Price)
  },
  "currentPreTaxAmount": {
    object (Price)
  },
  "currentTaxAmount": {
    object (Price)
  },
  "testPurchase": {
    object (ExternalTransactionTestPurchase)
  },
  "transactionTime": string,
  "createTime": string,
  "transactionState": enum (TransactionState),
  "userTaxAddress": {
    object (ExternalTransactionAddress)
  },
  "transactionProgramCode": integer,

  // Union field transaction_type can be only one of the following:
  "oneTimeTransaction": {
    object (OneTimeExternalTransaction)
  },
  "recurringTransaction": {
    object (RecurringExternalTransaction)
  }
  // End of list of possible types for union field transaction_type.
}
ช่อง
packageName

string

เอาต์พุตเท่านั้น ชื่อแหล่งข้อมูลของธุรกรรมภายนอก ชื่อแพ็กเกจของแอปพลิเคชันที่จำหน่ายไอเทมที่ซื้อในแอป (เช่น "com.some.app")
externalTransactionId

string

เอาต์พุตเท่านั้น รหัสของธุรกรรมนี้ รหัสธุรกรรมทั้งหมดภายใต้ชื่อแพ็กเกจเดียวกันต้องไม่ซ้ำกัน ตั้งค่าเมื่อสร้างธุรกรรมภายนอก
originalPreTaxAmount

object (Price)

ต้องระบุ จํานวนเงินเดิมของธุรกรรมก่อนหักภาษี ตัวเลขนี้แสดงถึงจำนวนเงินก่อนหักภาษีที่แจ้งให้ Google ทราบในตอนแรกก่อนที่จะมีการคืนเงิน
originalTaxAmount

object (Price)

ต้องระบุ จํานวนภาษีเดิม ตัวเลขนี้แสดงถึงจำนวนภาษีที่แจ้งให้ Google ทราบในตอนแรกก่อนที่จะมีการคืนเงิน
currentPreTaxAmount

object (Price)

เอาต์พุตเท่านั้น จํานวนเงินธุรกรรมปัจจุบันก่อนหักภาษี ตัวเลขนี้แสดงถึงจำนวนเงินก่อนหักภาษีปัจจุบัน รวมถึงการคืนเงินใดๆ ที่อาจมีผลกับธุรกรรมนี้
currentTaxAmount

object (Price)

เอาต์พุตเท่านั้น จํานวนภาษีปัจจุบัน ตัวเลขนี้แสดงถึงจำนวนภาษีปัจจุบัน รวมถึงการคืนเงินใดๆ ที่ใช้กับธุรกรรมนี้
testPurchase

object (ExternalTransactionTestPurchase)

เอาต์พุตเท่านั้น หากตั้งค่าไว้ ธุรกรรมนี้เป็นการซื้อทดสอบ Google จะไม่เรียกเก็บเงินสำหรับธุรกรรมการทดสอบ
transactionTime

string (Timestamp format)

ต้องระบุ เวลาที่ทำธุรกรรมเสร็จสมบูรณ์

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
createTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่สร้างธุรกรรมนี้ ซึ่งเป็นเวลาที่ Google ได้รับแจ้งเกี่ยวกับธุรกรรม

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
transactionState

enum (TransactionState)

เอาต์พุตเท่านั้น สถานะปัจจุบันของธุรกรรม
userTaxAddress

object (ExternalTransactionAddress)

ต้องระบุ ที่อยู่ของผู้ใช้สำหรับการคำนวณภาษี
transactionProgramCode

integer

ไม่บังคับ รหัสโปรแกรมธุรกรรมที่ใช้เพื่อช่วยกำหนดค่าบริการสำหรับแอปที่มีสิทธิ์เข้าร่วมโปรแกรมพาร์ทเนอร์ นักพัฒนาแอปที่เข้าร่วม Play Media Experience Program (https://play.google.com/console/about/programs/mediaprogram/) จะต้องระบุรหัสโปรแกรมเมื่อรายงานธุรกรรมการเรียกเก็บเงินระบบอื่น หากคุณเป็นนักพัฒนาแอปที่มีสิทธิ์ โปรดติดต่อ BDM เพื่อขอข้อมูลเพิ่มเติมเกี่ยวกับวิธีตั้งค่าช่องนี้ หมายเหตุ: ช่องนี้ใช้กับธุรกรรมของข้อเสนอภายนอกไม่ได้
ฟิลด์สหภาพ transaction_type ประเภทธุรกรรมที่ดำเนินการ transaction_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
oneTimeTransaction

object (OneTimeExternalTransaction)

การดำเนินการนี้เป็นธุรกรรมแบบครั้งเดียวและไม่ได้เป็นส่วนหนึ่งของการสมัครใช้บริการ
recurringTransaction

object (RecurringExternalTransaction)

ธุรกรรมนี้เป็นส่วนหนึ่งของชุดธุรกรรมที่เกิดซ้ำ

ExternalTransactionTestPurchase

ประเภทนี้ไม่มีช่อง

แสดงธุรกรรมที่ดำเนินการโดยใช้บัญชีทดสอบ Google จะไม่เรียกเก็บเงินสำหรับธุรกรรมเหล่านี้

OneTimeExternalTransaction

แสดงถึงธุรกรรมแบบครั้งเดียว

การแสดง JSON 
{
  "externalTransactionToken": string
}
ช่อง
externalTransactionToken

string

อินพุตเท่านั้น ระบุระหว่างการเรียกใช้ Create ดึงมาจากไคลเอ็นต์เมื่อเปิดใช้ขั้นตอนการเรียกเก็บเงินระบบอื่น

RecurringExternalTransaction

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

การแสดง JSON 
{

  // Union field source can be only one of the following:
  "initialExternalTransactionId": string,
  "externalTransactionToken": string,
  "migratedTransactionProgram": enum (ExternalTransactionProgram)
  // End of list of possible types for union field source.

  // Union field product_details can be only one of the following:
  "externalSubscription": {
    object (ExternalSubscription)
  },
  "otherRecurringProduct": {
    object (OtherRecurringProduct)
  }
  // End of list of possible types for union field product_details.
}
ช่อง

ฟิลด์สหภาพ source

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

string

รหัสธุรกรรมภายนอกของธุรกรรมแรกของชุดธุรกรรมที่เกิดซ้ำนี้ เช่น สำหรับการสมัครใช้บริการ รหัสนี้จะถือเป็นรหัสธุรกรรมของการชำระเงินครั้งแรก ต้องระบุเมื่อสร้างธุรกรรมภายนอกที่เกิดซ้ำ
externalTransactionToken

string

อินพุตเท่านั้น ระบุระหว่างการเรียกใช้ Create ดึงมาจากไคลเอ็นต์เมื่อเปิดใช้ขั้นตอนการเรียกเก็บเงินระบบอื่น จำเป็นสำหรับการซื้อครั้งแรกเท่านั้น
migratedTransactionProgram

enum (ExternalTransactionProgram)

อินพุตเท่านั้น ระบุระหว่างการเรียกใช้ Create ต้องใช้งานเมื่อย้ายข้อมูลการสมัครใช้บริการจากการรายงานรายเดือนด้วยตนเองเป็นการรายงานอัตโนมัติเท่านั้น
ฟิลด์สหภาพ product_details ต้องระบุ รายละเอียดของผลิตภัณฑ์ในธุรกรรมภายนอกตามรอบ product_details ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
externalSubscription

object (ExternalSubscription)

รายละเอียดการสมัครใช้บริการภายนอก
otherRecurringProduct

object (OtherRecurringProduct)

รายละเอียดของผลิตภัณฑ์ธุรกรรมภายนอกตามรอบซึ่งไม่ได้อยู่ในหมวดหมู่ที่เฉพาะเจาะจงอื่นๆ

ExternalTransactionProgram

แสดงโปรแกรมธุรกรรมภายนอกที่ผู้ใช้พบเพื่อทำธุรกรรมให้เสร็จสมบูรณ์

Enum
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED โปรแกรมธุรกรรมที่ไม่ระบุ ไม่ใช้
USER_CHOICE_BILLING การเรียกเก็บเงินแบบให้ผู้ใช้ตัดสินใจ ซึ่งผู้ใช้สามารถเลือกระหว่างการเรียกเก็บเงินที่จัดการโดยนักพัฒนาแอปกับ Google Play Billing
ALTERNATIVE_BILLING_ONLY การเรียกเก็บเงินระบบอื่นเท่านั้น ซึ่งผู้ใช้จะใช้ได้เฉพาะการเรียกเก็บเงินแบบนักพัฒนาแอปกับผู้จัดการเท่านั้น

ExternalSubscription

รายละเอียดการสมัครใช้บริการภายนอก

การแสดง JSON 
{
  "subscriptionType": enum (SubscriptionType)
}
ช่อง
subscriptionType

enum (SubscriptionType)

ต้องระบุ ประเภทการสมัครใช้บริการภายนอก

SubscriptionType

ประเภทของการสมัครใช้บริการภายนอก

Enum
SUBSCRIPTION_TYPE_UNSPECIFIED ไม่ระบุ โปรดอย่าใช้
RECURRING การสมัครใช้บริการแบบตามรอบนี้จะเรียกเก็บเงินจากผู้ใช้ทุกรอบการเรียกเก็บเงิน
PREPAID เป็นการสมัครใช้บริการแบบชำระเงินล่วงหน้าที่ผู้ใช้ชำระเงินล่วงหน้า

OtherRecurringProduct

ประเภทนี้ไม่มีช่อง

รายละเอียดของผลิตภัณฑ์ธุรกรรมภายนอกที่เกิดขึ้นซ้ำซึ่งไม่ได้อยู่ในหมวดหมู่อื่นๆ ที่เฉพาะเจาะจงมากขึ้น

TransactionState

สถานะของธุรกรรมที่กำลังทำ

Enum
TRANSACTION_STATE_UNSPECIFIED สถานะธุรกรรมที่ไม่ระบุ ไม่ใช้
TRANSACTION_REPORTED รายงานธุรกรรมไปยัง Google เรียบร้อยแล้ว
TRANSACTION_CANCELED ธุรกรรมได้รับการคืนเงินเต็มจำนวนแล้ว

ExternalTransactionAddress

ที่อยู่ของผู้ใช้สำหรับธุรกรรมภายนอก

การแสดง JSON 
{
  "regionCode": string,
  "administrativeArea": string
}
ช่อง
regionCode

string

ต้องระบุ รหัสภูมิภาค 2 ตัวตาม ISO-3166-1 Alpha-2 (รหัสภูมิภาคของ UN)
administrativeArea

string

ไม่บังคับ เขตบริหารย่อยระดับบนสุดของประเทศ/ภูมิภาค จำเป็นสำหรับธุรกรรมในอินเดียเท่านั้น ค่าที่ใช้ได้มีดังนี้ "ANDAMAN AND NICOBAR ISLANDS", "ANDHRA PRADESH", "ARUNACHAL PRADESH", "ASSAM", "BIHAR", "CHANDIGARH", "CHHATTISGARH", "DADRA AND NAGAR HAVELI", "DADRA AND NAGAR HAVELI AND DAMAN AND DIU", "DAMAN AND DIU", "DELHI", "GOA", "GUJARAT", "HARYANA", "HIMACHAL PRADESH", "JAMMU AND KASHMIR", "JHARKHAND", "KARNATAKA", "KERALA", "LADAKH", "LAKSHADWEEP", "MADHYA PRADESH", "MAHARASHTRA", "MANIPUR", "MEGHALAYA", "MIZORAM", "NAGALAND", "ODISHA", "PUDUCHERRY", "PUNJAB", "RAJASTHAN", "SIKKIM", "TAMIL NADU", "TELANGANA", "TRIPURA", "UTTAR PRADESH", "UTTARAKHAND" และ "WEST BENGAL"

เมธอด

createexternaltransaction

 สร้างธุรกรรมภายนอกใหม่

getexternaltransaction

 รับธุรกรรมภายนอกที่มีอยู่

refundexternaltransaction

 คืนเงินหรือคืนเงินบางส่วนสำหรับธุรกรรมภายนอกที่มีอยู่