İşlem Beyanı

Schema.org'daki bir işlem, yapılandırılmış bir veri parçasında gerçekleştirilebilecek bir fiili veya etkinliği temsil eder. Birden fazla 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ıyla işaretleme eklerseniz bu varlıklar için Gitme işlemleri ekleyebilirsiniz. Örneğin, bir EmailMessage öğesinin ViewAction Go-To bağlantısı olması için e-postanın potentialAction özelliğini aşağıdaki örnekte olduğu 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-postalarda şemaları desteklemeyen diğer e-posta istemcileri tarafından otomatik olarak yoksayıldığını unutmayın.

Mobil Derin Bağlantı

Go-To işlemleri, Android ve iOS'teki yerel mobil uygulamalarda doğrudan içeriklere de bağlanabilir. Bir uygulamaya derin bağlantı oluşturmak için aşağıdaki örnekte gösterildiği gibi android-app:// ve ios-app:// şemalarıyla kodlanmış ek target URL'ler 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ğini genişletme:

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ı uygulamanıza sahip değilse işlem, kullanıcıyı sağladığınız web URL'sine yönlendirir.

Uygulama İçi İşlemler

Uygulama içi işlemler, kullanıcıyı başka bir web sitesine yönlendirmeden Gmail'de yerinde gerçekleştirilir. Uygulama İçi İşlemler, Gitme İşlemleri gibi beyan edilir ancak kullanıcı aracıların (ör. Gmail) işlemi satır içi olarak işlemesini kolaylaştıran ek bilgiler içerir.

target ile bir işlem bildirmek yerine, uygun yapılandırmaya sahip işlem için bir HttpActionHandler bildirmeniz gerekir.

Örneğin, kullanıcıların bir şeyi onaylamasını, teyit etmesini ve kabul etmesini gerektiren 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 yalnızca bir kez kullanılabilir.

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

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. Seyahat rezervasyonları gibi tarihleri bilinen öğelerle ilişkili işlemlerin süresi otomatik olarak dolar. Gmail, gezi tamamlandıktan sonra işlemi göstermez.

Geçerlilik bitiş tarihleri, işlemlere açıkça da eklenebilir. Örneğin, kupon kırpma veya teklif kodu kaydetme işlemi yalnızca sınırlı bir süre için geçerli olabilir. Bir işlemin ne zaman gösterileceğini belirleyen 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 aşağıdaki makalelere bakın: