Bu sayfa, Cloud Translation API ile çevrilmiştir.

Play Games İşlemleri

Genel Bakış

Bu belgede, video oyunları için Play Oyun İşlemleri tanıtılmakta, şema şartları listelenmekte ve bu özellikten yararlanmaya başlamak için ilk katılım süreci ayrıntılı olarak açıklanmaktadır.

Play Games İşlemleri'ne giriş

Mobil cihazda Play Oyun İşlemleri'nin resmi

Masaüstünde Play Games İşlemleri'nin resmi

Video Oyunları İçin Oyun İşlemlerini Oynama, kullanıcıların masaüstü veya mobil cihazlarda doğrudan Arama Sonuçları Sayfası'ndan (ASSP) oyun oynamasına olanak tanır. Kullanıcılar, Düzenlenmiş Arama Sonuçları Sayfası'nın (OSRP) Genel Bakış sekmesinde veya bilgi panelinde, kendisiyle ilişkili en az bir Play Game Action bulunan bir oyun aradıklarında Play Game Action ile karşılaşır. Bu özellik; ücretsiz, abonelikle veya tek tek satın alınarak kullanılabilen ve masaüstü ya da mobil cihazlarda buluttan yayınlanabilen veya masaüstü ya da konsolda yerel istemci uygulamaları aracılığıyla indirilebilen oyunların demo veya tam sürümlerinde kullanılabilir.

Play Oyun İşlemleri, oyun kataloğunuzun ayrıntılarını içeren bir feed tarafından desteklenir. Feed, bir varlık koleksiyonu içeren bir JSON nesnesidir. Öğe, kataloğunuzdaki oyunu ve oyunu yayınlamak için ilişkili derin bağlantısını (demo, anında deneme veya tam sürüm) temsil eden bir schema.org nesnesidir.

Google'ın feed'inizi alabilmesi için feed'i bir dosyada saklamanız ve dosyayı Google'ın erişebileceği bir konumda barındırmanız gerekir. Google, içeriğinizin güncel olmasını sağlamak için feed dosyasını ana makinenizden düzenli olarak getirir.

Bu şartların her biriyle ilgili ayrıntılı bilgiyi aşağıdaki bölümlerde bulabilirsiniz.

Başlayın

Önceki bölümde belirtildiği gibi, sağlayıcı olarak sorumluluklarınız şunlardır:

Feed'i oluşturmak için gereken bilgileri, kaynaklarını ve kullanılabilirliğini, ayrıca feed'e nasıl eklendiğini anlayın.
Kataloğunuzdaki her oyun öğesinin gerekli ayrıntılarını içeren bir feed oluşturun.
Feed'i bir sunucuda veya bulut depolama hizmetinde barındırın ve Google'ın feed'i düzenli olarak getirmesine izin verin.
Google'ın bildirdiği sorunlara yanıt verin ve bunları düzeltin. Bunlar kaliteyle ilgili veya JSON dosyalarının yapısıyla ilgili sorunlar olabilir.
Kataloğunuz geliştikçe feed'i güncel tutun.
Feed kalitesinin kullanıma sunulduktan sonra da korunmasını sağlayın.

Bunları ayrıntılı olarak inceleyelim.

Başlamadan önce

Feed'i oluşturmaya başlamadan önce Play Oyun İşlemleri meta veri koşullarını anlamak ve gerekli tüm bilgileri tek bir yerde toplamak için zaman ayırmanızı öneririz. Feed oluşturmaya başlamadan önce aşağıdakileri yapmanızı öneririz:

VideoGame öğesi için meta veri koşullarını inceleyin.
Meta verileri toplayın.
- Zorunlu ve önemle tavsiye edilen özelliklere yakından bakın. Google, feed'deki içeriğinizi Google'ın veritabanlarındaki içerikle eşleştirmek için bu özellikleri kullanır. İçeriğiniz için ne kadar çok meta veri sağlarsanız Google içeriği o kadar iyi eşleştirebilir.

Bu dokümanda Çalışmalar ve Baskılar'ın kullanımını anlama

Eser: Soyut olarak video oyunu kavramını ifade eder. Özellikle başlık, geliştirici, oyun açıklaması ve yayıncı gibi meta veriler bir eserin özellikleridir.
Sürüm: Video oyununun somut bir versiyonu. Özellikle yayın yılı, platformun adı ve derin bağlantılar gibi meta veriler sürümün özellikleridir.

Örneğin, "Shadow of the Tomb Raider" bir eserdir ancak her sürümü bir baskıdır. Bu durumda, "Shadow of the Tomb Raider"ın Stadia için bir baskısı, PlayStation için bir baskısı, Stadia'da Erken Erişim için bir baskısı vb. olabilir.

Bu ayrım, özellikle feed'de hemen görülemeyebileceği durumlarda önemlidir. İki VideoGame varlığı vardır:

VideoGame (Work), "üst düzey" VideoGame varlığıdır:

exampleOfWork, VideoGame (Work) varlığının bir özelliği olup VideoGame (Edition) varlığının bir veya daha fazla örneğini belirtir.
Her VideoGame (Work) için en az bir exampleOfWork VideoGame (Edition) olmalıdır.

VideoGame (Edition), "alt düzey" VideoGame varlığıdır.

Bir eserin birden fazla basımının olabileceğini unutmayın. Bu baskıları mümkün olduğunca gruplandırmanızı öneririz. Bu, Google sistemlerinin bir video oyunuyla ilgili tüm bilgilerden yararlanarak oyunu Arama'da göstermesine yardımcı olur.

İki temel mülkü ve bunların koşullarını anlayın. Bir sonraki adım olan feed oluşturma işlemine geçerken bu bilgilerin doğru olması çok önemlidir.

Standart URL (url)

Standart URL (url), Google'ın kataloğunuzdaki içeriği Google'ın veritabanlarındaki içerikle doğru bir şekilde eşleştirmesine yardımcı olur.

"Standart URL, Google'a göre sitenizdeki yinelenen sayfaları en iyi temsil eden sayfanın URL'sidir. Örneğin, aynı sayfa için URL'leriniz varsa (örneğin: example.com?dress=1234 ve example.com/dresses/1234) Google bunlardan birini standart olarak seçer." (Kaynak: Yinelenen URL'leri birleştirme)

Standart URL ile ilgili şartlar şunlardır:

url değeri global olarak benzersiz olmalıdır.
url, Google'ın tarayabileceği çalışan bir standart URL içermelidir.

Tanımlayıcı (@id)

Bir tanımlayıcı (@id) aşağıdaki koşulları karşılamalıdır:

Kataloğunuzda global olarak benzersiz olmalıdır:
- Örneğin, iki farklı video oyunu için aynı @id kullanmayın.
Statik:
- @id daha sonra değiştirilemez.
Tek tip kaynak tanımlayıcısı (URI) biçiminde:
- İçeriğinizin yerel tanımlayıcısı (kimliği) URI biçiminde değilse bu koşulu karşılamak için kimliğin önüne alanınızı ekleyin. Örneğin, içeriğinizin kimliği 1234abc ve alanınız https://example.com ise @id, https://example.com/1234abc olabilir.
- @id, çalışan bir URL olmak zorunda değildir. Yalnızca URI biçiminde olması gerekir.
- @id içinde kullanılan alan adı (örneğin, https://example.com) kuruluşunuza ait olmalıdır.

Bir öğenin url özelliği, tanımlayıcı olarak tüm koşulları (yani genel olarak benzersiz, statik ve URI biçiminde) karşıladığından, mantıklı olduğu durumlarda öğenin url özelliğini @id olarak kullanmanızı öneririz.

Derin bağlantı şartlarını anlama ve belirleme

Kullanıcı, içerikte Play Game Actions'ı başlattığında Google, kullanıcıyı doğrudan uygulamanızdaki veya platformunuzdaki içeriğe yönlendirmek için içeriğin derin bağlantısını kullanır. Aşağıdakileri göz önünde bulundurun:

Derin bağlantılar, belirtilen tüm platformlarda hedefledikleri içeriği açmalıdır. Farklı platformlarda farklı derin bağlantılar olabilir. Örneğin, masaüstü web'de çalışan derin bağlantı, mobil web'de çalışan derin bağlantıdan farklı olabilir. Her oyun için platforma göre farklı derin bağlantıları olup olmadığını kontrol edin.
Derin bağlantılar parametreler (&) veya sabitleme etiketleri (#) içerebilir.
İçeriğinizin Google'ın birden fazla platformunda (Arama, Asistan ve Android TV) kullanılabilmesi için derin bağlantı gereklidir.

Platform	Açıklama
http://schema.org/DesktopWebPlatform	Masaüstü web tarayıcısında arama platformu.
http://schema.org/MobileWebPlatform	Mobil web tarayıcısında arama platformu.
http://schema.org/AndroidPlatform	Android uygulamasında arama platformu
http://schema.org/AndroidTVPlatform	Android TV uygulamasında Android TV platformu
http://schema.org/IOSPlatform	iOS uygulamasında arama platformu.

Katalogunuzdaki oyunların erişim şartlarını belirleyin: Kendinize aşağıdaki soruları sorun ve feed'deki meta veriler aracılığıyla yanıtlarını belirlemenin bir yolu olduğundan emin olun.

Kullanıcıların içeriğe erişmek için uygulamanıza veya platformunuza giriş yapması gerekiyor mu?
Kullanıcıların aboneliği olması gerekir mi?
Kullanıcıların oyunu oynamak için satın alma işlemi yapması gerekiyor mu?
Erişim koşulu zaman içinde değişir mi?
Erişim şartı cihaz konumuna mı bağlı?

Kullanıcılarınızın satın alabileceği birden fazla abonelik paketi sunuyorsanız commonTier nedir ve Google ile entegrasyonunuzu nasıl etkiler?

Ödeme duvarı türleri

Play Game Actions şu anda yalnızca aşağıdaki ödeme duvarı türlerini desteklemektedir:

Kategori değeri	Ödeme duvarı türü
`nologinrequired`	Satın alma veya giriş yapma gerekmez.
`free`	Kullanıcının giriş yapmış olması gerekir ancak ücretli aboneliği olması gerekmez.
`subscription` Not: Ortak katman biçimlendirmesi gereklidir.	Kullanıcının etkin bir aboneliği olmalıdır. Erişim, abonelik katmanından bağımsızdır.
`subscription` Not: `MediaSubscription.identifier` ile bu içeriğe erişmek için gereken hak tanımlayıcıları kümesini belirtin. Daha fazla bilgi için Yetki tanımlayıcısı başlıklı makaleyi inceleyin. Ortak katman işaretlemesi gerekebilir.	Kullanıcının etkin bir aboneliği olmalıdır. Erişim, abonelik katmanından bağımsızdır.
`purchase`	İçerik, satın alma işleminden sonra süresiz olarak kullanılabilir.
`rental`	İçerik, satın alma işleminden sonra sınırlı bir süre için kullanılabilir.

Bu kategori değerleri, feed oluşturulurken daha sonra kullanılır. Ayrıca, önceki tablodaki rental kategorisinin şu anda tamamen isteğe bağlı olduğunu ve gelecekteki bir ürün geliştirmesinde desteklenebileceğini unutmayın. Şu anda, feed'deki üründe yalnızca free, nologinrequired, subscription ve purchase kategori değerleri kullanılıyor.

Son olarak, ne elde etmek istediğimiz hakkında fikir edinmek için örnek feed'e hızlıca göz atın.

Yukarıdakileri anlamak ve feed oluşturma aşamasına geçmek için yeterli olan, yanıtlara (bu sorulara) karşılık gelen meta verilerin olduğundan emin olmak.

Feed'inizi oluşturma

Play Game Actions feed'i, kataloğunuzdaki video oyunlarını temsil eden bir dizi öğe içeren bir JSON nesnesidir. Google'ın düzenli olarak getirebilmesi için feed'i dosya veya birden fazla dosya olarak sağlamanız ve bir sunucuda ya da bulut depolama hizmetinde barındırmanız gerekir.

Feed dosya boyutu, miktar ve biçim gereksinimlerine uyma

Aşağıdaki koşullara uymanız gerekir:

Tüm feed dosyaları .json dosya adı uzantısını kullanmalıdır.
Dosya adlarının boşluk içermediğinden emin olun.
Feed dosyanızı şifrelemeyin.
Feed dosyanızı UTF-8 olarak kodlayın (dosya düzenleyici ayarınızı kontrol edin).
Feed dosyanızın boyutu sıkıştırılmamış olarak 1 GB'tan büyükse dosyayı birden fazla dosyaya bölün.
- Dosya boyutu 1 GB'tan küçük olduğu sürece tek bir dosyaya kaç öğe ekleyebileceğiniz veya feed gönderiminizin bir parçası olarak Google'a kaç dosya gönderebileceğiniz konusunda bir sınırlama yoktur.
Dosyanın, JSON spesifikasyonuna uygun olarak BOM olmadan kodlandığından emin olun. Linux işletim sisteminde bunu doğrulamak için hexdump file.json | head -n 1, 0x00 adresinde BBEF ile başlamamalıdır.

Feed içeriği şartlarına uyma

Aşağıdaki içerik şartlarına uymanız gerekir:

Feed eski varlıklar içermemelidir. Eski varlıklar, derin bağlantının availabilityEnds özelliğinin geçmişte bir tarihe ayarlandığı veya artık sitenizde bulunmayan varlıklardır.
Feed'inize dahil ettiğiniz tüm derin bağlantılar (ör. urlTemplate) ve tüm URL'ler (ör. url) üretim URL'si olmalıdır. Üretim URL'si dışındaki URL türlerini (ör. QA, geliştirme vb.) kullanmayın.
Önceki bölümde belirtildiği gibi, url gibi tüm URL'ler standart olmalıdır.
Feed'inizdeki her varlık aşağıdaki özellikleri belirtmelidir:
- Benzersiz bir kimlik: @id
- Benzersiz bir URL: url
- Benzersiz bir derin bağlantı: urlTemplate

Feed'i oluştururken aşağıdaki önerilerimizi dikkate almanızı öneririz:

Feed'in nasıl yapılandırıldığını ayrıntılı olarak anlayın.
Örnek feed ile başlayın.
- Kataloğunuzdan en fazla beş temsili öğe seçin. Makul ölçüde karmaşık bir yapıya sahip ancak katalogdaki bir öğe için yine de tipik olan öğeleri seçin ve aynı öğe için feed oluşturun.
Hızlı doğrulama için bu belgeyi, atanan Google temsilcinize gönderin.
Örnek feed'inizdeki tüm hataları giderdikten sonra feed'i genişleterek kataloğunuzdaki tüm öğeleri ekleyin.
- Feed'inizin kataloğunuzdaki tüm öğeleri içerdiğini doğrulamak için feed'inizdeki öğe sayısını kataloğunuzdaki öğe sayısıyla karşılaştırın.

Feed'inizi barındırma

Feed dosyanız hazır olduğunda güvenli bir yerde barındırın. Google, içeriğinizin güncel olmasını sağlamak için feed'i düzenli olarak getirir. Aşağıdaki barındırma yöntemlerini destekliyoruz:

Barındırma yöntemi	Kimlik doğrulama desteği
Google Cloud Storage	`088794101-100000002-account@partnercontent.gserviceaccount.com` için Storage Object Viewer izni verin
HTTPS	Kullanıcı adı+şifre veya HTTP istemci sertifikaları paylaşmanızı gerektirir.
SFTP	Şifre, Anahtar+Kelime Öbeği veya her ikisini de paylaşmanızı gerektirir.
AWS S3	AWS S3 paketi için anahtar kimliği ve erişim anahtarını paylaşmanızı gerektirir.

Feed dosyanızı bir barındırma sistemine yükledikten sonra, feed dosyanızı incelemek için Play Game Actions ekibiyle iletişime geçin.

Feed'inizi incelemeye gönderme

Feed dosyanız barındırıldıktan sonra feed inceleme sürecini başlatmak için atanan Play Game Actions kişinizle iletişime geçin. Bu iletişimde aşağıdaki bilgileri paylaştığınızdan emin olun:

Genel Bakış/Açıklama: Örnek feed mi yoksa tam üretim feed'i mi paylaştığınızı bize bildirin. Örnek feed paylaşıyorsanız mümkünse üretim feed'inin tahmini teslim süresini bize bildirin.
Ana makine konumu: Feed dosyanızın URL'si.
Ana makine kimlik doğrulaması: Geçerliyse Google'ın feed dosyasını ana makinenizden almasına izin vermek için kimlik doğrulama bilgilerini ekleyin. Daha fazla bilgi için Feed'inizi barındırma başlıklı makaleyi inceleyin.
Test hesabı: Play Game Actions ekibinin test için uygulamanızdaki veya platformunuzdaki derin bağlantılara erişmesine olanak tanıyan bir test hesabı. Feed'inizde birden fazla platformda bulunan öğeler varsa her platform için bir test hesabı sağlayın.
Icons: Aşağıdaki beş simgeyi gönderin. Bu simgeler, Arama'daki Play Oyun İşlemleri'nin yanında kullanılır.

Kategori	Boyutlar (piksel)	Dosya boyutu	Yönergeler
Arama/Yayınlama/Diğerlerinde Oyun İşlemlerini Oynatma
	16x16	112x112 piksel boyutundaki simge hariç tüm simgelerin dosya boyutu 1 KB'tan büyük olamaz. 112x112 piksel boyutundaki simgenin dosya boyutu 3 KB'tan büyük olamaz.	Beş simge boyutunun tamamı gereklidir. Resimler aşağıdaki koşullara uygun olmalıdır: PNG dosya biçimi. Yuvarlak bir şekil. Şeffaf arka plan Resimlerin kenarlarının düzgün olduğundan, bozulmadığından veya pikselli olmadığından emin olun.
	20x20
	40x40
	44x44
	112x112

Örnek

Feed doğrulamasının işleyiş şekli

Feed doğrulamasının iki aşaması vardır:

Yapı doğrulama:
- Bu, doğrulama kontrollerinin ilk aşamasıdır.
- Google, JSON dosyalarının yapısıyla ilgili geri bildirim sağlar. JSON iyi biçimlendirilmiş mi? Feed'de gerekli tüm özellikler ve önemle tavsiye edilen özellikler var mı? Derin bağlantılar, feed gereksinimlerimize uygun şekilde sağlanıp açıklama eklenmiş mi?
- Bu aşamada Google ile birkaç kez görüşme yapılması gerekir ve tüm geri bildirimler ele alınana kadar devam eder.
Meta Veri Uzlaştırması:
- Bu işlem yalnızca feed, yapı doğrulama aşamasını geçtikten sonra başlar. Bu aşamada Google, Google'ın Bilgi Grafiği ile mutabakat sürecini başlatır.
- Bu aşamada, feed'de yer alan meta verilerle ilgili geri bildirim sağlıyoruz. Başarılı bir lansman için tüm sorunların giderilmesi gerekir. Örneğin, bu aşamadaki geri bildirimlerde bir oyunun başlığını veya yayın tarihini düzeltmeniz istenebilir.
- Bu aşamada Google ile birkaç kez görüşme yapılması gerekir ve tüm geri bildirimler ele alınana kadar devam eder.

Feed kabul kriterleri

Tüm engelleyici sorunlar giderildiğinde ve Google, meta veri kalitesinin lansman için uygun olduğunu onayladığında feed'in lansman için kabul edilebilir olduğu düşünülür.

Gerektiğinde feed'inizi güncelleme

Feed'inizi her gün güncellemenizi önersek de bu, kataloğunuzun ne sıklıkla değiştiğine bağlıdır. Aşağıdaki koşullara ve ipuçlarına dikkat edin:

Google Arama, gerçek zamanlı güncellemeleri desteklemez.
Google Arama, feed'inizi günde bir kez getirir ve içeriği genellikle iki gün içinde (özellik kullanıma sunulduğunda) dizine ekler.
Derin bağlantıların kullanılabilirliğiyle ilgili öngörülebilir bir değişiklik varsa tam tarihleri ayarlamak için availabilityStarts ve availabilityEnds kullanın.
Öğe artık kataloğunuzda yoksa feed'den tamamen kaldırın.

Referans

Feed yapısına genel bakış

Play Game Actions feed'i aşağıdaki yapıya sahiptir:

Veri feed'i zarfı

Veri feed'i zarfı, Play Game Actions feed'indeki en üst düzey nesnedir. Nesne, kataloğunuzdaki tüm video oyunlarını temsil eden bir content markup nesneleri (VideoGame (Work) varlıkları) dizisi içerir.

Mülk	Beklenen tür	Açıklama
`@context`	URL	Zorunludur. `http://schema.org` olarak ayarlandı
`@type`	Metin	Zorunludur. `DataFeed` olarak ayarlayın.
`dateModified`	DateTime	Zorunludur. Feed'in son değiştirilme tarihi ve saati (saat dilimi dahil) ISO 8601 biçiminde.
`dataFeedElement`	Thing alt türü	Zorunludur. Oyun kataloğunuzdaki öğeler.

Şablon

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    {  },
    {  },
    {  },
    ...
  ]
}

İçerik işaretleme nesneleri

İçerik işaretleme nesnesi, kataloğunuzdaki tek bir öğeyi (VideoGame (Work)) temsil eder. Nesne, içeriğin tanımlayıcısını ve kanonik URL'sini içerir ve meta veriler aracılığıyla içeriği açıklamaya yardımcı olur. VideoGame (Work) için içerik işaretleme nesnesinde, VideoGame(Edition) nesnesine bağlamak üzere exampleOfWork adlı bir özellik bulunur. Bu VideoGame(Edition), içeriğin birden fazla Action işaretleme nesnesiyle ilişkilendirilmesine olanak tanıyan bir Action işaretleme nesneleri dizisine sahip olabilir. Örneğin, içerik her bölge için farklı bir İşlem biçimlendirme nesnesine sahip olabilir.

İşlem işaretleme nesneleri

İşlem biçimlendirme nesnesi, kullanıcıları oyuna götüren derin bağlantıyı ve oyun için gereken erişim düzeyini açıklar. Nesne, bir içerik işaretleme nesnesinin (potentialAction) özelliğidir. Play Game Actions için erişim kısıtlamalarını belirtmek üzere bir Action access specification nesnesi kullanın.

Mülk	Beklenen tür	Açıklama
`@type`	Metin	Zorunludur. Her zaman `PlayGameAction` olarak ayarlanır.
`gameAvailabilityType`	GameAvailabilityEnumeration veya Text	Zorunludur. Bu işlemle ilişkili oyun içeriğinin kullanılabilirlik türünü (ör. tam sürüm veya demo olup olmadığı) belirtir. Kabul edilen değerler arasında `DEMO` ve `FULL` yer alır.
`additionalType`	Metin	Zorunludur. Bu oyunla ilişkili oynatma işleminin türünü gösterir. Kabul edilen değerler şunlardır: `StreamingPlayAction`: Bir maçın internette yayınlanabileceğini gösterir. `DownloadPlayAction`: Bir oyunun indirilebileceğini gösterir.
`target`	EntryPoint	Zorunludur. Derin bağlantıların çeşitli Google platformlarıyla eşlemesini sağlayan bir hedef nesne.
`target.@type`	Metin	Zorunludur. Her zaman `EntryPoint` olarak ayarlanır.
`target.urlTemplate`	URL	Zorunludur. Kullanıcıları uygulamanıza veya platformunuza yönlendiren ve oyunun oynatılmasını başlatan bir derin bağlantı.
`target.inLanguage`	Metin	İsteğe bağlı. Dizinin BCP 47 biçimindeki orijinal dili.
`target.actionPlatform`	Metin	Zorunludur. `urlTemplate` ile eşlenen platformlar. Play Game Actions aşağıdaki değerleri destekler: http://schema.org/DesktopWebPlatform http://schema.org/MobileWebPlatform http://schema.org/AndroidPlatform http://schema.org/AndroidTVPlatform http://schema.org/IOSPlatform Gereksinimler için Platform türleri başlıklı makaleyi inceleyin.
`actionAccessibilityRequirement`	ActionAccessSpecification	Zorunludur. İçeriğin erişim koşulunu açıklayan bir işlem erişimi spesifikasyon nesnesi. Ayrıntılar için Action Access Specification Properties (İşlem Erişim Spesifikasyonu Özellikleri) başlıklı makaleyi inceleyin.

Şablon

"potentialAction": {
  "@type": "PlayGameAction",
  "target": [
    {  },
    {  }
  ],
  "actionAccessibilityRequirement": [
    {  },
    {  }
  ]
}

Hedef

Hedef nesne, derin bağlantının çeşitli Google platformlarıyla eşlemesini sağlar. Nesne, bir işlem işaretleme nesnesinin özelliği (target) olmalıdır. urlTemplate özelliği derin bağlantıyı, actionPlatform özelliği ise derin bağlantıyı destekleyen platformları yakalar.

Örnek

"target": [
  {
    "@type": "EntryPoint",
    "urlTemplate": "http://www.example.com/game007?autoplay=true",
    "actionPlatform": [
      "http://schema.org/DesktopWebPlatform",
      "http://schema.org/AndroidPlatform",
      "http://schema.org/AndroidTVPlatform",
      "http://schema.org/IOSPlatform"
    ]
  },
  {
    "@type": "EntryPoint",
    "urlTemplate": "http://www.example.com/mobile/game007?autoplay=true",
    "actionPlatform": [
      "http://schema.org/MobileWebPlatform"
    ]
  }
]

İşlem erişimi spesifikasyonu

Bir işlem erişimi spesifikasyon nesnesi, bölgeye ve süreye göre içerik için erişim koşulunu açıklar. Nesne, bir Action biçimlendirme nesnesinin actionAccessibilityRequirement özelliğidir.

İki derin bağlantı içeren örnek hedef

"target": [
  {
    "@type": "EntryPoint",
    "urlTemplate": "http://www.example.com/game007?autoplay=true",
    "actionPlatform": [
      "http://schema.org/DesktopWebPlatform",
      "http://schema.org/AndroidPlatform",
      "http://schema.org/AndroidTVPlatform",
      "http://schema.org/IOSPlatform"
    ]
  },
  {
    "@type": "EntryPoint",
    "urlTemplate": "http://www.example.com/mobile/game007?autoplay=true",
    "actionPlatform": [
      "http://schema.org/MobileWebPlatform"
    ]
  }
]

İşlem erişimi spesifikasyonu

Bir işlem erişimi spesifikasyon nesnesi, bölgeye ve süreye göre içerik için erişim koşulunu açıklar. Nesne, bir işlem biçimlendirme nesnesinin actionAccessibilityRequirement özelliğidir.

Mülk	Beklenen tür	Açıklama
`actionAccessibilityRequirement.@type`	Metin	Zorunludur. Her zaman `ActionAccessSpecification` olarak ayarlanır.
`actionAccessibilityRequirement.category`	Metin	Zorunludur. İçeriğe erişim için gerekli olanlar. Kabul edilen değerler ve daha fazla bilgi için Ödeme duvarı türü başlıklı makaleyi inceleyin. Bir öğe bir içerik grubunu temsil ediyorsa kategoriyi içeriğinin en az kısıtlayıcı erişim koşuluna göre ayarlamanız gerekir. Örneğin, bir oyuna `nologinrequired` kullanılarak ve abonelik üzerinden ücretsiz erişilebiliyorsa kategoriyi `nologinrequired` olarak ayarlayın.
`actionAccessibilityRequirement.availabilityStarts`	Tarih	Zorunludur. İşlemin kullanılabileceği tarih (saat dilimi dahil) ISO 8601 biçiminde. Tarih gelecekteki bir tarih olarak ayarlanabilir. `availabilityStarts` tarihinden 72 saat sonra veya daha geç olmalıdır. İçerik yayınlandıktan sonra her zaman kullanılabilir durumdaysa bu tarihi, geçerli tarihten 20 yıl sonra olarak ayarlayın. İlgili öğenin, `availabilityStarts` tarihinden en az yedi gün önce feed'de sağlanması gerekir. Bu, oyunun Google platformlarında zamanında gösterilme olasılığını artırır.
`actionAccessibilityRequirement.availabilityEnds`	Tarih	Zorunludur. İşlemin artık kullanılamayacağı tarih, ISO 8601 biçiminde (saat dilimi dahil). Tarih gelecekteki bir tarih olarak ayarlanabilir. `availabilityStarts` tarihinden 72 saat sonra veya daha geç olmalıdır. İçerik yayınlandıktan sonra her zaman kullanılabilir durumdaysa bu tarihi, geçerli tarihten 20 yıl sonra olarak ayarlayın. `availabilityEnds` tarihine yönelik tüm güncellemelerin, `availabilityEnds` tarihinden en az yedi gün önce feed'de yapılması gerekir. Bu, oyunun `availabilityEnds` tarihinde Google platformlarında görünmemeye başlama olasılığını artırır.
`actionAccessibilityRequirement.eligibleRegion`	Country, City, State, GeoShape veya Text	Zorunludur. İçeriğin kullanılabildiği bölgeler. İçerik dünya genelinde kullanılabiliyorsa özel dize `EARTH`'yı kullanın. Nelerin gerekli olduğunu öğrenmek için GeoShape özellikleri başlıklı makaleyi inceleyin.
`actionAccessibilityRequirement.ineligibleRegion`	Country, City, State, GeoShape veya Text	Geçerliyse zorunludur. İçeriğin kısıtlandığı bölgeler. İçerik `eligibleRegion` içinde her yerde kullanılabiliyorsa bu özelliği sağlamanız gerekmez. Nelerin gerekli olduğunu öğrenmek için GeoShape özellikleri başlıklı makaleyi inceleyin.
`actionAccessibilityRequirement.requiresSubscription`	MediaSubscription	Geçerliyse zorunludur. Kullanıcıların içeriğe erişmek için ihtiyaç duyduğu abonelik ayrıntıları. Ayrıntılar için Medya aboneliği özellikleri başlıklı makaleyi inceleyin. `category` değeri `subscription` ise bu özelliği sağlayın.
`actionAccessibilityRequirement.expectsAcceptanceOf`	Teklif	İçerik satın alma gerektiriyorsa zorunludur. İçerikle ilişkili teklifin ayrıntıları. Aşağıdaki durumlarda fiyat bilgilerini sağlayın: Tek seferlik satın alınan içerikler (`rental` veya `purchase`) Abonelerin ek satın alma işlemi yapmasını gerektiren abonelik tabanlı içerikler (`subscription`) Fiyat 0, 00 ise teklif nesnesini tamamen kaldırın ve `actionAccessibilityRequirement.category` değerini `free` olarak ayarlayın. Daha fazla bilgi için Fırsat özellikleri başlıklı makaleyi inceleyin.

Medya Aboneliği spesifikasyonu

Medya aboneliği nesnesi, içerik için gereken aboneliğin ayrıntılarını açıklar. Nesne, İşlem erişimi spesifikasyonu nesnesinin bir özelliği olan requiresSubscription'dır.

Önemli: Bu, actionAccessibilityRequirement.category subscription ise ve abonelik teklifiniz birden fazla paket veya katman içeriyorsa ya da eklenti desteği varsa gereklidir. Aboneliğiniz tek katmanlıysa ve kataloğunuzdaki tüm içeriklere erişim sağlıyorsa bu özelliği atlayın.

Mülk	Beklenen tür	Açıklama
`requiresSubscription.@type`	Metin	Zorunludur. Her zaman `MediaSubscription` olarak ayarlanır.
`requiresSubscription.@id`	URL	Zorunludur. Aboneliğin benzersiz kimliği. İçeriğe farklı aboneliklerle erişilebiliyorsa her aboneliğin benzersiz bir kimliği olmalıdır.
`requiresSubscription.name`	Metin	Zorunludur. Aboneliğin adı. Aşağıdakilere dikkat edin: İçeriğe farklı aboneliklerle erişilebiliyorsa bu adın, kullanıcı kimlik doğrulama sisteminizdeki adla eşleşmesi gerekir. Örneğin, bir kullanıcı Paket 1 adlı aboneliğe göre içeriğe erişebiliyorsa ancak kimlik doğrulama sistemi PKG1 adını kullanıyorsa PKG1'i kullanın.
`requiresSubscription.sameAs`	URL	İsteğe bağlı. Aboneliği açıklayan sayfa.
`requiresSubscription.identifier`	Metin	`category`, `subscription` ise ve `commonTier` yanlışsa zorunludur. Bu abonelik için, medya kataloğunuzdaki bir içerik grubuna erişimi temsil eden benzersiz bir dize. Google, `identifier` için şu söz dizimini kullanmanızı önerir:alan adı + iki nokta üst üste (:)+ içeriğe erişim düzeyi. Örnekler : `example.com`:basic, `example.com:premium`, `example.com:sports`
`requiresSubscription.commonTier`	Boole	Kategori abonelik olarak ayarlandıysa gereklidir. `commonTier` hakkında daha fazla bilgiyi ortak katman koşulları dokümanında bulabilirsiniz.

Teklif özellikleri

Bir teklif nesnesi, içerikle ilişkili fiyatı açıklar. Nesne, Action access specification object öğesinin bir özelliğidir (expectsAcceptanceOf). Bu özellik iki amaçla kullanılabilir:

Oyunun satın alma ayrıntılarını sağlamak için. Bu kullanım alanı için actionAccessibilityRequirement.category, purchase olarak ayarlanmalıdır.
İndirimde olan oyunun satın alma ayrıntılarını sağlamak için Bu kullanım alanında actionAccessibilityRequirement.category, purchase olarak ayarlanmalı ve işlem başına iki teklif sağlanmalıdır. Bunlardan biri liste fiyatı ayrıntılarını, diğeri ise indirimli fiyat ayrıntılarını sağlamak içindir.

Mülk	Beklenen tür	Açıklama
`expectsAcceptanceOf.@type`	Metin	Zorunlu: Her zaman `Offer` olarak ayarlayın.
`expectsAcceptanceOf.name`	Metin	İsteğe bağlı: Fırsatın adı.
`expectsAcceptanceOf.priceSpecification`	PriceSpecification	Zorunlu: Oyunla ilişkili fiyatlandırma ayrıntıları.
`expectsAcceptanceOf.priceSpecification.@type`	Metin	Zorunlu: Her zaman `UnitPriceSpecification` olarak ayarlayın.
`expectsAcceptanceOf.priceSpecification.price`	Number	Zorunlu: İçeriğin satın alma fiyatı. Fiyat, sıfır olmayan pozitif bir değer olmalıdır. Fiyatı 0, 00 olan oyunlar için lütfen `actionAccessibilityRequirement.category` değerini "free" olarak ayarlayın.
`expectsAcceptanceOf.priceSpecification.priceCurrency`	Metin	Zorunlu: Fiyatın 3 harfli ISO 4217 biçimindeki para birimi.
`expectsAcceptanceOf.priceSpecification.priceType`	PriceTypeEnumeration veya Text	Varsa zorunlu: Fırsatta belirtilen fiyat türü. `actionAccessibilityRequirement.category`, `purchase` olarak ayarlandığında bu zorunlu bir özelliktir ve yalnızca 2 değer kabul edebilir: `https://schema.org/ListPrice`: Oyunun liste fiyatını gösterir. `https://schema.org/SalePrice`: Bir oyunun indirimli fiyatını (genellikle sınırlı bir süre için geçerlidir) gösterir. İndirimli fiyatlandırma ayrıntıları sağlanırken hem `https://schema.org/ListPrice` hem de `https://schema.org/SalePrice` gereklidir.
`expectsAcceptanceOf.seller`	Kuruluş	İçerik satın alma teklifinde bulunan kuruluş.
`expectsAcceptanceOf.seller.@type`	Metin	Her zaman `Organization` olarak ayarlanır.
`expectsAcceptanceOf.seller.name`	Metin	Satıcının adı.
`expectsAcceptanceOf.seller.sameAs`	URL	Satıcıyı tanımlayan bir web sayfasının URL'si (örneğin, satıcının ana sayfası).

Desteklenen her ödeme duvarı türü için aşağıdaki örnekte actionAccessibilityObject öğesinin nasıl oluşturulması gerektiği hakkında bilgi verilmektedir:

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "nologinrequired",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    }
  }
}

Yalnızca bir saatlik deneme için ücretsizdir (giriş yapmanız gerekmez).

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "nologinrequired",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    }
    "expectsAcceptanceOf": {
      "@type": "Offer",
      "eligibleDuration": 60
    }
  }
}

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "free",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    }
  }
}

İndirimli tek seferlik satın alım

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "purchase",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    },
    "expectsAcceptanceOf": [
      {
        "@type": "Offer",
        "name": "Original Price",
        "priceSpecification": {
          "@type": "UnitPriceSpecification",
          "price": 7.99
          "priceCurrency": "USD"
          "priceType": "https://schema.org/ListPrice"
        },
        "seller": {
          "@type": "Organization",
          "name": "Example",
          "sameAs": "http://www.example.com/"
          }
        },
        {
          "@type": "Offer",
          "name": "Sale Price",
          "priceSpecification": {
            "@type": "UnitPriceSpecification",
            "price": 4.99
            "priceCurrency": "USD"
            "priceType": "https://schema.org/SalePrice"
          },
          "seller": {
          "@type": "Organization",
          "name": "Example",
          "sameAs": "http://www.example.com/"
        }
      }
    ]
  }
}

Tek seferlik satın alım

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "purchase",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    },
    "expectsAcceptanceOf": {
      "@type": "Offer",
      "price": 7.99,
      "priceCurrency": "USD",
      "seller": {
        "@type": "Organization",
        "name": "Example",
        "sameAs": "http://www.example.com/"
      }
    }
  }
}

Tek seviyeli/çok seviyeli/eklenti abonelikleri

{
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "subscription",
    "availabilityStarts": "2015-01-01T00:00Z",
    "availabilityEnds": "2015-12-31T00:00Z",
    "requiresSubscription": {
        "@type": "MediaSubscription",
        "name": "Example Package",
        "commonTier": true,
        "@id": "http://www.example.com/example_package"
    },
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    }
  }
}

Katmanlı abonelikler ve eklentiler

Aşağıda, katmanlı aboneliklerin ve eklentilerin nasıl uygulandığı açıklanmaktadır:

Tek katmanlı abonelik modelinde, servis sağlayıcının tek bir abonelik katmanı vardır. Tüm aboneler, abonelik paketlerinden bağımsız olarak aynı içeriğe erişebilir.
Katmanlı abonelik modelinde, bir hizmet sağlayıcının Gold, Silver ve Bronze gibi birden fazla abonelik katmanı vardır. Üst düzey aboneliği olan kullanıcılar, alt düzeydeki tüm içeriklere erişebilir. Ancak daha düşük katmanlı aboneliği olan kullanıcılar daha üst katmanlı içeriğe erişemez.
Eklenti aboneliği modelinde, bir servis sağlayıcı kullanıcıların haklarını genişletmesine ve temel aboneliğe içerik eklemesine olanak tanır. Kullanıcılar istedikleri kadar içerik ekleyebilir.

Bir öğenin genel şablonu

Bu, bir öğenin genel şablonuna ilişkin örnektir:

Şablon

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    {  },
    {
       "@context": ["http://schema.org", {"@language": "en"}],
       "@type": "VideoGame",
       "@id": "http://www.example.com/game007",
       "url": "http://www.example.com/game007",
       "name": "Games Bond 007",
       "exampleOfWork": [
        {  },
        {
           "@type": "VideoGame",
            "@id": "http://www.example.com/game007Stadia",
            "url": "http://www.example.com/game007Stadia",
            "name": "Games Bond 007",
            // Other properties
           "potentialAction": [
              {  },
              {
                  "@type": "PlayGameAction",
                  "target": [
                  {  },
                  {  }
                  ],
                 "actionAccessibilityRequirement": [
                 {  },
                 {  }
                 ]
              }
          ],
    ...
    }
  ]
}

Yapılandırılmış veri türü tanımları

Bu bölümde, VideoGame öğe türü için içerik işaretleme özellikleriyle ilgili ayrıntılar verilmektedir. İçeriğinizin arama sonuçlarında görüntülenmeye uygun olması için burada belirtilen zorunlu özellikleri eklemeniz gerekir. İçeriğiniz hakkında daha fazla bilgi eklemek için önemle tavsiye edilen özellikleri de eklemenizi öneririz. Bu özellikler daha iyi bir kullanıcı deneyimi sağlayabilir ve Google'ın Bilgi Grafiği ile öğe eşleştirmesi yapmamıza yardımcı olabilir.

VideoGame (Work) spesifikasyon tablosu

Mülk	Beklenen tür	Açıklama
`@context`	Metin	Zorunludur. Her zaman `["http://schema.org", {"@language": "xx"}]` olarak ayarlanır. Burada `xx` değeri, feed'deki dizelerin dilini gösterir. Her kök öğe bağlamının `@language` değeri, BCP 47 biçiminde uygun dil koduna ayarlanmalıdır. Örneğin, dil İspanyolca olarak ayarlanmışsa altyazı/dublaj dili İngilizce olsa bile adların İspanyolca olduğu varsayılır.
`@type`	Metin	Zorunludur. Her zaman `VideoGame` olarak ayarlanır.
`@id`	URL	Zorunludur. URI biçimindeki içerik tanımlayıcısı (ör. `https://example.com/1234abc. @id`) aşağıdaki koşulları karşılamalıdır: Kataloğunuzda genel olarak benzersiz olmalıdır. Statik. Kimlik, oyunun `url` özelliği değişse bile sabit olmalı ve zaman içinde değişmemelidir. Bu, bir opak dize olarak işlenir ve çalışan bir bağlantı olması gerekmez. Birleşik Kaynak Tanımlayıcısı (URI) biçiminde. @id değeri için kullanılan alan adı, kuruluşunuza ait olmalıdır. Bir öğenin `url` özelliği, tanımlayıcı koşullarının tümünü karşıladığından öğenin `@id` özelliği olarak öğenin `url` özelliğini kullanmanızı öneririz. Daha fazla bilgi için Tanımlayıcı bölümüne bakın.
`url`	URL	Zorunludur. İçeriğin standart URL'si. Google, feed'inizdeki içeriği Google'ın veritabanlarındaki içerikle eşleştirmek için bu URL'yi kullanır. `url` aşağıdaki koşulları karşılamalıdır: `url` değeri global olarak benzersiz olmalıdır. `url`, Google'ın tarayabileceği çalışan bir standart URL içermelidir. Bir oynatma işleminin derin bağlantısı için bunun yerine hedef nesnenin `urlTemplate` özelliğine bakın.
`name`	Metin	Oyunun adı. Adları farklı dillerde listelemek için dizi kullanın. Daha fazla bilgi için Birden çok bölge ve dil örneğine bakın. Her yerel ayar (dil-ülke çifti) için yalnızca bir adın desteklendiğini unutmayın.
`description`	Metin	Kesinlikle önerilir. Oyunun özeti. 300 karakter sınırı vardır. Açıklamayı birden fazla dilde işaretlemek için dizi kullanın. Daha fazla bilgi için Birden çok bölge ve dil örneğine bakın.
`genre`	Metin	İlgili tüm türlerin sıralı listesi. Örneğin: `["Action", "Role playing"]`
`image`	ImageObject	Kesinlikle önerilir. Oyunla ilgili resimler. `image` ile birlikte eklenmesi gereken zorunlu ve isteğe bağlı özellikler hakkında daha fazla bilgi için Resim özellikleri başlıklı makaleyi inceleyin.
`applicationCategory`	Metin	İsteğe bağlıdır. Yazılım uygulamasının türü. Değeri `Game` olarak ayarlayın.
`exampleOfWork`	VideoGame	Zorunlu: `VideoGame` sürümü. Bu `VideoGame` (Edition) öğesi, derin bağlantı ayrıntılarını da taşır. Daha fazla bilgi için VideoGame (Edition) spesifikasyon tablosuna bakın.
`playMode`	Text veya GamePlayMode	İsteğe bağlı. Bu oyunun çok oyunculu, ortaklaşa oynanan veya tek oyunculu olup olmadığını gösterir. Oyun aynı anda çok oyunculu, ortaklaşa oynanan ve tek oyunculu olarak işaretlenebilir. Aşağıdaki değerleri kabul eder: `SINGLE_PLAYER` `LOCAL_MULTI_PLAYER` `ONLINE_MULTI_PLAYER` `LOCAL_COOP` `ONLINE_COOP`

VideoGame (Edition) spesifikasyon tablosu

Mülk	Beklenen tür	Açıklama
`@type`	Metin	Zorunludur. Her zaman `VideoGame` olarak ayarlanır.
`@id`	URL	Zorunludur. URI biçimindeki içerik tanımlayıcısı (ör. `https://example.com/1234abc.@id`) aşağıdaki koşulları karşılamalıdır: Kataloğunuzda genel olarak benzersiz olmalıdır. Statik. Kimlik, oyunun `url` özelliği değişse bile sabit olmalı ve zaman içinde değişmemelidir. Bu, bir opak dize olarak işlenir ve çalışan bir bağlantı olması gerekmez. Birleşik Kaynak Tanımlayıcısı (URI) biçiminde. @id değeri için kullanılan alan adı, kuruluşunuza ait olmalıdır. Bir öğenin `url` özelliği, tanımlayıcı koşullarının tümünü karşıladığından öğenin `@id` özelliği olarak öğenin `url` özelliğini kullanmanızı öneririz. Daha fazla bilgi için Tanımlayıcı bölümüne bakın.
`url`	URL	Zorunludur. İçeriğin standart URL'si. Google, feed'inizdeki içeriği Google'ın veritabanlarındaki içerikle eşleştirmek için bu URL'yi kullanır. `url` aşağıdaki koşulları karşılamalıdır: `url` değeri global olarak benzersiz olmalıdır. `url`, Google'ın tarayabileceği çalışan bir standart URL içermelidir. Bir oynatma işleminin derin bağlantısı için bunun yerine hedef nesnenin `urlTemplate` özelliğine bakın.
`name`	Metin	Oyunun adı. Adları farklı dillerde listelemek için dizi kullanın. Daha fazla bilgi için Birden çok bölge ve dil örneğine bakın. Her yerel ayar (dil-ülke çifti) için yalnızca bir adın desteklendiğini unutmayın.
`description`	Metin	Kesinlikle önerilir. Oyunun özeti. 300 karakter sınırı vardır. Açıklamayı birden fazla dilde işaretlemek için dizi kullanın. Daha fazla bilgi için Birden çok bölge ve dil örneğine bakın.
`genre`	Metin	İlgili tüm türlerin sıralı listesi. Örneğin: `["Action", "Role playing"]`
`image`	ImageObject	Kesinlikle önerilir. Oyunla ilgili resimler. `image` ile birlikte eklenmesi gereken zorunlu ve isteğe bağlı özellikler hakkında daha fazla bilgi için Resim özellikleri başlıklı makaleyi inceleyin.
`applicationCategory`	Metin	İsteğe bağlıdır. Yazılım uygulamasının türü. Değeri `Game` olarak ayarlayın.
`playMode`	Text veya GamePlayMode	İsteğe bağlı. Bu oyunun çok oyunculu, ortaklaşa oynanan veya tek oyunculu olup olmadığını gösterir. Oyun aynı anda çok oyunculu, ortaklaşa oynanan ve tek oyunculu olarak işaretlenebilir. Aşağıdaki değerleri kabul eder: `SINGLE_PLAYER` `LOCAL_MULTI_PLAYER` `ONLINE_MULTI_PLAYER` `LOCAL_COOP` `ONLINE_COOP`
`potentialAction`	PlayGameAction	Geçerliyse zorunludur. İşlemin ayrıntılarını sağlayan bir Action markup object. Birden fazla bölgede farklı derin bağlantılar belirtmek için dizi kullanın. Daha fazla bilgi için Birden fazla bölge ve dil örneğine bakın.
`gameEdition`	Metin	Zorunludur. Bu oyunun sürümü. Örneğin, popüler oyun "Shadow of the Tomb Raider" dört sürümde sunulur: "Croft Edition", "Standard Edition", "Digital Deluxe Edition" ve "Ultimate Edition".
`gamePlatform`	Metin	Zorunludur. Video oyununu oynamak için kullanılan platform veya elektronik sistem.
`releasedEvent`	PublicationEvent	Kesinlikle önerilir. `PublicationEvent`, yayıncı tarafından yayınlanan içeriğin orijinal (global veya yerel) sürümünü belirtmek için kullanılır.
`releasedEvent.@type`	Metin	Zorunludur. Bu özelliği her zaman `PublicationEvent` olarak ayarladığınızdan emin olun.
`releasedEvent.Location`	Ülke	Zorunludur. Bu lansman etkinliğiyle ilişkili bölgeler. Ülkeler için ISO 3166 kodlarını kullanın. Dünyanın her yerini belirtmek için `EARTH` olarak ayarlayın.
`releasedEvent.startDate`	Tarih veya Saat	Önerilen. `ExclusiveEvent` için gereklidir. Öğenin yayınlanma başlangıç tarihi.
`releasedEvent.endDate`	Tarih veya Saat	İsteğe bağlı. Bu, içerik haklarının geçerliliğinin sona erdiği tarihi gösterir.
`releasedEvent.publishedBy`	Organization veya Person	İsteğe bağlı. Bu öğeyi yayınlayan kuruluş veya kişi.
`contentRating`	Metin	Yetişkinlere yönelik oyunlar için zorunlu, diğer durumlarda ise önemle tavsiye edilir. Genel içerik derecelendirmesi. İçerik derecelendirmesi metin dizesi biçiminde veriliyorsa iki varyasyon kabul edilir: Derecelendirme kuruluşu, derecelendirmenin başına aralarında boşluk olacak şekilde eklenir. Örneğin, ABD'deki "Entertainment Software Rating Board" adlı ajansın verdiği "Yetişkin" derecesi `Entertainment Software Rating Board Mature` olarak açıklanmalıdır. Oyunun derecelendirmesini bilmediğinizi belirtmek için `RATING NOT KNOWN` değeri (büyük/küçük harfe duyarlı değildir).
`publisher`	Organization veya Person	İsteğe bağlı. Bu öğeyi yayınlayan kuruluş veya kişi.
`contributor`	Organization veya Person	İsteğe bağlı. Bu varlığa katkıda bulunan ikincil bir kullanıcı.

Resim özellikleri tablosu

Play Game İşlemleri, resim şartlarını karşılamak için Medya İşlemleri şemasını yeniden kullanır. Daha fazla bilgi için resim şeması özelliklerini inceleyin.

Aklınızda bulundurmanız gereken diğer koşullar aşağıda verilmiştir.

En boy oranı ve `contentAttributes`	Minimum çözünürlük (piksel cinsinden)
16:9, ikonik poster	3.840x2.160
2:3, ikonik poster	1000x1500
4:3, ikonik poster	800x600
1:1, ikonik poster	600x600
3:4, ikonik poster	600x800
16:9, ikonik arka plan [tercih edilir] veya sahne fotoğrafı	3.840x2.160
2:3, simgesel arka plan [tercih edilir] veya sahneStill	1000x1500
3:4, ikonik arka plan [tercih edilir] veya sahne fotoğrafı	600x800

Biçim şartları

Resim boyutu, kalitesi vb. için uymanız gereken biçim koşulları şunlardır:

Oyun için sahip olduğunuz en yüksek çözünürlüklü posterleri ve sceneStills ekleyin.
Resim JPG, PNG veya WebP biçiminde olmalıdır.
Resmin URL'si taranabilir ve dizine eklenebilir olmalıdır.
Dosya boyutları 20 MB'ı aşmamalıdır.
Hem smallFormat hem de largeFormat için uygun olan resimleri tercih ederiz.
Resimde aşağıdakiler bulunmamalıdır:
- Bulanık, pikselli, döndürülmüş veya kalitesi düşük resim
- Lisanssız veya stok fotoğraflar
- Çıplaklık
- Yasa dışı içerik.
Önceki tabloda listelenenlerin yanı sıra resim boyutlarını da ekleyebilirsiniz.

Örnekler

Aşağıdaki bölümlerde, farklı senaryolar için örnek feed'ler yer almaktadır.

Bir VideoGame öğesi içeren örnek feed

VideoGame "Space Wars Made Up Game" oyununu temsil eden bir öğe örneğini aşağıda bulabilirsiniz. Bu öğenin, Google tarafından görülebilmesi için JSON dosyasında veri feed'i zarfı içine alınması gerektiğini unutmayın.

{
   "@context": ["http://schema.org", {"@language": "en"}],
   "@type":"DataFeed",
   "dateModified":"2021-07-20T00:44:51Z",
   "dataFeedElement":[
      {
         "@context": ["http://schema.org", {"@language": "en"}],
         "@id":"https://www.examplegame.com/VideoGame007",
         "@type":"VideoGame",
         "url":"https://www.examplegame.com/games/VideoGame007",
         "name":"Space Wars Made Up Game",
         "description":"Space Wars offers an immersive RPG experience coupled with realistic gameplay.",
         "genre":[
            "Role playing"
         ],
         "applicationCategory":"Game",
         "publisher":{
            "name":"Made Up Media",
            "@id":"https://www.examplegame.com/uniuqe-id-org",
            "@type":"Organization"
         },
         "contributor":[
            {
               "roleName":"developer",
               "name":"Alpha Labs Man Made Studio",
               "@id":"https://www.studionice.com/uniuqe-id-alpha",
               "@type":"Organization"
            }
         ],
         "playMode":[
           "SINGLE_PLAYER", "LOCAL_MULTI_PLAYER", "ONLINE_MULTI_PLAYER", "LOCAL_COOP", "ONLINE_COOP"
         ],
         "image":[
            {
               "@context":"http://schema.org",
               "@type":"ImageObject",
               "name":"keyart_1X1_3X",
               "contentUrl":"https://lh3.googleusercontent.com/ept4",
               "copyrightHolder":{
                  "@type":"Organization",
                  "name":"Studio Nice"
               },
               "additionalProperty":[
                  {
                     "@type":"PropertyValue",
                     "name":"contentAttributes",
                     "value":[
                         "SMALLFORMAT", "LARGEFORMAT", "SCENESTILL", "CENTERED", "NOTITLE", "NOLOGO"
                     ]
                  }
               ]
            }
         ],
         "exampleOfWork":{
            "@id":"https://www.examplegame.com/VideoGame007/version/v3",
            "name":"Space Wars Made Up Game",
            "description":"Space Wars offers an immersive RPG experience coupled with realistic gameplay.",
            "gameEdition":"Early Access",
            "url":"https://www.examplegame.com/VideoGame007/version/v3/stream",
            "contentRating":[
               "Entertainment Software Rating Board Mature",
               "Pan European Game Information 12",
               "Unterhaltungssoftware Selbstkontrolle Video Game Rating System USK 12"
            ],
            "applicationCategory":"Game",
            "releasedEvent":[
               {
                  "@type":"PublicationEvent",
                  "startDate":"2020-11-30",
                  "location":{
                     "@type":"Country",
                     "name":"US"
                  }
               }
            ],
            "potentialAction":{
               "@type":"PlayGameAction",
               "gameAvailabilityType":"DEMO",
               "target":[
                  {
                     "@type":"EntryPoint",
                     "urlTemplate":"https://www.examplegame.com/VideoGame007/play",
                     "actionPlatform":[
                        "http://schema.org/DesktopWebPlatform",
                        "http://schema.org/MobileWebPlatform",
                        "http://schema.org/AndroidPlatform",
                        "http://schema.org/AndroidTVPlatform",
                        "http://schema.org/IOSPlatform"
                     ]
                  }
               ],
               "actionAccessibilityRequirement":[
                  {
                     "@type":"ActionAccessSpecification",
                     "availabilityStarts": "2015-01-01T00:00Z",
                     "availabilityEnds": "2015-12-31T00:00Z",
                     "eligibleRegion":{
                        "@type":"Country",
                        "name":[
                           "US"
                        ]
                     },
                     "category":"subscription",
                     "requiresSubscription":{
                        "@type":"MediaSubscription",
                        "name":"",
                        "@id":""
                     }
                  }
               ],
            },
            "gamePlatform": "Google Stadia",
            "publisher":{
               "name":"Made Up Media",
               "@id":"https://www.examplegame.com/uniuqe-id-org",
               "@type":"Organization"
            },
            "contributor":[
               {
                  "roleName":"developer",
                  "name":"Alpha Labs Man Made Studio",
                  "@id":"https://www.studionice.com/uniuqe-id-alpha",
                  "@type":"Organization"
               }
            ]
         }
      }
   ]
}

İki oyun karakterinin yer aldığı örnek bir resmi temsil eder.

{
  "@context": [ "http://schema.org", { "@language": "en" } ],
  "@type": "VideoGame",
  "@id": "http://www.examplegame.com/videoGame1",
  "url": "http://www.examplegame.com/videoGame1",

  ...,

  "image": {
    "@context": "http://schema.org",
    "@type": "ImageObject",
    "name": "Mauren and Lord Wingflap!",
    "Keywords": "Mauren, Lord Wingflap the Destroyer",
    "contentUrl": "http://example.com/images/mountain-view.jpg",
    "character": [
      { "@type": "Person", "name": "Mauren" },
      { "@type": "Person", "name": "Lord Wingflap the Destoyer" }
    ],
    "copyrightHolder": {
      "@type": "Organization",
      "name": " ExampleOrganization Studios, Inc."
    },
    "inLanguage": "en-US",
    "audience": {
        "@type": "Audience",
        "geographicArea": [{"@type": "Country", "name": "US"},
                           {"@type": "Country", "name": "GB"}]
    },
    "additionalProperty": [
      {
        "@type": "PropertyValue",
        "name": "contentAttributes",
        "value": [ "iconic", "background", "rightCentered", "noTitle", "noLogo",
                   "noCopyright", "noMatte", "smallFormat", "largeFormat"]
      }
    ]
  }
}

Birden fazla bölge ve dille ilgilenme (Uluslararasılaştırma)

Bir VideoGame öğesi birden fazla bölgede ve dilde kullanılabilir.

Not: @language, @value için kullanılan dili gösterir. İçeriğin bu dilde veya bu bölgede kullanılabileceği anlamına gelmez. Örneğin, pt-br @language ifadesi, içeriğin Brezilya'da Portekizce olarak sunulduğu anlamına gelmez. @value ifadesinde kullanılan dili tanımlar. İçeriğin nerede kullanılabileceğini belirtmek için eligibleRegion özelliğini kullanın.

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "VideoGame",
  "@id": "http://www.example.com/my_favorite_game",
  "url": "http://www.example.com/my_favorite_game",
  "name": [
    {
      "@language": "en-us",
      "@value": "My Favorite Game"
    },
    {
      "@language": "es-mx",
      "@value": "mi juego favorito"
    },
    {
      "@language": "ja-jp",
      "@value": "私のfavourite game"
    }
  ],
  "description": [
    {
      "@language": "en-us",
      "@value": "Jenny meets Paul."
    },
    {
      "@language": "es-mx",
      "@value": "Jenny conoce a paul."
    },
    {
      "@language": "ja-jp",
      "@value": "PaulとJennyが会う。"
    }
  ],
  "potentialAction": [
    {
      "@type": "PlayGameAction",
      "gameAvailabilityType": "DEMO",
      "additionalType": "DownloadPlayAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/my_favorite_game?autoplay=true",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform"
        ]
      }
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "purchase",
        "availabilityStarts": "2021-06-24T11:00:00Z",
        "availabilityEnds": "2041-06-24T11:00:00Z",
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "US"
          },
          {
            "@type": "Country",
            "name": "MX"
          }
        ]
      },
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "contentLanguage",
          "value": [
            "en",
            "es"
          ]
        }
      ],
      "expectsAcceptanceOf": {
        "@type": "Offer",
        "priceSpecification": [
          {
            "@type": "UnitPriceSpecification",
            "price": 19.99,
            "priceCurrency": "USD",
            "priceType": "https://schema.org/ListPrice"
          },
          {
            "@type": "UnitPriceSpecification",
            "price": 360.00,
            "priceCurrency": "MXN",
            "priceType": "https://schema.org/ListPrice"
          }
        ],
        "seller": {
          "@type": "Organization",
          "name": "My Favorite Game Publisher"
        }
      }
    },
    {
      "@type": "PlayGameAction",
      "gameAvailabilityType": "DEMO",
      "additionalType": "DownloadPlayAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/jp/my_favorite_game?autoplay=true",
        "actionPlatform": [
          "http://schema.org/DesktopWebPlatform",
          "http://schema.org/MobileWebPlatform"
        ]
      }
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "purchase",
        "availabilityStarts": "2021-07-24T11:00:00Z",
        "availabilityEnds": "2041-07-24T11:00:00Z",
        "eligibleRegion": [
          {
            "@type": "Country",
            "name": "JP"
          }
        ]
      },
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "contentLanguage",
          "value": [
            "ja"
          ]
        }
      ],
      "expectsAcceptanceOf": {
        "@type": "Offer",
        "priceSpecification": [
          {
            "@type": "UnitPriceSpecification",
            "price": 2189,
            "priceCurrency": "JPY",
            "priceType": "https://schema.org/ListPrice"
          }
        ],
        "seller": {
          "@type": "Organization",
          "name": "My Favorite Game Publisher"
        }
      }
    }
  ],
  // Other properties...
}

Play Games İşlemleri

Genel Bakış