Transactions API will be deprecated on May 3, 2023, ahead of the Conversational Actions sunset on June 13, 2023. For more information, see
Conversational Actions sunset .
Actions on Google Orders API (Dialogflow)
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
คำเตือน: ฟังก์ชันการทำงานด้านธุรกรรมเนื่องด้วยข้อกำหนดทางกฎหมายใหม่
สำหรับการดำเนินการแบบการสนทนา (Conversational Actions) ไม่มีให้บริการในประเทศต่อไปนี้
เดนมาร์ก ฝรั่งเศส เยอรมนี อิตาลี เนเธอร์แลนด์ นอร์เวย์ โปแลนด์ สเปน สวีเดน
การดำเนินการที่มีธุรกรรมจะใช้งานได้ต่อไปในทุกภาษาที่รองรับ
Actions on Google Orders API ทำให้นักพัฒนาซอฟต์แวร์สามารถจัดการธุรกรรมสำหรับ
ที่จับต้องได้ในการดำเนินการ
คำขอการตรวจสอบสิทธิ์
การเข้าถึงปลายทางของ API ต้องมีการตรวจสอบสิทธิ์ OAuth 2.0 คุณต้องมี
โทเค็นผู้ใช้ OAuth 2.0 ได้รับอนุญาตสำหรับขอบเขต https://www.googleapis.com/auth/actions.order
ในการรับโทเค็น คุณสามารถใช้ขั้นตอนที่ใช้ได้
ยกเว้นขั้นตอนของบัญชีบริการ
ข้อมูลโค้ดต่อไปนี้มีเพย์โหลด JSON ของคำสั่งซื้อตัวอย่าง
{
"order" : {
"merchantOrderId" : "1234" ,
"userVisibleOrderId" : "6789" ,
"userVisibleStateLabel" : "CONFIRMED" ,
"buyerInfo" : {
"email" : "xyz@example.com" ,
"firstName" : "Jane" ,
"lastName" : "Doe" ,
"displayName" : "Jane Doe" ,
"phoneNumbers" : [
{
"e164PhoneNumber" : "+1234567890"
}
]
},
"image" : {
"url" : "www.someurl.com"
},
"createTime" : "2017-01-15T01:30:15.01Z" ,
"lastUpdateTime" : "2017-01-15T01:30:15.01Z" ,
"transactionMerchant" : {
"id" : "www.examplemerchant.com" ,
"name" : "Example Merchant" ,
"image" : {
"url" : "www.someurl.com"
},
"phoneNumbers" : [
{
"e164PhoneNumber" : "+11112223333"
}
],
"address" : {
"zipCode" : "94043" ,
"city" : "Mountain View" ,
"postalAddress" : {
"regionCode" : "US" ,
"postalCode" : "94043" ,
"administrativeArea" : "CA" ,
"locality" : "Mountain View" ,
"addressLines" : [
"1600, Amphiteatre Parkway"
]
}
}
},
"contents" : {
"lineItems" : [
{
"id" : "1" ,
"name" : "Pizza Extreme" ,
"description" : "Has everything a pizza should have" ,
"notes" : [
"Vegetarian please"
],
"priceAttributes" : [
{
"type" : "REGULAR" ,
"name" : "Item Price" ,
"state" : "ACTUAL" ,
"amount" : {
"currencyCode" : "USD" ,
"amountInMicros" : "6000000"
},
"taxIncluded" : false
}
],
"vertical" : {
"@type" : "type.googleapis.com/google.actions.orders.v3.verticals.purchase.PurchaseItemExtension" ,
"productId" : "www.examplemerchant.com/123/3333" ,
"quantity" : 1 ,
"itemOptions" : [
{
"id" : "" ,
"name" : "" ,
"prices" : [
{
"type" : "REGULAR" ,
"name" : "Item Price" ,
"state" : "ACTUAL" ,
"amount" : {
"currencyCode" : "USD" ,
"amountInMicros" : "2000000"
},
"taxIncluded" : false
}
],
"quantity" : 1 ,
"productId" : "www.examplemerchant.com/123/3333/1" ,
"subOptions" : []
}
]
},
"provider" : {
"id" : "www.examplemerchant2.com/123" ,
"name" : "Example Merchant 2" ,
"image" : {},
"phoneNumbers" : [
{
"e164PhoneNumber" : "+11112223333"
}
],
"address" : {
"zipCode" : "94043" ,
"city" : "Mountain View" ,
"postalAddress" : {
"regionCode" : "US" ,
"postalCode" : "94043" ,
"administrativeArea" : "CA" ,
"locality" : "Mountain View" ,
"addressLines" : [
"1350 Charleston Road"
]
}
}
}
}
]
},
"priceAttributes" : [
{
"type" : "TOTAL" ,
"name" : "Total Price" ,
"state" : "ACTUAL" ,
"amount" : {
"currencyCode" : "USD" ,
"amountInMicros" : "10000000"
},
"taxIncluded" : true
},
{
"type" : "TAX" ,
"name" : "Tax" ,
"state" : "ACTUAL" ,
"amount" : {
"currencyCode" : "USD" ,
"amountInMicros" : "2000000"
},
"taxIncluded" : true
},
{
"type" : "SUBTOTAL" ,
"name" : "Subtotal" ,
"state" : "ACTUAL" ,
"amount" : {
"currencyCode" : "USD" ,
"amountInMicros" : "6000000"
},
"taxIncluded" : false
},
{
"type" : "DELIVERY" ,
"name" : "Delivery" ,
"state" : "ACTUAL" ,
"amount" : {
"currencyCode" : "USD" ,
"amountInMicros" : "2000000"
},
"taxIncluded" : false
}
],
"followUpActions" : [
{
"type" : "CALL" ,
"title" : "Call us" ,
"openUrlAction" : {
"url" : "tel:+16501112222"
}
},
{
"type" : "EMAIL" ,
"title" : "Email us" ,
"openUrlAction" : {
"url" : "mailto:person@example.com"
}
}
],
"paymentData" : {
"paymentInfo" : {
"paymentMethodDisplayInfo" : {
"paymentType" : "PAYMENT_CARD" ,
"paymentMethodDisplayName" : "VISA **** 1234"
},
"paymentMethodProvenance" : "PAYMENT_METHOD_PROVENANCE_GOOGLE"
}
},
"termsOfServiceUrl" : "www.examplemerchant.com/policy" ,
"note" : "Vegetarian only" ,
"vertical" : {
"@type" : "type.googleapis.com/google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension" ,
"status" : "IN_PREPARATION" ,
"type" : "FOOD" ,
"returnsInfo" : {
"isReturnable" : false
},
"fulfillmentInfo" : {
"id" : "www.examplemerchant.com/merchant-id/123" ,
"fulfillmentType" : "DELIVERY" ,
"expectedFulfillmentTime" : {
"timeIso8601" : "PT10M"
},
"location" : {
"zipCode" : "94086" ,
"city" : "Sunnyvale" ,
"postalAddress" : {
"regionCode" : "US" ,
"postalCode" : "94086" ,
"administrativeArea" : "CA" ,
"locality" : "Sunnyvale" ,
"addressLines" : [
"222, Some other Street"
]
}
},
"price" : {
"type" : "REGULAR" ,
"name" : "Delivery Price" ,
"state" : "ACTUAL" ,
"amount" : {
"currencyCode" : "USD" ,
"amountInMicros" : "2000000"
},
"taxIncluded" : "FALSE"
},
"fulfillmentContact" : {
"email" : "xyz@example.com" ,
"firstName" : "Jane" ,
"lastName" : "Doe" ,
"displayName" : "Jane Doe" ,
"phoneNumbers" : [
{
"e164PhoneNumber" : "+16507146554"
}
]
}
}
}
}
}
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-28 UTC
[[["เข้าใจง่าย","easyToUnderstand","thumb-up"],["แก้ปัญหาของฉันได้","solvedMyProblem","thumb-up"],["อื่นๆ","otherUp","thumb-up"]],[["ไม่มีข้อมูลที่ฉันต้องการ","missingTheInformationINeed","thumb-down"],["ซับซ้อนเกินไป/มีหลายขั้นตอนมากเกินไป","tooComplicatedTooManySteps","thumb-down"],["ล้าสมัย","outOfDate","thumb-down"],["ปัญหาเกี่ยวกับการแปล","translationIssue","thumb-down"],["ตัวอย่าง/ปัญหาเกี่ยวกับโค้ด","samplesCodeIssue","thumb-down"],["อื่นๆ","otherDown","thumb-down"]],["อัปเดตล่าสุด 2025-07-28 UTC"],[[["\u003cp\u003eTransaction functionalities for Conversational Actions are unavailable in Denmark, France, Germany, Italy, the Netherlands, Norway, Poland, Spain, and Sweden due to regulatory changes.\u003c/p\u003e\n"],["\u003cp\u003eThe Actions on Google Orders API enables developers to manage transactions for physical goods within their Actions.\u003c/p\u003e\n"],["\u003cp\u003eUsing the Orders API requires OAuth 2.0 authentication with a user token authorized for the \u003ccode\u003ehttps://www.googleapis.com/auth/actions.order\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eA JSON payload example is provided to illustrate the structure of an order's data, including details like buyer information, merchant details, order contents, pricing, and fulfillment.\u003c/p\u003e\n"]]],[],null,["# Actions on Google Orders API (Dialogflow)\n\n| **Warning:** Due to new regulatory requirements, transaction functionalities for Conversational Actions are no longer available in the following countries:\n|\n|\n| Denmark, France, Germany, Italy, the Netherlands, Norway, Poland, Spain, Sweden\n|\n|\n| Actions with Transactions will continue to work in all supported locales.\n\n\u003cbr /\u003e\n\nThe Actions on Google Orders API allows developers to handle transactions for\nphysical goods in their Actions.\n\nAuthenticating requests\n-----------------------\n\nAccess to the API's endpoint requires OAuth 2.0 authentication. You need an\nOAuth 2.0 user token authorized for the `https://www.googleapis.com/auth/actions.order` scope.\n\nTo obtain the token, you can use the any of the [available flows](/identity/protocols/OAuth2),\nwith the exception of the *Service accounts* flow.\n\nThe following snippet contains an example order's JSON payload: \n\n```carbon\n{\n \"order\": {\n \"merchantOrderId\": \"1234\",\n \"userVisibleOrderId\": \"6789\",\n \"userVisibleStateLabel\": \"CONFIRMED\",\n \"buyerInfo\": {\n \"email\": \"xyz@example.com\",\n \"firstName\": \"Jane\",\n \"lastName\": \"Doe\",\n \"displayName\": \"Jane Doe\",\n \"phoneNumbers\": [\n {\n \"e164PhoneNumber\": \"+1234567890\"\n }\n ]\n },\n \"image\": {\n \"url\": \"www.someurl.com\"\n },\n \"createTime\": \"2017-01-15T01:30:15.01Z\",\n \"lastUpdateTime\": \"2017-01-15T01:30:15.01Z\",\n \"transactionMerchant\": {\n \"id\": \"www.examplemerchant.com\",\n \"name\": \"Example Merchant\",\n \"image\": {\n \"url\": \"www.someurl.com\"\n },\n \"phoneNumbers\": [\n {\n \"e164PhoneNumber\": \"+11112223333\"\n }\n ],\n \"address\": {\n \"zipCode\": \"94043\",\n \"city\": \"Mountain View\",\n \"postalAddress\": {\n \"regionCode\": \"US\",\n \"postalCode\": \"94043\",\n \"administrativeArea\": \"CA\",\n \"locality\": \"Mountain View\",\n \"addressLines\": [\n \"1600, Amphiteatre Parkway\"\n ]\n }\n }\n },\n \"contents\": {\n \"lineItems\": [\n {\n \"id\": \"1\",\n \"name\": \"Pizza Extreme\",\n \"description\": \"Has everything a pizza should have\",\n \"notes\": [\n \"Vegetarian please\"\n ],\n \"priceAttributes\": [\n {\n \"type\": \"REGULAR\",\n \"name\": \"Item Price\",\n \"state\": \"ACTUAL\",\n \"amount\": {\n \"currencyCode\": \"USD\",\n \"amountInMicros\": \"6000000\"\n },\n \"taxIncluded\": false\n }\n ],\n \"vertical\": {\n \"@type\": \"type.googleapis.com/google.actions.orders.v3.verticals.purchase.PurchaseItemExtension\",\n \"productId\": \"www.examplemerchant.com/123/3333\",\n \"quantity\": 1,\n \"itemOptions\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"prices\": [\n {\n \"type\": \"REGULAR\",\n \"name\": \"Item Price\",\n \"state\": \"ACTUAL\",\n \"amount\": {\n \"currencyCode\": \"USD\",\n \"amountInMicros\": \"2000000\"\n },\n \"taxIncluded\": false\n }\n ],\n \"quantity\": 1,\n \"productId\": \"www.examplemerchant.com/123/3333/1\",\n \"subOptions\": []\n }\n ]\n },\n \"provider\": {\n \"id\": \"www.examplemerchant2.com/123\",\n \"name\": \"Example Merchant 2\",\n \"image\": {},\n \"phoneNumbers\": [\n {\n \"e164PhoneNumber\": \"+11112223333\"\n }\n ],\n \"address\": {\n \"zipCode\": \"94043\",\n \"city\": \"Mountain View\",\n \"postalAddress\": {\n \"regionCode\": \"US\",\n \"postalCode\": \"94043\",\n \"administrativeArea\": \"CA\",\n \"locality\": \"Mountain View\",\n \"addressLines\": [\n \"1350 Charleston Road\"\n ]\n }\n }\n }\n }\n ]\n },\n \"priceAttributes\": [\n {\n \"type\": \"TOTAL\",\n \"name\": \"Total Price\",\n \"state\": \"ACTUAL\",\n \"amount\": {\n \"currencyCode\": \"USD\",\n \"amountInMicros\": \"10000000\"\n },\n \"taxIncluded\": true\n },\n {\n \"type\": \"TAX\",\n \"name\": \"Tax\",\n \"state\": \"ACTUAL\",\n \"amount\": {\n \"currencyCode\": \"USD\",\n \"amountInMicros\": \"2000000\"\n },\n \"taxIncluded\": true\n },\n {\n \"type\": \"SUBTOTAL\",\n \"name\": \"Subtotal\",\n \"state\": \"ACTUAL\",\n \"amount\": {\n \"currencyCode\": \"USD\",\n \"amountInMicros\": \"6000000\"\n },\n \"taxIncluded\": false\n },\n {\n \"type\": \"DELIVERY\",\n \"name\": \"Delivery\",\n \"state\": \"ACTUAL\",\n \"amount\": {\n \"currencyCode\": \"USD\",\n \"amountInMicros\": \"2000000\"\n },\n \"taxIncluded\": false\n }\n ],\n \"followUpActions\": [\n {\n \"type\": \"CALL\",\n \"title\": \"Call us\",\n \"openUrlAction\": {\n \"url\": \"tel:+16501112222\"\n }\n },\n {\n \"type\": \"EMAIL\",\n \"title\": \"Email us\",\n \"openUrlAction\": {\n \"url\": \"mailto:person@example.com\"\n }\n }\n ],\n \"paymentData\": {\n \"paymentInfo\": {\n \"paymentMethodDisplayInfo\": {\n \"paymentType\": \"PAYMENT_CARD\",\n \"paymentMethodDisplayName\": \"VISA **** 1234\"\n },\n \"paymentMethodProvenance\": \"PAYMENT_METHOD_PROVENANCE_GOOGLE\"\n }\n },\n \"termsOfServiceUrl\": \"www.examplemerchant.com/policy\",\n \"note\": \"Vegetarian only\",\n \"vertical\": {\n \"@type\": \"type.googleapis.com/google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension\",\n \"status\": \"IN_PREPARATION\",\n \"type\": \"FOOD\",\n \"returnsInfo\": {\n \"isReturnable\": false\n },\n \"fulfillmentInfo\": {\n \"id\": \"www.examplemerchant.com/merchant-id/123\",\n \"fulfillmentType\": \"DELIVERY\",\n \"expectedFulfillmentTime\": {\n \"timeIso8601\": \"PT10M\"\n },\n \"location\": {\n \"zipCode\": \"94086\",\n \"city\": \"Sunnyvale\",\n \"postalAddress\": {\n \"regionCode\": \"US\",\n \"postalCode\": \"94086\",\n \"administrativeArea\": \"CA\",\n \"locality\": \"Sunnyvale\",\n \"addressLines\": [\n \"222, Some other Street\"\n ]\n }\n },\n \"price\": {\n \"type\": \"REGULAR\",\n \"name\": \"Delivery Price\",\n \"state\": \"ACTUAL\",\n \"amount\": {\n \"currencyCode\": \"USD\",\n \"amountInMicros\": \"2000000\"\n },\n \"taxIncluded\": \"FALSE\"\n },\n \"fulfillmentContact\": {\n \"email\": \"xyz@example.com\",\n \"firstName\": \"Jane\",\n \"lastName\": \"Doe\",\n \"displayName\": \"Jane Doe\",\n \"phoneNumbers\": [\n {\n \"e164PhoneNumber\": \"+16507146554\"\n }\n ]\n }\n }\n }\n }\n} \n```"]]
