Halaman ini diterjemahkan oleh Cloud Translation API.

Tindakan Play Game

Ringkasan

Dokumen ini memperkenalkan Tindakan Game Play untuk Game Video, mencantumkan persyaratan skema, dan menjelaskan proses aktivasi untuk meluncurkan fitur ini.

Pengantar Tindakan Game Play

Gambar Tindakan Game Play di perangkat seluler

Tindakan Mainkan Game untuk Game Video memungkinkan pengguna memainkan game langsung dari Halaman Hasil Penelusuran (SRP) di desktop atau perangkat seluler. Pengguna akan melihat Tindakan Mainkan Game di dalam tab Ringkasan Halaman Hasil Penelusuran Terstruktur (OSRP) atau di Panel Info saat mereka menelusuri game yang memiliki setidaknya satu Tindakan Mainkan Game yang terkait dengannya. Cara ini berfungsi untuk versi demo atau versi lengkap game yang tersedia secara gratis, melalui langganan, atau pembelian a la carte dan dapat di-streaming dari cloud di desktop atau perangkat seluler, atau dapat didownload melalui aplikasi klien lokal di desktop atau konsol.

Tindakan Game Play didukung oleh feed, yang berisi detail katalog game Anda. Feed adalah objek JSON yang berisi kumpulan entitas. Entitas adalah objek schema.org yang merepresentasikan game dalam katalog Anda dan deep link terkait untuk melakukan streaming game (demo, uji coba instan, atau versi lengkap).

Agar Google dapat memperoleh feed Anda, Anda harus menyimpan feed dalam file dan menghosting file di lokasi tempat Google dapat mengaksesnya. Untuk memastikan konten Anda selalu terbaru, Google secara rutin mengambil file feed dari host Anda.

Kami akan membahas detail setiap persyaratan ini di bagian berikut.

Mulai

Seperti yang dinyatakan di bagian sebelumnya, tanggung jawab Anda sebagai penyedia meliputi hal berikut:

Pahami informasi yang Anda perlukan untuk membuat feed; sumber dan ketersediaannya, serta cara informasi tersebut masuk ke feed.
Buat feed yang berisi detail wajib dari setiap entitas game dalam katalog Anda.
Hosting feed di server atau layanan penyimpanan cloud dan izinkan Google mengambil feed secara rutin.
Tanggapi dan perbaiki masalah yang diangkat oleh Google. Masalah ini dapat terkait dengan kualitas atau masalah terkait struktur file JSON itu sendiri.
Pastikan feed selalu diupdate seiring perkembangan katalog Anda.
Pastikan kualitas feed tetap terjaga setelah peluncuran.

Mari kita pahami hal ini secara mendetail.

Sebelum memulai

Sebelum mulai membuat feed, sebaiknya Anda meluangkan waktu untuk memahami persyaratan metadata Tindakan Game Play dan mengumpulkan semua informasi yang diperlukan di satu tempat. Sebaiknya Anda melakukan hal berikut sebelum mulai membuat feed:

Tinjau persyaratan metadata untuk entity VideoGame.
Kumpulkan metadata.
- Perhatikan baik-baik properti wajib dan sangat direkomendasikan. Google menggunakan properti ini untuk merekonsiliasi konten Anda di feed dengan konten di database Google; makin banyak metadata yang Anda berikan untuk konten Anda, makin baik Google dapat mencocokkan konten tersebut.

Memahami penggunaan Karya dan Edisi dalam dokumentasi ini

Karya: Konsep abstrak video game. Secara khusus, metadata seperti judul, developer, deskripsi game, dan penerbit adalah atribut sebuah karya.
Edisi: Versi konkret video game. Secara khusus, metadata seperti tahun penerbitan, nama platform, dan deep link adalah atribut edisi.

Misalnya, “Shadow of the Tomb Raider” adalah karya, tetapi setiap versi yang disertakan merupakan edisi. Dalam hal ini, karya “Shadow of the Tomb Raider” dapat memiliki satu edisi untuk Stadia, satu edisi untuk PlayStation, satu edisi untuk Akses Awal di Stadia, dan sebagainya.

Perbedaan ini sangat penting dalam feed, tempat perbedaan tersebut mungkin tidak langsung terlihat. Ada dua entitas VideoGame:

VideoGame (Work) adalah entitas VideoGame "level atas":

exampleOfWork adalah properti VideoGame (Karya) dan menentukan satu atau beberapa instance VideoGame (Edisi).
Setidaknya harus ada satu exampleOfWork VideoGame (Edisi) untuk setiap VideoGame (Karya).

VideoGame (Edisi) adalah entitas VideoGame "level bawah".

Perlu diingat bahwa bisa terdapat beberapa edisi untuk sebuah karya. Sebaiknya Anda mengelompokkan edisi sebisa mungkin. Hal ini membantu sistem Google memanfaatkan semua informasi yang relevan tentang VideoGame dan menampilkannya di Penelusuran.

Pahami dua properti utama dan persyaratannya. Anda harus melakukannya dengan benar saat beralih ke pembuatan feed, yang merupakan langkah berikutnya.

URL Kanonis (url)

URL kanonis (url) membantu Google merekonsiliasi konten di katalog Anda dengan konten di database Google secara akurat.

"URL kanonis adalah URL halaman yang dianggap Google sebagai URL paling representatif dari sekumpulan halaman duplikat di situs Anda. Misalnya, jika Anda memiliki URL untuk halaman yang sama (misalnya: example.com?dress=1234 dan example.com/dresses/1234), Google akan memilih salah satu URL sebagai kanonis." (Sumber: Mengonsolidasikan URL duplikat)

Berikut adalah persyaratan untuk URL kanonis:

url harus unik secara global.
url harus berisi URL kanonis yang berfungsi dan dapat di-crawl oleh Google.

ID (@id)

ID (@id) harus memenuhi persyaratan berikut:

Unik secara global di seluruh katalog Anda:
- Misalnya, jangan gunakan @id yang sama untuk dua video game yang berbeda.
Statis:
- Anda tidak dapat mengubah @id nanti.
Dalam bentuk Unified Resource Identifier (URI):
- Jika ID konten lokal Anda tidak dalam format URI, tambahkan domain Anda ke ID untuk memenuhi persyaratan ini; misalnya, jika ID konten Anda adalah 1234abc dan domain Anda adalah https://example.com, @id dapat berupa https://example.com/1234abc.
- @id tidak harus berupa URL yang berfungsi; hanya perlu dalam format URI.
- Domain yang digunakan di @id (misalnya, https://example.com) harus dimiliki oleh organisasi Anda.

Karena url entitas memenuhi semua persyaratan sebagai ID (yaitu, unik secara global, statis, dan dalam bentuk URI), sebaiknya Anda menggunakan url entitas sebagai @id jika masuk akal.

Memahami dan mengidentifikasi persyaratan deep link

Saat pengguna memulai Tindakan Game Play pada konten, Google menggunakan deep link konten untuk mengarahkan pengguna langsung ke konten di aplikasi atau platform Anda. Perhatikan hal-hal berikut:

Deep link harus membuka konten yang ditargetkan di semua platform yang ditentukan. Platform yang berbeda dapat memiliki deep link yang berbeda. Misalnya, deep link yang berfungsi di web desktop dapat berbeda dengan deep link yang berfungsi di web seluler. Untuk setiap game, periksa apakah game tersebut memiliki deep link yang berbeda berdasarkan platform.
Deep link dapat menyertakan parameter (&) atau tag anchor (#).
Untuk memastikan konten Anda tersedia di berbagai platform Google (Penelusuran, Asisten, dan Android TV), deep link adalah persyaratan.

Karena url entitas memenuhi semua persyaratan sebagai ID (yaitu, unik secara global, statis, dan dalam bentuk URI), sebaiknya gunakan url entitas sebagai @id jika memungkinkan.

Platform	Deskripsi
http://schema.org/DesktopWebPlatform	Platform penelusuran di browser web desktop.
http://schema.org/MobileWebPlatform	Platform penelusuran di browser web seluler.
http://schema.org/AndroidPlatform	Platform penelusuran di aplikasi Android.
http://schema.org/AndroidTVPlatform	Platform Android TV di aplikasi Android TV.
http://schema.org/IOSPlatform	Platform penelusuran di aplikasi iOS.

Identifikasi persyaratan akses untuk game dalam katalog Anda: Ajukan pertanyaan berikut dan pastikan ada cara untuk mengidentifikasi jawabannya melalui metadata di feed.

Apakah pengguna perlu login ke aplikasi atau platform Anda untuk mengakses konten?
Apakah pengguna memerlukan langganan?
Apakah pengguna perlu melakukan pembelian untuk memainkan game?
Apakah persyaratan akses berubah dari waktu ke waktu?
Apakah persyaratan akses bergantung pada lokasi perangkat?

Jika Anda menawarkan lebih dari satu paket langganan yang dapat dibeli pengguna, pahami apa itu commonTier dan bagaimana penerapannya pada integrasi Anda dengan Google.

Jenis penghalang konten berbayar

Tindakan Game Play saat ini hanya mendukung jenis penghalang konten berbayar berikut:

Nilai kategori	Jenis penghalang konten berbayar
`nologinrequired`	Tidak perlu melakukan pembelian atau login.
`free`	Pengguna harus login, tetapi tidak memerlukan langganan berbayar.
`subscription` Catatan: Markup tingkatan umum diperlukan.	Pengguna harus memiliki langganan aktif. Akses tidak bergantung pada tingkat langganan.
`subscription` Catatan: Tentukan kumpulan ID hak yang diperlukan untuk mengakses konten ini dengan `MediaSubscription.identifier`. Untuk mengetahui informasi selengkapnya, lihat ID hak. Markup tingkat umum mungkin diperlukan.	Pengguna harus memiliki langganan aktif. Akses tidak bergantung pada tingkat langganan.
`purchase`	Konten tersedia selama jangka waktu yang tidak ditentukan setelah pembelian.
`rental`	Konten tersedia selama jangka waktu terbatas setelah pembelian.

Nilai kategori ini akan digunakan nanti saat membuat feed. Selain itu, pertimbangkan bahwa kategori rental dalam tabel sebelumnya bersifat opsional sepenuhnya saat ini dan mungkin didukung dalam peningkatan produk di masa mendatang. Saat ini, hanya nilai kategori free, nologinrequired, subscription, dan purchase yang digunakan oleh produk dari feed.

Terakhir, lihat sekilas feed sampel untuk mendapatkan gambaran tentang hasil yang kita inginkan.

Memahami hal di atas dan memastikan ada metadata untuk merepresentasikan jawaban (atas pertanyaan-pertanyaan ini), yang cukup untuk melanjutkan ke tahap pembuatan feed.

Membuat feed

Feed Tindakan Game Play adalah objek JSON yang berisi kumpulan entitas yang mewakili video game dalam katalog Anda. Anda harus memberikan feed sebagai file atau sebagai beberapa file, dan menghostingnya di server atau layanan penyimpanan cloud agar Google dapat mengambilnya secara rutin.

Mematuhi persyaratan ukuran, kuantitas, dan format file feed

Anda harus mematuhi persyaratan berikut:

Semua file feed harus menggunakan ekstensi nama file .json.
Pastikan nama file tidak berisi spasi.
Jangan mengenkripsi file feed Anda.
Encode file feed Anda dalam UTF-8 (periksa setelan editor file Anda).
Jika ukuran file feed yang tidak dikompresi lebih dari 1 GB, bagi file tersebut menjadi beberapa file.
- Selama ukuran file kurang dari 1 GB, tidak ada batasan jumlah entitas yang dapat Anda sertakan dalam satu file atau jumlah file yang akhirnya Anda kirimkan ke Google sebagai bagian dari pengiriman feed.
Pastikan file dienkode tanpa BOM, sesuai dengan spesifikasi JSON. Untuk memverifikasi hal ini di OS Linux, hexdump file.json | head -n 1 tidak boleh dimulai dengan BBEF di alamat 0x00.

Mematuhi persyaratan konten feed

Anda harus mematuhi persyaratan konten berikut:

Feed tidak boleh berisi entitas yang telah usang. Entitas usang adalah entitas yang availabilityEnds link dalamnya ditetapkan ke tanggal yang telah berlalu atau entitas yang tidak lagi tersedia di situs Anda.
Semua deep link, seperti urlTemplate, dan semua URL, seperti url, yang Anda sertakan dalam feed harus berupa URL produksi. Jangan gunakan URL UM, pengembangan, atau jenis URL non-produksi lainnya.
Semua URL, seperti url, harus bersifat kanonis, seperti yang disebutkan di bagian sebelumnya.
Setiap entitas dalam feed Anda harus menentukan properti berikut:
- ID unik: @id
- URL unik: url
- Deep link unik: urlTemplate

Kami memiliki rekomendasi berikut untuk Anda saat membuat feed:

Pahami struktur feed secara mendetail.
Mulai dengan contoh feed.
- Pilih hingga lima entitas perwakilan dari katalog Anda. Pilih entitas dengan struktur yang cukup kompleks, tetapi masih umum untuk entitas dalam katalog, dan buat feed untuk entitas yang sama.
Kirimkan kepada perwakilan Google yang ditugaskan untuk validasi cepat.
Setelah Anda menyelesaikan semua error di feed contoh, perluas feed untuk menyertakan semua entitas dalam katalog Anda.
- Untuk mengonfirmasi bahwa feed Anda menyertakan semua entitas dalam katalog, bandingkan jumlah entitas dalam feed Anda dengan jumlah item dalam katalog Anda.

Menghosting feed

Setelah file feed Anda siap, hosting file tersebut di lokasi yang aman. Kemudian, Google akan mengambil feed secara rutin untuk memastikan bahwa konten Anda adalah konten terbaru. Kami mendukung metode hosting berikut:

Metode hosting	Dukungan autentikasi
Google Cloud Storage	Beri izin Storage Object Viewer ke `088794101-100000002-account@partnercontent.gserviceaccount.com`
HTTPS	Mewajibkan Anda membagikan Nama Pengguna+Sandi atau sertifikat klien HTTP.
SFTP	Meminta Anda membagikan Sandi, Kunci+Frasa, atau keduanya.
AWS S3	Meminta Anda membagikan ID Kunci+Kunci Akses untuk bucket AWS S3.

Setelah Anda mengupload file feed ke sistem host, hubungi tim Tindakan Game Play untuk meninjau file feed Anda.

Mengirimkan feed untuk ditinjau

Setelah file feed dihosting, hubungi kontak Tindakan Game Play yang ditetapkan untuk Anda guna memulai proses peninjauan feed. Pastikan untuk membagikan informasi berikut dalam komunikasi ini:

Ringkasan/Deskripsi: Beri tahu kami jika Anda membagikan feed contoh atau feed produksi lengkap. Jika membagikan feed contoh, beri tahu kami perkiraan waktu penyelesaian untuk feed produksi, jika memungkinkan.
Lokasi host: URL file feed Anda.
Autentikasi host: Sertakan kredensial autentikasi agar Google dapat mengambil file feed dari host Anda, jika berlaku. Untuk mengetahui informasi selengkapnya, lihat Menghosting feed.
Akun pengujian: Akun pengujian yang memungkinkan tim Tindakan Game Play mengakses deep link di aplikasi atau platform Anda untuk pengujian. Jika feed Anda memiliki entitas di beberapa platform, berikan akun pengujian untuk setiap platform.
Icons: Kirim lima ikon berikut. Ikon ini digunakan di samping Tindakan Game Play di Penelusuran.

Kategori	Dimensi (px)	Ukuran file	Panduan
Memutar Action Game di Penelusuran/Cast/Lainnya
	16x16	Ukuran file untuk semua ikon, kecuali 112x112 px, tidak boleh lebih besar dari 1 KB. Ukuran file untuk ikon 112x112 piksel tidak boleh lebih besar dari 3 KB.	Semua lima dimensi ikon diperlukan. Gambar harus mematuhi hal berikut: Format file PNG. Bentuk bulat. Latar belakang transparan. Pastikan gambar di-anti-alias dan tidak terdistorsi atau berpiksel.
	20x20
	40x40
	44x44
	112x112

Contoh

Cara kerja validasi feed

Ada dua tahap validasi feed:

Validasi struktur:
- Ini adalah fase pertama pemeriksaan validasi.
- Google memberikan masukan terkait struktur file JSON. Apakah JSON terbentuk dengan baik? Apakah kita memiliki semua properti wajib dan properti yang sangat direkomendasikan di feed? Apakah deep link disediakan dan diberi anotasi sesuai dengan persyaratan feed kami?
- Fase ini memerlukan beberapa diskusi dua arah dengan Google dan berlanjut hingga semua masukan ditangani.
Penyelesaian Metadata:
- Proses ini dimulai hanya setelah feed lulus fase validasi struktur dan saat itulah Google memulai proses rekonsiliasi dengan Grafik Pengetahuan Google.
- Pada fase ini, kami memberikan masukan tentang metadata yang ada dalam feed. Semua masalah harus diselesaikan agar peluncuran berhasil. Misalnya, masukan dalam fase ini dapat meminta Anda memperbaiki judul game atau tanggal rilisnya.
- Fase ini juga memerlukan beberapa diskusi bolak-balik dengan Google dan berlanjut hingga semua masukan ditangani.

Kriteria penerimaan feed

Feed dianggap dapat diterima untuk peluncuran jika semua masalah pemblokiran telah diselesaikan dan Google telah mensertifikasi kualitas metadata berada di tingkat peluncuran.

Memperbarui feed jika perlu

Sebaiknya Anda memperbarui feed setiap hari, tetapi pada akhirnya bergantung pada frekuensi perubahan katalog Anda. Perhatikan kondisi dan tips berikut:

Google Penelusuran tidak mendukung pembaruan real-time.
Google Penelusuran mengambil feed Anda satu kali per hari dan biasanya mengindeks konten dalam dua hari (saat diluncurkan).
Jika ada rencana perubahan dalam ketersediaan deep link, gunakan availabilityStarts dan availabilityEnds untuk menetapkan tanggal yang tepat.
Jika entitas tidak lagi tersedia di katalog Anda, hapus sepenuhnya entitas tersebut dari feed.

Referensi

Ringkasan struktur feed

Feed Tindakan Game Play memiliki struktur berikut:

Envelope feed data

Amplop feed data adalah objek tingkat teratas dalam feed Tindakan Game Play. Objek berisi array objek markup konten (entitas VideoGame (Work)) yang merepresentasikan semua video game dalam katalog Anda.

Properti	Jenis yang diharapkan	Deskripsi
`@context`	URL	Wajib diisi. Disetel ke `http://schema.org`
`@type`	Teks	Wajib diisi. Tetapkan ke `DataFeed`.
`dateModified`	DateTime	Wajib diisi. Tanggal dan waktu terakhir diubahnya feed, dalam format ISO 8601 (termasuk zona waktu).
`dataFeedElement`	Thing	Wajib diisi. Entitas katalog game Anda.

Template

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

Objek markup konten

Objek markup konten mewakili satu entitas dalam katalog Anda: VideoGame (Karya). Objek berisi ID dan URL kanonis konten serta membantu mendeskripsikan konten melalui metadata. Objek markup konten untuk VideoGame (Work) memiliki properti bernama exampleOfWork untuk menautkannya ke objek VideoGame(Edition). VideoGame(Edisi) ini dapat memiliki array objek markup Action, yang memungkinkan konten dikaitkan dengan beberapa objek markup Action. Misalnya, konten dapat memiliki objek markup Tindakan yang berbeda untuk setiap wilayah.

Objek markup tindakan

Objek markup Tindakan menjelaskan deep link yang mengarahkan pengguna ke game dan tingkat akses yang diperlukan untuk game. Objek adalah properti (potentialAction) dari objek markup konten. Untuk Tindakan Game Play, gunakan objek spesifikasi akses Tindakan untuk menentukan batasan akses.

Properti	Jenis yang diharapkan	Deskripsi
`@type`	Teks	Wajib diisi. Selalu ditetapkan ke `PlayGameAction`.
`gameAvailabilityType`	GameAvailabilityEnumeration atau Text	Wajib diisi. Menunjukkan jenis ketersediaan konten game yang terkait dengan tindakan ini, seperti apakah konten tersebut versi lengkap atau demo. Nilai yang diterima mencakup `DEMO` dan `FULL`.
`additionalType`	Teks	Wajib diisi. Menunjukkan jenis tindakan bermain yang terkait dengan game ini. Nilai yang diterima mencakup: `StreamingPlayAction` - Menunjukkan bahwa game tersedia untuk di-streaming secara online `DownloadPlayAction` - Menunjukkan bahwa game tersedia untuk didownload
`target`	EntryPoint	Wajib diisi. Objek target yang menyediakan pemetaan deep link ke berbagai platform Google.
`target.@type`	Teks	Wajib diisi. Selalu ditetapkan ke `EntryPoint`.
`target.urlTemplate`	URL	Wajib diisi. Deep link yang mengarahkan pengguna ke aplikasi atau platform Anda dan memulai pemutaran game.
`target.inLanguage`	Teks	Opsional. Bahasa asli serial dalam format BCP 47.
`target.actionPlatform`	Teks	Wajib diisi. Platform yang dipetakan ke `urlTemplate`. Tindakan Game Play mendukung nilai berikut: http://schema.org/DesktopWebPlatform http://schema.org/MobileWebPlatform http://schema.org/AndroidPlatform http://schema.org/AndroidTVPlatform http://schema.org/IOSPlatform Untuk mengetahui persyaratan, lihat Jenis platform.
`actionAccessibilityRequirement`	ActionAccessSpecification	Wajib diisi. Objek spesifikasi akses tindakan yang menjelaskan persyaratan akses konten. Untuk mengetahui detailnya, lihat Properti Spesifikasi Akses Tindakan.

Template

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

Target

Objek target menyediakan pemetaan deep link ke berbagai platform Google. Objek adalah properti (target) dari objek markup Tindakan. Properti urlTemplate mengambil deep link dan actionPlatform mengambil platform yang mendukung deep link.

Contoh

"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"
    ]
  }
]

Spesifikasi akses tindakan

Objek spesifikasi akses Tindakan menjelaskan persyaratan akses untuk konten berdasarkan wilayah dan jangka waktu. Objek adalah properti, actionAccessibilityRequirement, dari objek markup Tindakan.

Contoh Target dengan dua deep link

"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"
    ]
  }
]

Spesifikasi akses tindakan

Objek spesifikasi akses Tindakan menjelaskan persyaratan akses untuk konten berdasarkan wilayah dan jangka waktu. Objek adalah properti, actionAccessibilityRequirement, dari objek markup Tindakan.

Properti	Jenis yang diharapkan	Deskripsi
`actionAccessibilityRequirement.@type`	Teks	Wajib diisi. Selalu ditetapkan ke `ActionAccessSpecification`.
`actionAccessibilityRequirement.category`	Teks	Wajib diisi. Persyaratan akses untuk konten. Untuk mengetahui nilai yang diterima dan informasi selengkapnya, lihat Jenis penghalang konten berbayar. Jika entitas mewakili sekelompok konten, Anda harus menetapkan kategori ke persyaratan akses yang paling tidak ketat dari kontennya. Misalnya, jika game memiliki akses yang tersedia tanpa biaya menggunakan `nologinrequired` dan melalui langganan, tetapkan kategori ke `nologinrequired`.
`actionAccessibilityRequirement.availabilityStarts`	Date	Wajib diisi. Tanggal setelah tindakan tersedia, dalam format ISO 8601 (termasuk zona waktu). Tanggal dapat ditetapkan di masa mendatang. Harus sama dengan atau lebih besar dari 72 jam setelah `availabilityStarts`. Jika konten selalu tersedia setelah dipublikasikan, tetapkan tanggal ini menjadi 20 tahun dari tanggal saat ini. Kami mewajibkan entitas terkait disediakan di feed setidaknya tujuh hari sebelum tanggal `availabilityStarts`-nya. Hal ini meningkatkan peluang game ditampilkan di platform Google tepat waktu.
`actionAccessibilityRequirement.availabilityEnds`	Date	Wajib diisi. Tanggal batas ketersediaan tindakan, dalam format ISO 8601 (termasuk zona waktu). Tanggal dapat ditetapkan di masa mendatang. Harus sama dengan atau lebih besar dari 72 jam setelah `availabilityStarts`. Jika konten selalu tersedia setelah dipublikasikan, tetapkan tanggal ini menjadi 20 tahun dari tanggal saat ini. Kami mewajibkan agar semua pembaruan pada tanggal `availabilityEnds` dilakukan di feed setidaknya tujuh hari sebelum tanggal `availabilityEnds`. Hal ini meningkatkan kemungkinan game berhenti muncul di platform Google pada tanggal `availabilityEnds`.
`actionAccessibilityRequirement.eligibleRegion`	Negara, Kota, Negara Bagian, GeoShape, atau Teks	Wajib diisi. Wilayah tempat konten tersedia. Jika konten tersedia secara global, gunakan string khusus `EARTH`. Untuk memahami apa yang diperlukan, lihat properti GeoShape.
`actionAccessibilityRequirement.ineligibleRegion`	Negara, Kota, Negara Bagian, GeoShape, atau Teks	Wajib jika berlaku. Wilayah tempat konten dibatasi. Anda tidak perlu memberikan properti ini jika konten tersedia di mana saja dalam `eligibleRegion`. Untuk memahami apa yang diperlukan, lihat properti GeoShape.
`actionAccessibilityRequirement.requiresSubscription`	MediaSubscription	Wajib jika berlaku. Detail langganan yang diperlukan pengguna untuk mengakses konten. Untuk mengetahui detailnya, lihat Properti langganan media. Berikan properti ini jika `category` adalah `subscription`.
`actionAccessibilityRequirement.expectsAcceptanceOf`	Penawaran	Wajib jika konten memerlukan pembelian. Detail penawaran yang terkait dengan konten. Berikan informasi harga untuk kasus berikut: Konten pembelian satu kali (`rental` atau `purchase`) Konten berbasis langganan yang memerlukan pembelian tambahan dari pelanggan (`subscription`) Jika harganya 0,00, hapus seluruh objek Penawaran dan tetapkan `actionAccessibilityRequirement.category` ke `free`. Untuk mengetahui detail selengkapnya, lihat Properti penawaran.

Spesifikasi Langganan Media

Objek langganan media menjelaskan detail langganan yang diperlukan untuk konten. Objek adalah properti, requiresSubscription, dari objek spesifikasi akses tindakan.

Penting: Hal ini diperlukan jika actionAccessibilityRequirement.category adalah subscription dan penawaran langganan Anda mencakup beberapa paket atau tingkat, atau memiliki dukungan add-on. Abaikan ini jika langganan Anda memiliki satu tingkat dan memberikan akses ke semua konten dalam katalog Anda.

Properti	Jenis yang diharapkan	Deskripsi
`requiresSubscription.@type`	Teks	Wajib diisi. Selalu ditetapkan ke `MediaSubscription`.
`requiresSubscription.@id`	URL	Wajib diisi. ID unik untuk langganan. Jika konten dapat diakses dengan langganan yang berbeda, setiap langganan harus memiliki ID unik.
`requiresSubscription.name`	Teks	Wajib diisi. Nama langganan. Perhatikan hal berikut: Jika konten dapat diakses dengan langganan yang berbeda, nama ini harus cocok dengan nama di sistem autentikasi pengguna Anda. Misalnya, jika pengguna dapat mengakses konten berdasarkan langganan yang disebut Paket 1, tetapi sistem autentikasi menggunakan nama PKG1, gunakan PKG1.
`requiresSubscription.sameAs`	URL	Opsional. Halaman yang menjelaskan langganan.
`requiresSubscription.identifier`	Teks	Wajib jika `category` adalah `subscription` dan `commonTier` salah. String unik untuk langganan ini yang merepresentasikan akses ke sekelompok konten dalam katalog media Anda. Google merekomendasikan agar Anda menggunakan sintaksis berikut untuk `identifier`:nama domain + titik dua (:) + tingkat akses ke konten, Contoh : `example.com`:basic, `example.com:premium`, `example.com:sports`
`requiresSubscription.commonTier`	Boolean	Wajib diisi jika kategori ditetapkan ke langganan. Baca selengkapnya tentang `commonTier` di dokumentasi persyaratan tingkat umum.

Properti penawaran

Objek penawaran menjelaskan harga yang terkait dengan konten. Objek adalah properti (expectsAcceptanceOf) dari Objek spesifikasi akses tindakan. Kolom ini dapat digunakan untuk dua tujuan:

Untuk memberikan detail pembelian game. actionAccessibilityRequirement.category harus ditetapkan ke purchase untuk kasus penggunaan ini.
Untuk memberikan detail pembelian game saat game sedang promo. actionAccessibilityRequirement.category harus disetel ke purchase untuk kasus penggunaan ini dan dua penawaran per tindakan harus diberikan - satu untuk memberikan detail harga jual dan satu lagi untuk detail harga promo.

Properti	Jenis yang diharapkan	Deskripsi
`expectsAcceptanceOf.@type`	Teks	Wajib - Selalu ditetapkan ke `Offer`.
`expectsAcceptanceOf.name`	Teks	Opsional - Nama penawaran.
`expectsAcceptanceOf.priceSpecification`	PriceSpecification	Wajib - Detail harga yang terkait dengan game.
`expectsAcceptanceOf.priceSpecification.@type`	Teks	Wajib - Selalu ditetapkan ke `UnitPriceSpecification`.
`expectsAcceptanceOf.priceSpecification.price`	Number	Wajib - Harga pembelian konten. Harga harus berupa nilai positif bukan nol. Untuk game dengan harga 0,00, tetapkan `actionAccessibilityRequirement.category` ke `free`.
`expectsAcceptanceOf.priceSpecification.priceCurrency`	Teks	Wajib - Mata uang harga dalam format ISO 4217 3 huruf.
`expectsAcceptanceOf.priceSpecification.priceType`	PriceTypeEnumeration atau Text	Wajib jika berlaku - Jenis harga yang diberikan dalam penawaran. Jika `actionAccessibilityRequirement.category` ditetapkan ke `purchase`, ini adalah properti wajib dan hanya dapat menerima 2 nilai: `https://schema.org/ListPrice` - Mewakili harga jual game. `https://schema.org/SalePrice` - Menampilkan harga promo (biasanya aktif untuk jangka waktu terbatas) game. `https://schema.org/ListPrice` dan `https://schema.org/SalePrice` wajib ada saat memberikan detail harga promo.
`expectsAcceptanceOf.seller`	Organisasi	Organisasi yang menawarkan pembelian konten.
`expectsAcceptanceOf.seller.@type`	Teks	Selalu ditetapkan ke `Organization`.
`expectsAcceptanceOf.seller.name`	Teks	Nama penjual.
`expectsAcceptanceOf.seller.sameAs`	URL	URL halaman web yang mengidentifikasi penjual; misalnya, halaman beranda penjual.

Untuk setiap jenis penghalang konten berbayar yang didukung, contoh di bawah memberikan insight tentang cara actionAccessibilityObject harus dibuat:

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

Gratis (tidak perlu login) dengan uji coba satu jam saja

{
  "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"
    }
  }
}

Pembelian satu kali dengan penjualan

{
  "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/"
        }
      }
    ]
  }
}

Pembelian satu kali

{
  "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/"
      }
    }
  }
}

Langganan satu paket/multi-paket/add-on

{
  "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"
    }
  }
}

Langganan dan add-on berjenjang

Berikut ini penjelasan tentang cara penerapan langganan berjenjang dan add-on:

Dalam model langganan satu tingkat, penyedia layanan memiliki satu tingkat langganan. Semua pelanggan dapat mengakses konten yang sama, terlepas dari paket langganan mereka.
Dalam model langganan bertingkat, penyedia layanan memiliki beberapa tingkat langganan, seperti Gold, Silver, dan Bronze. Pengguna yang memiliki langganan tingkat atas dapat mengakses semua konten tingkat bawah. Namun, pengguna yang memiliki langganan tingkat yang lebih rendah tidak dapat mengakses konten tingkat yang lebih tinggi.
Dalam model langganan add-on, penyedia layanan memungkinkan pengguna memperluas hak mereka dan menambahkan konten ke langganan dasar. Pengguna dapat menambahkan konten sebanyak yang mereka inginkan.

Template keseluruhan entitas

Berikut adalah contoh template keseluruhan entitas:

Template

{
  "@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": [
                 {  },
                 {  }
                 ]
              }
          ],
    ...
    }
  ]
}

Definisi jenis data terstruktur

Bagian ini memberikan detail untuk properti markup konten untuk jenis entity VideoGame. Anda harus menyertakan properti wajib yang tercantum di sini agar konten Anda memenuhi syarat untuk ditampilkan di hasil penelusuran. Sebaiknya Anda juga menyertakan properti yang sangat direkomendasikan untuk menambahkan informasi lain tentang konten Anda, yang dapat meningkatkan kualitas pengalaman pengguna dan membantu kami melakukan rekonsiliasi entitas dengan Pustaka Pengetahuan Google.

Tabel spesifikasi VideoGame (Kerja)

Properti	Jenis yang diharapkan	Deskripsi
`@context`	Teks	Wajib diisi. Selalu ditetapkan ke `["http://schema.org", {"@language": "xx"}]`. Nilai Where `xx` merepresentasikan bahasa string dalam feed. Setiap konteks entitas root harus memiliki `@language` yang ditetapkan ke kode bahasa yang sesuai dalam format BCP 47. Misalnya, jika bahasa disetel ke bahasa Spanyol, nama diasumsikan dalam bahasa Spanyol, meskipun bahasa subtitle/sulih suara dalam bahasa Inggris.
`@type`	Teks	Wajib diisi. Selalu ditetapkan ke `VideoGame`.
`@id`	URL	Wajib diisi. ID konten dalam format URI; misalnya, `https://example.com/1234abc. @id` harus memenuhi persyaratan berikut: Unik secara global di seluruh katalog Anda. Statis. ID harus stabil dan tidak berubah dari waktu ke waktu, meskipun properti `url` game berubah. ID ini diperlakukan sebagai string buram dan tidak harus berupa link yang berfungsi. Dalam bentuk Unified Resource Identifier (URI). Domain yang digunakan untuk nilai @id harus dimiliki oleh organisasi Anda. Karena `url` entity memenuhi semua persyaratan ID, sebaiknya gunakan `url` entity sebagai `@id`-nya. Untuk mengetahui detail selengkapnya, lihat bagian ID.
`url`	URL	Wajib diisi. URL kanonis konten, yang digunakan Google untuk mencocokkan konten di feed Anda dengan konten di database Google. `url` harus memenuhi persyaratan berikut: `url` harus unik secara global. `url` harus berisi URL kanonis yang berfungsi dan dapat di-crawl oleh Google. Untuk deep link pemutaran, lihat properti `urlTemplate` objek target.
`name`	Teks	Nama game. Gunakan array untuk mencantumkan nama dalam berbagai bahasa. Untuk mengetahui detail selengkapnya, lihat contoh Beberapa region dan bahasa. Perhatikan bahwa hanya satu nama yang didukung per lokalitas (pasangan bahasa-negara).
`description`	Teks	Sangat direkomendasikan. Sinopsis game. Batas 300 karakter. Gunakan array untuk menandai deskripsi dalam beberapa bahasa. Untuk mengetahui detail selengkapnya, lihat contoh Beberapa wilayah dan bahasa.
`genre`	Teks	Daftar berurutan semua genre yang relevan. Contoh: `["Action", "Role playing"]`
`image`	ImageObject	Sangat direkomendasikan. Gambar yang terkait dengan game. Untuk mengetahui detail selengkapnya tentang properti wajib dan opsional yang disertakan dengan `image`, lihat Properti gambar.
`applicationCategory`	Teks	Opsional. Jenis aplikasi software. Tetapkan nilai ke `Game`.
`exampleOfWork`	VideoGame	Wajib Edisi `VideoGame`. Entitas `VideoGame` (Edisi) ini juga membawa detail deep link. Untuk mengetahui detail selengkapnya, lihat tabel spesifikasi VideoGame (Edisi).
`playMode`	Text atau GamePlayMode	Opsional. Menunjukkan apakah game ini adalah game multiplayer, co-op, atau single-player. Game dapat ditandai sebagai multiplayer, co-op, dan single player secara bersamaan. Menerima nilai berikut: `SINGLE_PLAYER` `LOCAL_MULTI_PLAYER` `ONLINE_MULTI_PLAYER` `LOCAL_COOP` `ONLINE_COOP`

Tabel spesifikasi VideoGame (Edisi)

Properti	Jenis yang diharapkan	Deskripsi
`@type`	Teks	Wajib diisi. Selalu ditetapkan ke `VideoGame`.
`@id`	URL	Wajib diisi. ID konten dalam format URI; misalnya, `https://example.com/1234abc.@id` harus memenuhi persyaratan berikut: Unik secara global di seluruh katalog Anda. Statis. ID harus stabil dan tidak berubah dari waktu ke waktu, meskipun properti `url` game berubah. ID ini diperlakukan sebagai string buram dan tidak harus berupa link yang berfungsi. Dalam bentuk Unified Resource Identifier (URI). Domain yang digunakan untuk nilai @id harus dimiliki oleh organisasi Anda. Karena `url` entity memenuhi semua persyaratan ID, sebaiknya gunakan `url` entity sebagai `@id`-nya. Untuk mengetahui detail selengkapnya, lihat bagian ID.
`url`	URL	Wajib diisi. URL kanonis konten, yang digunakan Google untuk mencocokkan konten di feed Anda dengan konten di database Google. `url` harus memenuhi persyaratan berikut: `url` harus unik secara global. `url` harus berisi URL kanonis yang berfungsi dan dapat di-crawl oleh Google. Untuk deep link pemutaran, lihat properti `urlTemplate` objek target.
`name`	Teks	Nama game. Gunakan array untuk mencantumkan nama dalam berbagai bahasa. Untuk mengetahui detail selengkapnya, lihat contoh Beberapa region dan bahasa. Perhatikan bahwa hanya satu nama yang didukung per lokalitas (pasangan bahasa-negara).
`description`	Teks	Sangat direkomendasikan. Sinopsis game. Batas 300 karakter. Gunakan array untuk menandai deskripsi dalam beberapa bahasa. Untuk mengetahui detail selengkapnya, lihat contoh Beberapa wilayah dan bahasa.
`genre`	Teks	Daftar berurutan semua genre yang relevan. Contoh: `["Action", "Role playing"]`
`image`	ImageObject	Sangat direkomendasikan. Gambar yang terkait dengan game. Untuk mengetahui detail selengkapnya tentang properti wajib dan opsional yang disertakan dengan `image`, lihat Properti gambar.
`applicationCategory`	Teks	Opsional. Jenis aplikasi software. Tetapkan nilai ke `Game`.
`playMode`	Text atau GamePlayMode	Opsional. Menunjukkan apakah game ini adalah game multiplayer, co-op, atau single-player. Game dapat ditandai sebagai multiplayer, co-op, dan single player secara bersamaan. Menerima nilai berikut: `SINGLE_PLAYER` `LOCAL_MULTI_PLAYER` `ONLINE_MULTI_PLAYER` `LOCAL_COOP` `ONLINE_COOP`
`potentialAction`	PlayGameAction	Wajib jika berlaku. Objek markup Tindakan yang memberikan detail tindakan. Gunakan array untuk menentukan deep link yang berbeda di beberapa wilayah. Untuk mengetahui informasi selengkapnya, lihat contoh Beberapa region dan bahasa.
`gameEdition`	Teks	Wajib diisi. Edisi game ini. Sebagai contoh, game populer "Shadow of the Tomb Raider" ditawarkan dalam empat edisi: "Croft Edition", "Standard Edition", "Digital Deluxe Edition", dan "Ultimate Edition".
`gamePlatform`	Teks	Wajib diisi. Platform atau sistem elektronik yang digunakan untuk bermain video game.
`releasedEvent`	PublicationEvent	Sangat direkomendasikan. `PublicationEvent` digunakan untuk menentukan rilis asli (global atau lokal) konten oleh penayang.
`releasedEvent.@type`	Teks	Wajib diisi. Pastikan untuk selalu menyetel properti ini ke `PublicationEvent`.
`releasedEvent.Location`	Negara	Wajib diisi. Wilayah yang terkait dengan acara peluncuran ini. Gunakan kode ISO 3166 untuk negara. Untuk menunjukkan semua tempat di dunia, tetapkan ke `EARTH`.
`releasedEvent.startDate`	Tanggal atau Waktu	Direkomendasikan. Diperlukan untuk `ExclusiveEvent`. Tanggal mulai publikasi entitas.
`releasedEvent.endDate`	Tanggal atau Waktu	Opsional. Kolom ini menunjukkan tanggal saat hak atas konten berakhir.
`releasedEvent.publishedBy`	Organization atau Person	Opsional. Organisasi atau orang yang memublikasikan entitas ini.
`contentRating`	Teks	Wajib untuk game dewasa, sangat direkomendasikan untuk game lainnya. Rating konten keseluruhan. Jika rating konten diberikan dalam bentuk string teks, dua variasi akan diterima: Lembaga pemeringkat ditambahkan ke rating dengan spasi di antaranya. Misalnya, rating "Dewasa" dari lembaga "Entertainment Software Rating Board" di Amerika Serikat harus dideskripsikan sebagai `Entertainment Software Rating Board Mature`. Nilai `RATING NOT KNOWN` (tidak peka huruf besar/kecil) untuk menunjukkan bahwa Anda tidak mengetahui rating game.
`publisher`	Organization atau Person	Opsional. Organisasi atau orang yang memublikasikan entitas ini.
`contributor`	Organization atau Person	Opsional. Kontributor sekunder untuk entitas ini.

Tabel spesifikasi gambar

Tindakan Game Play menggunakan kembali skema Tindakan Media untuk merekam persyaratan gambar. Untuk mengetahui informasi selengkapnya, lihat spesifikasi skema gambar.

Berikut beberapa persyaratan lain yang perlu diperhatikan.

Rasio aspek dan `contentAttributes`	Resolusi minimum (dalam piksel)
16:9, poster ikonik	3840x2160
2:3, poster ikonik	1000x1500
4:3, poster ikonik	800x600
1:1, poster ikonis	600x600
3:4, poster ikonik	600x800
16:9, latar belakang ikonik [lebih disukai] atau sceneStill	3840x2160
2:3, latar belakang ikonik [lebih disukai] atau sceneStill	1000x1500
3:4, latar belakang ikonik [lebih disukai] atau sceneStill	600x800

Persyaratan format

Berikut persyaratan format yang harus Anda patuhi untuk ukuran, kualitas, dan sebagainya:

Sertakan poster dan sceneStills beresolusi tertinggi yang Anda miliki untuk game tersebut.
Gambar harus dalam format JPG, PNG, atau WebP.
URL gambar harus dapat di-crawl dan diindeks.
Ukuran file tidak boleh melebihi 20 MB.
Kami lebih memilih gambar yang berfungsi baik untuk smallFormat maupun largeFormat.
Gambar tidak boleh berisi hal berikut:
- Gambar buram, pecah, diputar, atau berkualitas buruk.
- Fotografi stok atau tidak berlisensi.
- Ketelanjangan.
- Konten ilegal.
Anda dapat menyertakan ukuran gambar selain yang tercantum dalam tabel sebelumnya.

Contoh

Bagian berikut berisi contoh feed sampel untuk berbagai skenario.

Contoh feed dengan satu entity VideoGame

Berikut adalah contoh entity VideoGame yang merepresentasikan game “Space Wars Made Up Game”. Perlu diingat bahwa entity ini harus disertakan dalam amplop Feed data di file JSON agar dapat dilihat oleh Google.

{
   "@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"
               }
            ]
         }
      }
   ]
}

Menampilkan contoh gambar dengan dua karakter game

Ilustrasi seorang perempuan dan burung di ladang.

{
  "@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"]
      }
    ]
  }
}

Menangani beberapa wilayah dan bahasa (Internasionalisasi)

Entitas VideoGame dapat tersedia di beberapa wilayah dan bahasa.

Catatan: @language menunjukkan bahasa yang digunakan untuk @value; ini tidak berarti ketersediaan konten dalam bahasa tersebut atau di wilayah tersebut. Misalnya, pt-br dalam @language tidak berarti bahwa konten tersedia dalam bahasa Portugis di Brasil; atribut ini mengidentifikasi bahasa yang digunakan dalam @value adalah Portugis-Brasil. Gunakan eligibleRegion untuk menentukan tempat konten tersedia.

{
  "@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...
}

Tindakan Play Game

Ringkasan

Pengantar Tindakan Game Play

Mulai

Sebelum memulai

Memahami penggunaan Karya dan Edisi dalam dokumentasi ini

URL Kanonis (url)

ID (@id)

Memahami dan mengidentifikasi persyaratan deep link

Jenis penghalang konten berbayar

Membuat feed

Mematuhi persyaratan ukuran, kuantitas, dan format file feed

Mematuhi persyaratan konten feed

Menghosting feed

Mengirimkan feed untuk ditinjau

Contoh

Cara kerja validasi feed

Kriteria penerimaan feed

Memperbarui feed jika perlu

Referensi

Ringkasan struktur feed

Envelope feed data

Template

Objek markup konten

Objek markup tindakan

Template

Target

Contoh

Spesifikasi akses tindakan

Contoh Target dengan dua deep link

Spesifikasi akses tindakan

Spesifikasi Langganan Media

Properti penawaran

Gratis (tidak perlu login)

Gratis (tidak perlu login) dengan uji coba satu jam saja

Gratis (perlu login)

Pembelian satu kali dengan penjualan

Pembelian satu kali

Langganan satu paket/multi-paket/add-on

Langganan dan add-on berjenjang

Template keseluruhan entitas

Template

Definisi jenis data terstruktur

Tabel spesifikasi VideoGame (Kerja)

Tabel spesifikasi VideoGame (Edisi)

Tabel spesifikasi gambar

Persyaratan format

Contoh

Contoh feed dengan satu entity VideoGame

Menampilkan contoh gambar dengan dua karakter game

Menangani beberapa wilayah dan bahasa (Internasionalisasi)