تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

البدء

يستخدم ترميز البريد الإلكتروني بيانات منظَّمة في الرسائل الإلكترونية لكي يعمل. يُرجى العِلم أنّ Gmail يتيح استخدام كلٍّ من JSON-LD والبيانات الجزئية، ويمكنك استخدام أيّ منهما لترميز المعلومات في الرسالة الإلكترونية. يسمح هذا الإجراء لـ 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 إضافة صورة رمز شريطي، مثل رمز الاستجابة السريعة، يمكن تضمينها في بطاقة صعود الطائرة.

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