شروع به کار

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

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

فرض کنید شما مسئول ارسال تیکت‌های کنفرانس گوگل آی/او (Google I/O) به شرکت‌کنندگان هستید و می‌خواهید اطلاعات معنایی را در این ایمیل‌ها نشانه‌گذاری کنید. حداقل، ایمیل تأیید تیکت شما حاوی کد 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":              "https://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="https://schema.org/EventReservation">
      <meta itemprop="reservationNumber" content="IO12345"/>
      <div itemprop="underName" itemscope itemtype="https://schema.org/Person">
        <meta itemprop="name" content="John Smith"/>
      </div>
      <div itemprop="reservationFor" itemscope itemtype="https://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="https://schema.org/Place">
          <meta itemprop="name" content="Moscone Center"/>
          <div itemprop="address" itemscope itemtype="https://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="https://schema.org/EventReservation">
      BOOKING DETAILS<br/>
      Reservation number: <span itemprop="reservationNumber">IO12345</span><br/>
      Order for: <span itemprop="underName" itemscope itemtype="https://schema.org/Person">
        <span itemprop="name">John Smith</span>
      </span><br/>
      <div itemprop="reservationFor" itemscope itemtype="https://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="https://schema.org/Place">
          <span itemprop="name">Moscone Center</span>
          <span itemprop="address" itemscope itemtype="https://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، اضافه کنید که می‌تواند در کارت پرواز گنجانده شود.

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