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

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

कार्रवाइयां

अगर आपने अपने कॉन्टेंट में schema.org की इकाइयों का इस्तेमाल करके मार्कअप जोड़ा है, तो उनके लिए Go-To कार्रवाइयां जोड़ी जा सकती हैं. उदाहरण के लिए, अगर आपको EmailMessage इकाई में ViewAction Go-To लिंक शामिल करना है, तो ईमेल की 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>

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

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

Go-To Actions पर, मूल मोबाइल ऐप्लिकेशन में मौजूद कॉन्टेंट से भी सीधे तौर पर लिंक किया जा सकता है 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 Actions के तौर पर बताया जाता है. हालांकि, इनमें ऐसी अतिरिक्त जानकारी शामिल होती है जिससे उपयोगकर्ता-एजेंट (जैसे कि 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 डीप लिंकिंग