Bắt đầu

Mã đánh dấu email sử dụng dữ liệu có cấu trúc trong email để hoạt động. Gmail hỗ trợ cả JSON-LD và Microdata. Bạn có thể sử dụng một trong hai loại này để đánh dấu thông tin trong email. Điều này giúp Google hiểu được các trường và cung cấp cho người dùng kết quả tìm kiếm, hành động và thẻ phù hợp. Ví dụ: nếu email là về việc đặt chỗ cho một sự kiện, bạn có thể muốn chú thích thời gian bắt đầu, địa điểm, số lượng vé và tất cả thông tin khác xác định việc đặt chỗ.

Mã đánh dấu đầu tiên

Giả sử bạn chịu trách nhiệm gửi vé tham dự Google I/O 2013 cho người tham gia và bạn muốn sử dụng thông tin ngữ nghĩa của mã đánh dấu trong các email này. Ít nhất, email xác nhận phiếu yêu cầu hỗ trợ của bạn sẽ chứa HTML như sau:

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

Việc đánh dấu email này rất dễ dàng. Bạn có thể thêm các phần thông tin liên quan trong nội dung email ở bất kỳ vị trí nào bên trong body của HTML của email ở dạng có cấu trúc tương ứng với một trong các định dạng được hỗ trợ. Khối mã sau đây cho thấy email được đánh dấu sẽ trông như thế nào:

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>

Vi dữ liệu

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

Vi dữ liệu (nội tuyến)

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

Email ở trên chứa bộ thông tin tối thiểu để xác định một yêu cầu đặt chỗ sự kiện. Bạn có thể đánh dấu các thông tin khác trong email để cải thiện trải nghiệm người dùng. Ví dụ: thuộc tính ticketToken của đối tượng FlightReservation cho phép bạn thêm hình ảnh mã vạch, chẳng hạn như mã QR, có thể được đưa vào thẻ lên máy bay.

Để tìm hiểu về tất cả các loại được hỗ trợ và thuộc tính của các loại đó, hãy xem Hướng dẫn tham khảo.