İşlem Beyanı

Schema.org'daki bir İşlem, bir yapılandırılmış 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.

Hedef İşlemler

schema.org varlıklarıyla içeriğinize işaretleme eklerseniz bunlar için Go-To işlemleri ekleyebilirsiniz. Örneğin, bir EmailMessage varlığının ViewAction Go-To bağlantısına sahip olmasını sağlamak için e-postanın potentialAction mülkünü 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 veriler

<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, doğrudan Android ve iOS'te yer alan yerel mobil uygulamalardaki içeriğe de bağlantı verebilir. Bir uygulamaya derin bağlantı vermek için aşağıda gösterildiği gibi android-app:// ve ios-app:// şemalarıyla kodlanmış ek target URL'lerini 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 veriler

<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ğine devam edelim:

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 veriler

<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>

Uygulamanız kullanıcıya ait değilse bu işlem, kullanıcıyı sağladığınız web URL'sine yönlendirir.

Uygulama İçi İşlemler

Uygulama İçi İşlemler, Gmail'in içinde, kullanıcıyı başka bir web sitesine göndermeden gerçekleştirilir. Uygulama İçi İşlemler, Go-To Actions (Git İşlemler) gibi beyan edilir, ancak kullanıcı aracılarının (ör. Gmail) işlemi satır içinde gerçekleştirmesini kolaylaştıran ek bilgiler içerir.

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

Örneğin, kullanıcıların bir öğeyi onaylamasını, onaylamasını veya onaylamasını gerektiren e-postalara bir onay düğmesi ekleyebilirsiniz. Kullanıcı düğmeyi tıkladığında Google'dan hizmetinize onayın kaydedileceği bir HTTP isteği gönderilir. ConfirmAction ile yalnızca bir kez etkileşim kurulabilir.

Aşağıdaki örnekte, gider raporuyla ilgili bir e-postaya 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 veriler

<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 Dolan İşlemler

Birçok durumda, işlemler yalnızca sınırlı bir süre için alakalıdır. Seyahat rezervasyonları gibi bilinen tarihleri olan varlıklarla ilişkili işlemlerin süresi otomatik olarak dolar. Gmail, gezi süresi geçtikten sonra yapılan işlemi göstermez.

İşlemlere geçerlilik bitiş tarihleri de açıkça eklenebilir. Örneğin, kupon kırpma veya teklif kodunu kaydetme işlemi yalnızca sınırlı bir süre için geçerli olabilir. Bir işlemin gösterileceği 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 veriler

<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>

Ek Okumalar

İşlemler hakkında daha ayrıntılı bilgi için şu makalelere bakın: