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,
  "externalOfferInitialAcquisitionDetails": {
    object (ExternalOfferInitialAcquisitionDetails)
  },

  // 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 เพื่อขอข้อมูลเพิ่มเติมเกี่ยวกับวิธีตั้งค่าช่องนี้ หมายเหตุ: ช่องนี้ใช้กับธุรกรรมของข้อเสนอภายนอกไม่ได้

externalOfferInitialAcquisitionDetails

object (ExternalOfferInitialAcquisitionDetails)

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

ช่องการรวม 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

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

ExternalOfferInitialAcquisitionDetails

รายละเอียดเกี่ยวกับครั้งแรกที่ผู้ใช้/อุปกรณ์ทำธุรกรรมโดยใช้ข้อเสนอภายนอก

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

string

ต้องระบุ รหัสธุรกรรมภายนอกของการซื้อที่เสร็จสมบูรณ์ครั้งแรกโดยผู้ใช้

เมธอด

createexternaltransaction

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

getexternaltransaction

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

refundexternaltransaction

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