ตามที่อธิบายไว้ในการประกาศการดำเนินการ เมื่อผู้ใช้โต้ตอบกับการกระทำในแอป Google จะส่งคำขอ HTTP ไปยัง URL ที่ประกาศในการดำเนินการนั้น
ตัวอย่างต่อไปนี้จะเพิ่มปุ่ม ConfirmAction
ลงในอีเมลเกี่ยวกับรายงานค่าใช้จ่าย
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "EmailMessage",
"potentialAction": {
"@type": "ConfirmAction",
"name": "Approve Expense",
"handler": {
"@type": "HttpActionHandler",
"url": "https://myexpenses.com/approve?expenseId=abc123"
}
},
"description": "Approval request for John's $10.13 expense for office supplies"
}
</script>
Microdata
<div itemscope itemtype="http://schema.org/EmailMessage">
<div itemprop="potentialAction" itemscope itemtype="http://schema.org/ConfirmAction">
<meta itemprop="name" content="Approve Expense"/>
<div itemprop="handler" itemscope itemtype="http://schema.org/HttpActionHandler">
<link itemprop="url" href="https://myexpenses.com/approve?expenseId=abc123"/>
</div>
</div>
<meta itemprop="description" content="Approval request for John's $10.13 expense for office supplies"/>
</div>
เมื่อผู้ใช้คลิกที่ปุ่ม ระบบจะออกคำขอ HTTP จาก Google ไปยังบริการของคุณเพื่อบันทึกการยืนยัน บริการของคุณได้รับคำขอ HTTP ต่อไปนี้จาก Google:
POST /approve?expenseId=abc123 HTTP/1.1
Host: your-domain.com
Authorization: Bearer AbCdEf123456
Content-Type: application/x-www-form-urlencoded
User-Agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/1.0 (KHTML, like Gecko; Gmail Actions)
confirmed=Approved
ส่วนที่เหลือของหน้านี้จะอธิบายสิ่งที่บริการที่ https://your-domain.com/approve?expenseId=abc123
ต้องทำเพื่อจัดการกับการดำเนินการอย่างถูกต้อง รวมถึงกรณีต่อไปนี้
- กำลังยืนยันคำขอ
- กำลังประมวลผลเพย์โหลด
- การแสดงโค้ดตอบกลับ
ขั้นตอนที่ 1: ยืนยันคำขอ
ขอแนะนำให้ใช้บริการที่ https://your-domain.com/approve?expenseId=abc123
ตรวจสอบรายการต่อไปนี้
- โทเค็นเพื่อการเข้าถึงแบบจํากัด - เพื่อป้องกันการโจมตีในการเล่นซ้ำ
- User Agent - เพื่อให้แน่ใจว่าคำขอมาจาก Google
- โทเค็นสำหรับผู้ถือ - เพื่อรับประกันว่าคำขอที่มาจาก Google มีเจตนาที่จะให้บริการ
User Agent สำหรับคำขอการดำเนินการทั้งหมดคือ Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/1.0 (KHTML, like Gecko; Gmail Actions)
หากการตรวจสอบทั้งหมดผ่าน บริการจะสามารถทำขั้นตอนถัดไป
ขั้นตอนที่ 2: ประมวลผลการดำเนินการ
บริการควรประมวลผลการดำเนินการตามที่ระบุในพารามิเตอร์ของ URL รวมถึงข้อมูลเพิ่มเติมที่รวบรวมจากผู้ใช้
ข้อมูลเพิ่มเติมจากผู้ใช้จะอยู่ในเนื้อหาของคำขอ และมีการเข้ารหัสโดยใช้การเข้ารหัส x-www-form-urlecoded ข้อมูลจะมีการตั้งค่าในพร็อพเพอร์ตี้ที่มีชื่อสอดคล้องกับคุณสมบัติของการดำเนินการ ตัวอย่างเช่น ConfirmAction มีพร็อพเพอร์ตี้ confirmed
ขั้นตอนที่ 3: ส่งคืนโค้ดตอบกลับ
เมื่อบริการประมวลผลและบันทึกการดำเนินการสำเร็จแล้ว บริการควรแสดงรหัสตอบกลับ 200 (OK)
โค้ดตอบกลับต่อไปนี้อาจใช้ในสถานการณ์ที่เกิดข้อผิดพลาด
โค้ดตอบกลับ | กลุ่มทดสอบ |
---|---|
400 (คำขอไม่ถูกต้อง) | Google จะไม่ดำเนินการดังกล่าว |
401 (ไม่ได้รับอนุญาต) | Google จะไม่ดำเนินการดังกล่าว |
404 (ไม่พบ) | Google จะไม่ดำเนินการดังกล่าว |
408 (คำขอหมดเวลา) | Google จะลองอีกครั้งในภายหลัง |
ในกรณีที่ดำเนินการไม่สำเร็จถาวร Google จะแจ้งผู้ใช้ว่าการดำเนินการล้มเหลว และผู้ใช้ควรทำตามวิธีการอื่นๆ ภายในอีเมล