شروع کنید

نشانه گذاری ایمیل از داده های ساختار یافته در ایمیل ها برای کار استفاده می کند. Gmail از JSON-LD و Microdata پشتیبانی می کند و می توانید از هر یک از آنها برای نشانه گذاری اطلاعات در ایمیل استفاده کنید. این به Google امکان می‌دهد فیلدها را بفهمد و نتایج جستجو، اقدامات و کارت‌های مرتبط را در اختیار کاربر قرار دهد. به عنوان مثال، اگر ایمیل مربوط به رزرو یک رویداد است، ممکن است بخواهید زمان شروع، مکان، تعداد بلیط ها و سایر اطلاعاتی که رزرو را تعریف می کند، حاشیه نویسی کنید.

اولین نشانه گذاری شما

فرض کنید شما مسئول ارسال بلیط های Google I/O 2013 برای شرکت کنندگان هستید و می خواهید از اطلاعات معنایی نشانه گذاری در این ایمیل ها استفاده کنید. حداقل، ایمیل تأیید بلیط شما حاوی HTML مانند زیر خواهد بود:

<html>
  <body>
    <p>
      Dear John, thanks for booking your Google I/O ticket with us.
    </p>
    <p>
      BOOKING DETAILS<br/>
      Order for: John Smith<br/>
      Event: Google I/O 2013<br/>
      When: May 15th 2013 8:30am PST<br/>
      Venue: Moscone Center, 800 Howard St., San Francisco, CA 94103<br/>
      Reservation number: IO12345<br/>
    </p>
  </body>
</html>

علامت گذاری این ایمیل بسیار آسان است. اطلاعات مربوطه در متن ایمیل را می توان در هر جایی از body HTML ایمیل به شکلی ساختاریافته و مطابق با یکی از قالب های پشتیبانی شده اضافه کرد. بلوک کد زیر نشان می دهد که ایمیل علامت گذاری شده چگونه است:

JSON-LD 

<html>
  <body>
    <script type="application/ld+json">
    {
      "@context":              "http://schema.org",
      "@type":                 "EventReservation",
      "reservationNumber":     "IO12345",
      "underName": {
        "@type":               "Person",
        "name":                "John Smith"
      },
      "reservationFor": {
        "@type":               "Event",
        "name":                "Google I/O 2013",
        "startDate":           "2013-05-15T08:30:00-08:00",
        "location": {
          "@type":             "Place",
          "name":              "Moscone Center",
          "address": {
            "@type":           "PostalAddress",
            "streetAddress":   "800 Howard St.",
            "addressLocality": "San Francisco",
            "addressRegion":   "CA",
            "postalCode":      "94103",
            "addressCountry":  "US"
          }
        }
      }
    }
    </script>
    <p>
      Dear John, thanks for booking your Google I/O ticket with us.
    </p>
    <p>
      BOOKING DETAILS<br/>
      Reservation number: IO12345<br/>
      Order for: John Smith<br/>
      Event: Google I/O 2013<br/>
      Start time: May 15th 2013 8:00am PST<br/>
      Venue: Moscone Center, 800 Howard St., San Francisco, CA 94103<br/>
    </p>
  </body>
</html>

میکروداده 

<html>
  <body>
    <div itemscope itemtype="http://schema.org/EventReservation">
      <meta itemprop="reservationNumber" content="IO12345"/>
      <div itemprop="underName" itemscope itemtype="http://schema.org/Person">
        <meta itemprop="name" content="John Smith"/>
      </div>
      <div itemprop="reservationFor" itemscope itemtype="http://schema.org/Event">
        <meta itemprop="name" content="Google I/O 2013"/>
        <time itemprop="startDate" datetime="2013-05-15T08:30:00-08:00"/>
        <div itemprop="location" itemscope itemtype="http://schema.org/Place">
          <meta itemprop="name" content="Moscone Center"/>
          <div itemprop="address" itemscope itemtype="http://schema.org/PostalAddress">
            <meta itemprop="streetAddress" content="800 Howard St."/>
            <meta itemprop="addressLocality" content="San Francisco"/>
            <meta itemprop="addressRegion" content="CA"/>
            <meta itemprop="postalCode" content="94103"/>
            <meta itemprop="addressCountry" content="US"/>
          </div>
        </div>
      </div>
    </div>
    <p>
      Dear John, thanks for booking your Google I/O ticket with us.
    </p>
    <p>
      BOOKING DETAILS<br/>
      Reservation number: IO12345<br/>
      Order for: John Smith<br/>
      Event: Google I/O 2013<br/>
      Start time: May 15th 2013 8:00am PST<br/>
      Venue: Moscone Center, 800 Howard St., San Francisco, CA 94103<br/>
    </p>
  </body>
</html>

میکروداده (داخلی) 

<html>
  <body>
    <p>
      Dear John, thanks for booking your Google I/O ticket with us.
    </p>
    <p itemscope itemtype="http://schema.org/EventReservation">
      BOOKING DETAILS<br/>
      Reservation number: <span itemprop="reservationNumber">IO12345</span><br/>
      Order for: <span itemprop="underName" itemscope itemtype="http://schema.org/Person">
        <span itemprop="name">John Smith</span>
      </span><br/>
      <div itemprop="reservationFor" itemscope itemtype="http://schema.org/Event">
        Event: <span itemprop="name">Google I/O 2013</span><br/>
        <time itemprop="startDate" datetime="2013-05-15T08:30:00-08:00">Start time: May 15th 2013 8:00am PST</time><br/>
        Venue: <span itemprop="location" itemscope itemtype="http://schema.org/Place">
          <span itemprop="name">Moscone Center</span>
          <span itemprop="address" itemscope itemtype="http://schema.org/PostalAddress">
            <span itemprop="streetAddress">800 Howard St.</span>,
            <span itemprop="addressLocality">San Francisco</span>,
            <span itemprop="addressRegion">CA</span>,
            <span itemprop="postalCode">94103</span>,
            <span itemprop="addressCountry">US</span>
          </span>
        </span>
      </div>
    </p>
  </body>
</html>

ایمیل بالا حاوی حداقل مجموعه اطلاعات برای تعریف رزرو رویداد است. برای بهبود تجربه کاربری می توانید سایر اطلاعات را در ایمیل های خود علامت گذاری کنید. به عنوان مثال، ویژگی ticketToken شی FlightReservation به شما امکان می دهد یک تصویر بارکد، مانند یک کد QR، اضافه کنید که می تواند در کارت پرواز گنجانده شود.

برای آشنایی با همه انواع پشتیبانی شده و ویژگی های آنها، به راهنمای مرجع مراجعه کنید.