İşlemleri tanımlama

Schema.org'da işlem, bir yapılandırılmış veri parçası üzerinde gerçekleştirilebilecek bir etkinliği ifade eder. Gmail, birden fazla işlem türünü destekler ve her birini benzer yapılandırılmış verilerle tanımlayabilirsiniz.

Sık kullanılan işlemler

İçeriğinize schema.org varlıklarıyla işaretleme eklerseniz bu varlıklar için gitme işlemleri ekleyebilirsiniz. Örneğin, bir EmailMessage öğesine ViewAction git bağlantısı vermek 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>

E-postalarda şemaları desteklemeyen diğer e-posta istemcileri bu işaretlemeyi otomatik olarak yoksayar.

Mobil derin bağlantı

Go-to işlemleri, Android ve iOS'teki mobil uygulamalarda doğrudan içeriklere de bağlanabilir. Bir uygulamaya derin bağlantı oluşturmak için aşağıdaki örneklerde gösterildiği 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ğ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-app://12345/movieapp/watch-movies.com/watch?movieId=abc123"/>
 </div>
</div>

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

Uygulama içi işlem sayısı

Gmail, kullanıcıyı başka bir web sitesine yönlendirmeden uygulama içi işlemleri yerinde gerçekleştirir. Gitme işlemleri gibi uygulama içi işlemleri bildirirsiniz ancak e-posta istemcilerinin (ör. Gmail) işlemi satır içi olarak işlemesine yardımcı olan ek bilgiler eklersiniz.

target ile bir işlem bildirmek yerine, uygun yapılandırmayla işlem için bir HttpActionHandler tanımlayın.

Örneğin, kullanıcıların bir şeyi onaylamasını, teyit etmesini veya kabul etmesini gerektiren e-postalara onay düğmesi ekleyebilirsiniz. Kullanıcı düğmeyi tıkladığında Google, onay kaydını yaparak hizmetinize bir HTTP isteği gönderir. Kullanıcılar yalnızca bir kez ConfirmAction ile etkileşimde bulunabilir.

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 işlemler

Çoğu durumda işlemler yalnızca sınırlı bir süre için geçerlidir. Seyahat rezervasyonları gibi tarihleri bilinen varlıklarla ilişkili işlemlerin süresi otomatik olarak dolar. Gmail, gezi tarihi geçtikten sonra işlemi göstermez.

Ayrıca, işlemlere açıkça geçerlilik bitiş tarihleri de ekleyebilirsiniz. Örneğin, kupon kırpma veya fırsat kodu kaydetme işlemi yalnızca sınırlı bir süre için geçerli olabilir. Bir işlemin ne zaman gösterileceğiyle ilgili 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 makaleleri inceleyin: