الخطوات الأولى

يستخدم ترميز البريد الإلكتروني البيانات المنظَّمة في الرسائل الإلكترونية لكي يعمل. يتوافق 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 إضافة صورة رمز شريطي، مثل رمز استجابة سريعة، يمكن تضمينها في بطاقة صعود الطائرة.

للاطّلاع على معلومات حول كل الأنواع المتوافقة وخصائصها، يُرجى مراجعة الدليل المرجعي.