این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

شروع کنید

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

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

فرض کنید شما مسئول ارسال تیکت‌های کنفرانس 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، اضافه کنید که می‌تواند در کارت پرواز گنجانده شود.

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