कार्रवाइयों का एलान करें

schema.org में मौजूद ऐक्शन, किसी क्रिया या गतिविधि को दिखाता है. यह स्ट्रक्चर्ड डेटा के किसी हिस्से पर की जा सकती है. कई तरह की कार्रवाइयां की सुविधा काम करती है. साथ ही, इन सभी को मिलते-जुलते स्ट्रक्चर्ड डेटा की मदद से तय किया जा सकता है.

अक्सर की जाने वाली कार्रवाइयां

अगर आपने अपने कॉन्टेंट में schema.org इकाइयों के साथ मार्कअप जोड़ा है, तो उनके लिए 'इस पर जाएं' ऐक्शन जोड़े जा सकते हैं. उदाहरण के लिए, किसी EmailMessage इकाई के लिए ViewAction गो-टू लिंक बनाने के लिए, ईमेल की potentialAction प्रॉपर्टी को पॉप्युलेट करें. इसके लिए, नीचे दिए गए उदाहरण का पालन करें:

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "EmailMessage",
  "potentialAction": {
    "@type": "ViewAction",
    "target": "https://watch-movies.com/watch?movieId=abc123",
    "name": "Watch movie"
  },
  "description": "Watch the 'Avengers' movie online"
}
</script>

<div itemscope itemtype="http://schema.org/EmailMessage">
  <div itemprop="potentialAction" itemscope itemtype="http://schema.org/ViewAction">
    <link itemprop="target" href="https://watch-movies.com/watch?movieId=abc123"/>
    <meta itemprop="name" content="Watch movie"/>
  </div>
  <meta itemprop="description" content="Watch the 'Avengers' movie online"/>
</div>

ध्यान दें कि ऊपर दिए गए मार्कअप को, ईमेल में स्कीमा की सुविधा काम न करने वाले अन्य ईमेल क्लाइंट अपने-आप अनदेखा कर देते हैं.

मोबाइल डीप लिंकिंग

Android और iOS पर, नेटिव मोबाइल ऐप्लिकेशन में मौजूद कॉन्टेंट पर सीधे तौर पर जाने के लिए भी, 'इस पर जाएं' कार्रवाई का इस्तेमाल किया जा सकता है. किसी ऐप्लिकेशन को डीप लिंक करने के लिए, android-app:// और ios-app:// स्कीम के साथ कोड किए गए अतिरिक्त target यूआरएल शामिल करें, जैसा कि यहां दिखाया गया है:

"target": [
  “<web url>”,
  “android-app://<android package name>/<scheme>/<host>/<path+query>”,
  “ios-app://<App store ID>/<scheme>/<host><path+query>"
]

<link itemprop="target" href="<web url>"/>
<link itemprop="target" href="android-app://<android package name>/<scheme>/<host>/<path+query>”/>
<link itemprop="target" href="ios-app://<App store ID>/<scheme>/<host>/<path+query>"/>

पिछले EmailMessage उदाहरण को बड़ा करना:

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "EmailMessage",
  "name": "Watch movie",
  ... information about the movie ...
  "potentialAction": {
    "@type": "ViewAction",
    "target": [
      "https://watch-movies.com/watch?movieId=abc123",
      "android-app://com.watchmovies.app/http/watch-movies.com/watch?movieId=abc123",
      "ios-app://12345/movieapp/watch-movies.com/watch?movieId=abc123"
    ]
  }
}
</script>

<div itemscope itemtype="http://schema.org/EmailMessage">
  <meta itemprop="name" content="Watch movie"/>
  ... information about the movie ...
  <div itemprop="potentialAction" itemscope itemtype="http://schema.org/ViewAction">
    <meta itemprop="target" content="https://watch-movies.com/watch?movieId=abc123"/>
    <meta itemprop="target" content="android-app://com.watchmovies.android/http/watch-movies.com/watch?movieId=abc123"/>
    <meta itemprop="target" content="ios://12345/movieapp/watch-movies.com/watch?movieId=abc123"/>
 </div>
</div>

अगर उपयोगकर्ता के पास आपका ऐप्लिकेशन नहीं है, तो यह कार्रवाई उपयोगकर्ता को आपके दिए गए वेब यूआरएल पर ले जाती है.

इन-ऐप्लिकेशन कार्रवाइयां

इन-ऐप्लिकेशन कार्रवाइयों को Gmail में ही मैनेज किया जाता है. इसके लिए, उपयोगकर्ता को किसी दूसरी वेबसाइट पर भेजने की ज़रूरत नहीं होती. इन-ऐप्लिकेशन ऐक्शन, Go-To ऐक्शन की तरह ही डिक्लेयर्ड किए जाते हैं. हालांकि, इनमें अतिरिक्त जानकारी होती है, जिससे उपयोगकर्ता-एजेंट (जैसे, Gmail) के लिए इनलाइन ऐक्शन को मैनेज करना आसान हो जाता है.

target के साथ किसी कार्रवाई का एलान करने के बजाय, आपको सही कॉन्फ़िगरेशन के साथ कार्रवाई के लिए HttpActionHandler का एलान करना होगा.

उदाहरण के लिए, उन ईमेल में 'पुष्टि करें' बटन जोड़ा जा सकता है जिनमें उपयोगकर्ताओं को किसी चीज़ की अनुमति देने, पुष्टि करने, और स्वीकार करने की ज़रूरत होती है. जब उपयोगकर्ता बटन पर क्लिक करेगा, तो Google आपकी सेवा को एक एचटीटीपी अनुरोध भेजेगा. इसमें पुष्टि की जानकारी रिकॉर्ड की जाएगी. ConfirmAction के साथ सिर्फ़ एक बार इंटरैक्ट किया जा सकता है.

इस उदाहरण में, खर्च की रिपोर्ट के बारे में ईमेल में ConfirmAction बटन जोड़ा गया है:

<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>

जल्द ही खत्म होने वाली कार्रवाइयां

कई मामलों में, कार्रवाइयां सिर्फ़ सीमित समय के लिए काम की होती हैं. यात्रा की बुकिंग जैसी इकाइयों से जुड़ी कार्रवाइयों की समयसीमा अपने-आप खत्म हो जाएगी. यात्रा खत्म होने के बाद, Gmail उस कार्रवाई को नहीं दिखाता.

कार्रवाइयों में, समयसीमा को साफ़ तौर पर भी जोड़ा जा सकता है. उदाहरण के लिए, हो सकता है कि कूपन को क्लिप करने या ऑफ़र कोड को सेव करने की कार्रवाई सिर्फ़ कुछ समय के लिए मान्य हो. किसी कार्रवाई को दिखाने के लिए समयसीमा सेट करने के लिए, कार्रवाई की startTime और endTime प्रॉपर्टी सेट करें:

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "EmailMessage",
  "potentialAction": {
    "@type": "ConfirmAction",
    "name": "Save coupon",
    "handler":  {
       "@type": "HttpActionHandler",
       "url": "https://my-coupons.com/approve?couponId=abc123"
    },
    "startTime": "2015-06-01T12:00:00Z",
    "endTime": "2015-06-05T12:00:00Z"
  }
}
</script>

<div itemscope itemtype="http://schema.org/EmailMessage">
  <div itemprop="potentialAction" itemscope itemtype="http://schema.org/ConfirmAction">
    <meta itemprop="name" content="Save coupon"/>
    <div itemprop="handler" itemscope itemtype="http://schema.org/HttpActionHandler">
      <link itemprop="url" href="https://my-coupons.com/approve?couponId=abc123"/>
    </div>
    <meta itemprop="startTime" content="2015-06-01T12:00:00Z" />
    <meta itemprop="endTime" content="2015-06-05T12:00:00Z" />
  </div>
</div>

इसके बारे में और पढ़ें

कार्रवाइयों के बारे में ज़्यादा जानकारी के लिए, ये देखें:

• कार्रवाई के अनुरोधों को मैनेज करना
• कार्रवाइयों को सुरक्षित करना
• Android डीप लिंकिंग
• iOS डिवाइस पर डीप लिंकिंग