ডিক্লেয়ারিং অ্যাকশনে বর্ণিত হিসাবে, যখন কোনও ব্যবহারকারী একটি ইন-অ্যাপ অ্যাকশনের সাথে ইন্টারঅ্যাক্ট করেন, তখন Google অ্যাকশনে ঘোষিত একটি URL-এ একটি HTTP অনুরোধ পাঠায়।
নিম্নলিখিত উদাহরণটি একটি খরচ রিপোর্ট সম্পর্কে একটি ইমেলে একটি 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>
মাইক্রোডেটা
<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>
ব্যবহারকারী বোতামে ক্লিক করলে, নিশ্চিতকরণ রেকর্ড করে Google থেকে আপনার পরিষেবাতে একটি HTTP অনুরোধ জারি করা হবে। আপনার পরিষেবা Google থেকে নিম্নলিখিত HTTP অনুরোধ গ্রহণ করে:
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 এর পরিষেবাটি পরীক্ষা করার জন্য উৎসাহিত করা হচ্ছে:
- সীমিত ব্যবহার অ্যাক্সেস টোকেন - রিপ্লে আক্রমণ থেকে রক্ষা করতে।
- ব্যবহারকারী এজেন্ট - অনুরোধটি Google থেকে এসেছে তা নিশ্চিত করতে।
- বিয়ারার টোকেন - Google থেকে আগত অনুরোধের নিশ্চয়তা দেওয়ার জন্য পরিষেবার উদ্দেশ্যে।
সমস্ত অ্যাকশন অনুরোধের জন্য ব্যবহারকারী এজেন্ট হল Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/1.0 (KHTML, like Gecko; Gmail Actions)
সমস্ত চেক পাস হলে, পরিষেবাটি পরবর্তী ধাপে যেতে পারে।
ধাপ 2: অ্যাকশন প্রক্রিয়া করুন
পরিষেবাটি ইউআরএল প্যারামিটারে উল্লিখিত অ্যাকশনের পাশাপাশি ব্যবহারকারীর কাছ থেকে সংগৃহীত অতিরিক্ত তথ্য প্রক্রিয়া করা উচিত।
ব্যবহারকারীর কাছ থেকে অতিরিক্ত তথ্য অনুরোধের অংশে থাকে এবং x-www-form-urlecoded এনকোডিং ব্যবহার করে এনকোড করা হয়। তথ্যগুলি এমন বৈশিষ্ট্যগুলিতে সেট করা হয়েছে যার নামগুলি অ্যাকশনের বৈশিষ্ট্যগুলির সাথে মিলে যায়৷ উদাহরণস্বরূপ, ConfirmAction এর সম্পত্তি confirmed করা হয়েছে।
ধাপ 3: একটি প্রতিক্রিয়া কোড ফেরত দিন
একবার পরিষেবাটি প্রক্রিয়াকরণ এবং ক্রিয়াটি সফলভাবে রেকর্ড করার পরে, এটি একটি প্রতিক্রিয়া কোড 200 (OK) ফেরত দেবে। নিম্নলিখিত প্রতিক্রিয়া কোডগুলি ত্রুটির পরিস্থিতিতে ব্যবহার করা যেতে পারে:
| প্রতিক্রিয়া কোড | চিকিৎসা |
|---|---|
| 400 (খারাপ অনুরোধ) | গুগল ক্রিয়া ব্যর্থ হবে। |
| 401 (অননুমোদিত) | গুগল ক্রিয়া ব্যর্থ হবে। |
| 404 (পাওয়া যায়নি) | গুগল ক্রিয়া ব্যর্থ হবে। |
| 408 (অনুরোধের সময়সীমা) | Google পরে আবার চেষ্টা করবে। |
স্থায়ী ব্যর্থতার ক্ষেত্রে, Google ব্যবহারকারীকে বলবে যে পদক্ষেপ ব্যর্থ হয়েছে এবং ব্যবহারকারীকে ইমেলের মধ্যে বিকল্প নির্দেশাবলী অনুসরণ করতে হবে।