İşlem Beyanı

schema.org'daki bir işlem, yapılandırılmış bir veri parçası üzerinde gerçekleştirilebilecek bir fiili veya etkinliği temsil eder. Birden çok işlem türü desteklenir ve bunların tümü benzer yapılandırılmış verilerle tanımlanabilir.

Sık Kullanılan İşlemler

İçeriğinize schema.org varlıkları içeren işaretlemeler eklerseniz bunlar için Git işlemi ekleyebilirsiniz. Örneğin, bir EmailMessage varlığında ViewAction Git bağlantısına sahip olmak için e-postanın potentialAction özelliğini aşağıdaki örnekte gösterildiği gibi doldurun:

JSON-LD

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "EmailMessage",
  "potentialAction": {
    "@type": "ViewAction",
    "target": "https://watch-movies.com/watch?movieId=abc123",
    "name": "Watch movie"
  },
  "description": "Watch the 'Avengers' movie online"
}
</script>

Mikro veri

<div itemscope itemtype="http://schema.org/EmailMessage">
  <div itemprop="potentialAction" itemscope itemtype="http://schema.org/ViewAction">
    <link itemprop="target" href="https://watch-movies.com/watch?movieId=abc123"/>
    <meta itemprop="name" content="Watch movie"/>
  </div>
  <meta itemprop="description" content="Watch the 'Avengers' movie online"/>
</div>

Yukarıdaki işaretlemenin, e-postalardaki şemaları desteklemeyen diğer e-posta istemcileri tarafından otomatik olarak yoksayıldığını unutmayın.

Mobil Derin Bağlantı

Git işlemleri, Android ve iOS'teki yerel mobil uygulamalardaki içeriklere doğrudan bağlantı verebilir. Bir uygulamaya derin bağlantı oluşturmak için aşağıdaki gibi android-app:// ve ios-app:// şemalarıyla kodlanmış ek target URL'leri ekleyin:

JSON-LD

"target": [
  “<web url>”,
  “android-app://<android package name>/<scheme>/<host>/<path+query>”,
  “ios-app://<App store ID>/<scheme>/<host><path+query>"
]

Mikro veri

<link itemprop="target" href="<web url>"/>
<link itemprop="target" href="android-app://<android package name>/<scheme>/<host>/<path+query>”/>
<link itemprop="target" href="ios-app://<App store ID>/<scheme>/<host>/<path+query>"/>

Önceki EmailMessage örneği uzatılıyor:

JSON-LD

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "EmailMessage",
  "name": "Watch movie",
  ... information about the movie ...
  "potentialAction": {
    "@type": "ViewAction",
    "target": [
      "https://watch-movies.com/watch?movieId=abc123",
      "android-app://com.watchmovies.app/http/watch-movies.com/watch?movieId=abc123",
      "ios-app://12345/movieapp/watch-movies.com/watch?movieId=abc123"
    ]
  }
}
</script>

Mikro veri

<div itemscope itemtype="http://schema.org/EmailMessage">
  <meta itemprop="name" content="Watch movie"/>
  ... information about the movie ...
  <div itemprop="potentialAction" itemscope itemtype="http://schema.org/ViewAction">
    <meta itemprop="target" content="https://watch-movies.com/watch?movieId=abc123"/>
    <meta itemprop="target" content="android-app://com.watchmovies.android/http/watch-movies.com/watch?movieId=abc123"/>
    <meta itemprop="target" content="ios://12345/movieapp/watch-movies.com/watch?movieId=abc123"/>
 </div>
</div>

Kullanıcının uygulamanız yoksa işlem, kullanıcıyı belirttiğiniz web URL'sine yönlendirir.

Uygulama İçi İşlemler

Uygulama içi işlemler, kullanıcıyı başka bir web sitesine göndermeden Gmail'de işlenir. Uygulama içi işlemler, Git İşlemleri gibi tanımlanır ancak kullanıcı aracılarının (Gmail gibi) işlemi satır içi olarak işlemesini kolaylaştıran ek bilgiler içerir.

target ile bir işlem tanımlamak yerine, işlem için uygun yapılandırmayla bir HttpActionHandler tanımlamanız gerekir.

Örneğin, kullanıcıların bir şeyi onaylaması, doğrulaması ve kabul etmesi gereken e-postalara onay düğmesi ekleyebilirsiniz. Kullanıcı düğmeyi tıkladığında Google'dan hizmetinize bir HTTP isteği gönderilir ve onay kaydedilir. ConfirmAction ile yalnızca bir kez etkileşimde bulunulabilir.

Aşağıdaki örnekte, bir e-postaya gider raporuyla ilgili bir ConfirmAction düğmesi eklenmiştir:

JSON-LD

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "EmailMessage",
  "potentialAction": {
    "@type": "ConfirmAction",
    "name": "Approve Expense",
    "handler": {
      "@type": "HttpActionHandler",
      "url": "https://myexpenses.com/approve?expenseId=abc123"
    }
  },
  "description": "Approval request for John's $10.13 expense for office supplies"
}
</script>

Mikro veri

<div itemscope itemtype="http://schema.org/EmailMessage">
  <div itemprop="potentialAction" itemscope itemtype="http://schema.org/ConfirmAction">
    <meta itemprop="name" content="Approve Expense"/>
    <div itemprop="handler" itemscope itemtype="http://schema.org/HttpActionHandler">
      <link itemprop="url" href="https://myexpenses.com/approve?expenseId=abc123"/>
    </div>
  </div>
  <meta itemprop="description" content="Approval request for John's $10.13 expense for office supplies"/>
</div>

Süresi Dolmak Üzere Olan İşlemler

Çoğu durumda işlemler yalnızca sınırlı bir süre için geçerlidir. Bilinen tarihlere sahip varlıklarla (ör. seyahat rezervasyonları) ilişkili işlemlerin süresi otomatik olarak sona erer. Gmail, gezi geçtikten sonra işlemi göstermez.

Geçerlilik bitiş tarihleri, işlemlere açıkça da eklenebilir. Örneğin, bir kuponu kırpma veya teklif kodunu kaydetme işlemi yalnızca sınırlı bir süre için geçerli olabilir. Bir işlemin ne zaman gösterileceğini belirten zaman aralığını ayarlamak için işlemin startTime ve endTime özelliklerini ayarlayın:

JSON-LD

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "EmailMessage",
  "potentialAction": {
    "@type": "ConfirmAction",
    "name": "Save coupon",
    "handler":  {
       "@type": "HttpActionHandler",
       "url": "https://my-coupons.com/approve?couponId=abc123"
    },
    "startTime": "2015-06-01T12:00:00Z",
    "endTime": "2015-06-05T12:00:00Z"
  }
}
</script>

Mikro veri

<div itemscope itemtype="http://schema.org/EmailMessage">
  <div itemprop="potentialAction" itemscope itemtype="http://schema.org/ConfirmAction">
    <meta itemprop="name" content="Save coupon"/>
    <div itemprop="handler" itemscope itemtype="http://schema.org/HttpActionHandler">
      <link itemprop="url" href="https://my-coupons.com/approve?couponId=abc123"/>
    </div>
    <meta itemprop="startTime" content="2015-06-01T12:00:00Z" />
    <meta itemprop="endTime" content="2015-06-05T12:00:00Z" />
  </div>
</div>

Daha fazla bilgi

İşlemler hakkında daha fazla bilgi için: