البدء

يعتمد ترميز البريد الإلكتروني على البيانات المنظَّمة في الرسائل الإلكترونية. يتوافق Gmail مع كل من JSON-LD و البيانات الجزئية. يمكنك استخدام أي من التنسيقَين لترميز المعلومات في رسالة إلكترونية. يتيح ذلك لمحرك بحث Google فهم الحقول وتزويد المستخدمين بنتائج البحث والإجراءات والبطاقات ذات الصلة. على سبيل المثال، إذا كانت الرسالة الإلكترونية تتضمّن معلومات حول حجز فعالية، يمكنك إضافة تعليقات توضيحية إلى وقت البدء والمكان وعدد التذاكر وأي تفاصيل أخرى تحدّد الحجز.

الترميز الأول

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

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