Tindakan Menonton properti umum

Bagian ini memberikan detail tentang properti umum Tindakan Menonton.

Properti markup tindakan

Properti Jenis yang diharapkan Deskripsi
@type Teks Wajib - Selalu ditetapkan ke WatchAction.
target EntryPoint Wajib - Objek target yang menyediakan pemetaan dalam link ke berbagai platform Google.
target.@type Teks Wajib - Selalu ditetapkan ke EntryPoint.
target.urlTemplate URL Wajib - A dalam yang mengarahkan pengguna ke aplikasi atau platform Anda dan memulai pemutaran konten.
target.inLanguage Teks Opsional - Bahasa asli dari serial dalam BCP 47 format font.
target.actionPlatform Teks Wajib - Platform yang dipetakan untuk urlTemplate. Tindakan Media mendukung hal berikut:
  • http://schema.org/DesktopWebPlatform: Platform penelusuran pada {i>browser<i} web desktop.
  • http://schema.org/MobileWebPlatform: Platform penelusuran aktif browser web seluler.
  • http://schema.org/AndroidPlatform: Penelusuran dan PlayGuide platform di aplikasi Android.
  • http://schema.org/AndroidTVPlatform: Android TV di aplikasi Android TV.
  • http://schema.org/IOSPlatform: Platform penelusuran di iOS .
  • http://schema.googleapis.com/GoogleVideoCast: Transmisi dan Platform layar utama di perangkat Chromecast.
  • http://schema.googleapis.com/GoogleAudioCast: Transmisi dan Platform Home di perangkat Chromecast (khusus Tindakan Dengarkan).
Lihat Platform jenis untuk persyaratan.
target.additionalProperty PropertyValue Wajib jika berlaku - Daftar pasangan nilai properti untuk merepresentasikan properti tambahan deep link. Media sintetis dapat mencakup berikut ini:
  • contentLanguage: Bahasa siaran (dub), di BCP 47 format. Jika konten disulih suara dalam bahasa lain, properti wajib diisi. Menggunakan array untuk beberapa kode bahasa.
  • subtitleLanguage: Bahasa subtitel atau teks, dalam BCP 47 format. Menggunakan array untuk beberapa kode bahasa.
  • cameraAngle: Sudut kamera untuk konten; untuk misalnya, "Tingkat Mata" dan "Sudut Tinggi". Jika konten tersedia di sudut kamera yang berbeda, properti ini diperlukan. Gunakan array untuk dari berbagai sudut kamera.
  • videoFormat: Format file yang digunakan untuk menyimpan file digital tanggal video; misalnya, "SD" untuk definisi standar dan "HD" untuk definisi tinggi. Format video yang valid mencakup SD, HD, 2K, 4K, dan 8K. Menggunakan array untuk beberapa format video.
Lihat additionalProperty contoh.
actionAccessibilityRequirement ActionAccessSpecification Wajib - Tindakan objek spesifikasi akses yang menjelaskan persyaratan akses konten tersebut. Lihat Tindakan Mengakses Properti Spesifikasi.

Lihat halaman berikut untuk topik yang terkait dengan properti ini:

Properti spesifikasi akses tindakan

Properti Jenis yang diharapkan Deskripsi
actionAccessibilityRequirement.@type Teks Wajib - Selalu ditetapkan ke ActionAccessSpecification.
actionAccessibilityRequirement.category Teks

Wajib - Persyaratan akses untuk konten. Untuk selengkapnya informasi, lihat Jenis penghalang konten berbayar.

Jika entitas mewakili grup konten, Anda harus mengatur category ke persyaratan akses yang paling tidak ketat dari kontennya. Misalnya, jika TVSeries memiliki beberapa Konten TVEpisode ditetapkan ke nologinrequired dan beberapa setelan yang disetel ke subscription, setel TVSeries ke nologinrequired.

actionAccessibilityRequirement.availabilityStarts Date

Wajib - Tanggal setelah tindakan tersedia, di ISO Format 8601 (termasuk zona waktu).

  • Tanggal dapat ditetapkan di masa mendatang.

Entitas yang sesuai harus disediakan dalam feed di setidaknya 7 hari sebelum tanggal mulai ketersediaan. Hal ini akan meningkatkan peluang konten muncul di platform Google tepat waktu.

actionAccessibilityRequirement.availabilityEnds Date Wajib - Tanggal setelah tindakan tidak lagi tersedia, dalam ISO Format 8601 (termasuk zona waktu).
  • Harus sama atau lebih besar dari 72 jam setelah availabilityStarts.
  • Jika konten selalu tersedia setelah dipublikasikan, setel ini tanggal 20 tahun dari tanggal saat ini.

Setiap pembaruan pada tanggal availabilityEnds harus dilakukan di feed minimal 7 hari sebelum tanggal availabilityEnds. Ini akan meningkatkan peluang berhentinya konten tersebut di Google muncul pada tanggal availabilityEnds.

actionAccessibilityRequirement.eligibleRegion Negara, Kota, Negara Bagian, GeoShape, atau Teks Wajib - Wilayah tempat konten tersedia. Gunakan string khusus EARTH jika konten tersedia secara global.
actionAccessibilityRequirement.ineligibleRegion Negara, Kota, Negara Bagian, atau GeoShape Wajib jika berlaku - Wilayah tempat konten berada dibatasi. Anda tidak perlu memberikan properti ini jika konten tersedia di mana saja di eligibleRegion.
actionAccessibilityRequirement.requiresSubscription MediaSubscription

Wajib jika berlaku - Detail langganan yang dibutuhkan pengguna untuk mengakses konten. Lihat Properti langganan media.

  • Berikan properti ini jika category adalah subscription atau externalSubscription.
actionAccessibilityRequirement.expectsAcceptanceOf Penawaran Wajib jika konten memerlukan pembelian - Detail 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 subscriber (subscription atau externalsubscription)
Jika harganya 0,00, hapus objek Offer sepenuhnya dan setel category dari objek ActionAccessSpecification ke free. Lihat Properti penawaran.

Properti langganan media

Wajib diisi jika actionAccessibilityRequirement.category adalah subscription atau externalSubscription.

Properti Jenis yang diharapkan Deskripsi
requiresSubscription.@type Teks Wajib - Selalu ditetapkan ke MediaSubscription
requiresSubscription.@id URL Wajib - ID unik untuk langganan. Jika konten dapat diakses melalui langganan yang berbeda, setiap langganan harus memiliki ID unik.
requiresSubscription.name Teks Wajib - Nama langganan. Perhatikan hal-hal berikut:
  • Jika konten dapat diakses melalui langganan yang berbeda, nama harus cocok dengan nama di sistem otentikasi pengguna Anda. Sebagai misalnya, jika pengguna dapat mengakses konten berdasarkan langganan yang disebut Paket 1, tetapi sistem autentikasi menggunakan nama tersebut PKG1a, gunakan PKG1.
  • Untuk Penyedia TVE, ini adalah nama pengautentikasi yang terdaftar di pada otentikator TVE Anda. String ini adalah string yang secara unik mengidentifikasi layanan Anda dengan TVE Authenticator.
requiresSubscription.sameAs URL Halaman yang mendeskripsikan langganan.
requiresSubscription.identifier Teks Wajib diisi jika category adalah subscription DAN commonTier adalah false - String unik untuk langganan ini yang merepresentasikan akses ke sekelompok konten di katalog media Anda.
  • Google merekomendasikan agar Anda menggunakan sintaksis berikut untuk ID:
    nama domain + titik dua (:) + tingkat akses ke konten, Contoh : example.com:dasar, example.com:premium, example.com:olahraga
  • Properti ini akan sama dengan ID hak jika Anda memberikan entitlement API
requiresSubscription.authenticator Organisasi Wajib diisi jika category adalah externalsubscription - Container yang menyediakan detail tentang otentikator penyedia eksternal.
requiresSubscription.authenticator.@type Teks Wajib diisi jika category adalah externalsubscription - Selalu tetapkan ke Organization.
requiresSubscription.authenticator.name Teks Wajib diisi jika category adalah externalsubscription - Nama autentikasi layanan. Untuk penyedia TVE, tetapkan ke TVE
requiresSubscription.commonTier Boolean Wajib jika berlaku - Ini wajib jika kategori ditetapkan ke langganan Anda. Baca lebih lanjut tentang commonTier di umum persyaratan tingkat tinggi.

Persyaratan Entitlement API

Etitlement API adalah diperlukan jika actionAccessibilityRequirement.category adalah subscription atau externalSubscription dan penawaran langganan Anda mencakup beberapa paket atau tingkatan atau memiliki dukungan add-on. Jangan sertakan ini jika langganan memiliki satu tingkat dan memberikan akses ke semua konten dalam katalog Anda.

  • Perusahaan A memiliki satu penawaran langganan yang memberikan pengguna yang berlangganan akses ke semua konten yang tersedia: Entitlement Identifier / API tidak wajib diisi
  • Perusahaan B memiliki langganan dasar yang memberikan akses ke beberapa konten dan langganan premium yang memberikan akses ke konten premium: ID Hak / API wajib diisi
  • Perusahaan C memiliki langganan dasar yang menyediakan akses ke beberapa konten dan paket {i>add-on<i} yang memberikan akses ke konten pihak ketiga: ID Hak / API wajib diisi

Lihat halaman berikut untuk topik yang terkait dengan properti ini:

Properti penawaran

Properti Jenis yang diharapkan Deskripsi
expectsAcceptanceOf.@type Teks Wajib - Selalu ditetapkan ke Offer.
expectsAcceptanceOf.price Number Wajib - Harga pembelian konten. Harga harus berupa nilai positif bukan nol. Untuk entitas dengan harga 0,00, tentukan kategori sebagai `gratis`.
expectsAcceptanceOf.priceCurrency Teks Wajib - Mata uang harga dalam 3 huruf ISO Format 4217.
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 Teks URL halaman web yang mengidentifikasi penjual; misalnya, beranda penjual.

Lihat halaman berikut untuk topik yang terkait dengan properti ini:

Pengenal

Feed Tindakan Media menerima berbagai ID yang dapat membantu mengidentifikasi entitas dengan cara yang tidak ambigu. Pengidentifikasi ini dapat membantu mempercepat proses merekonsiliasi konten di feed Anda dengan konten di {i>database<i}. Meskipun sebagian besar ID ini dapat ditambahkan ke feed menggunakan identifier di berbagai jenis entity, EIDR memiliki properti representatif. Keduanya akan dibahas di bawah ini.

Properti ID

Properti Jenis yang diharapkan Deskripsi
identifier Teks Sangat Direkomendasikan - ID, biasanya ID eksternal, yang secara jelas mengidentifikasi entitas tertentu. Beberapa ID diizinkan.

Properti ini tersedia di semua jenis entitas Tindakan Tonton.

Tabel di bawah ini mencantumkan ID dan sub-properti yang diterima dari properti identifier. Lihat Contoh ID/EIDR di bagian contoh feed Tindakan Menonton.
Properti Jenis yang diharapkan Deskripsi
@type Teks Wajib - Selalu ditetapkan ke PropertyValue.
propertyID Teks Wajib - Kami mendukung jenis ID berikut:
  • TMS_ROOT_ID: ID Root Gracenote (TMS) (misalnya, 15829).
  • kami. Ini tidak berlaku untuk Organisasi dan Entitas BroadcastService yang hanya boleh menggunakan TMS_ID.
  • TMS_ID: ID Varian Gracenote (TMS) (misalnya, MV000398520000).
  • WIKIDATA_ID: ID WikiData (misalnya, Q134773).
  • IMDB_ID: ID IMDB (misalnya, tt0109830).
  • OPTA_ID: ID Olahraga OPTA.
  • STATS_ID: ID Performa STATS.
  • VIP_TIMES_ID: ID VIPTimes Jepang (Nihon Tarento Meikan) untuk talenta Jepang.
  • DMA_ID: Designated marketing area code AS, yang digunakan dalam GeoShape.
  • _PARTNER_ID_: Properti ini harus berisi string "_PARTNER_ID_", nilai harus berupa ID unik yang digunakan oleh penyedia layanan, secara internal atau eksternal, untuk mengidentifikasi entitas (misalnya, 12345 atau a5c604e2-e9e5-4ff3-b728-245799dc37f1).
value Teks Wajib - Nilai untuk sistem ID yang ditentukan.

Properti EIDR

EIDR (kependekan dari The Entertainment Identifier Registry), adalah sistem pengenal unik global untuk berbagai konten media, termasuk gambar bergerak dan program televisi. Sistem identifikasi menyelesaikan ID ke catatan metadata yang dikaitkan dengan judul tingkat atas, hasil edit, dan lainnya. Tabel berikut mencantumkan properti yang terkait dengan EIDR dan penggunaannya.

Properti Jenis yang diharapkan Deskripsi
titleEIDR Teks Sangat Disarankan - ID EIDR (Entertainment Identifier Registry) menunjukkan, pada tingkat yang paling umum/abstrak, karya film atau televisi.

Properti ini tersedia di halaman spesifikasi entitas TVSeries, TVSeason, TVEpisode, dan Film.

Misalnya, judulEIDR untuk film yang dikenal sebagai "Ghostbuster" adalah "10.5240/7EC7-228A-510A-053E-CBB8-J".

Lihat Contoh ID/EIDR di bagian contoh feed Tindakan Menonton.
editEIDR Teks Sangat Direkomendasikan - ID EIDR (Entertainment Identifier Registry) menunjukkan pengeditan/edisi tertentu untuk sebuah karya film atau televisi.

Properti ini tersedia di halaman spesifikasi entitas TVEpisode dan Film.

Misalnya, film yang dikenal sebagai "Ghostbuster" yang titleEIDR adalah "10.5240/7EC7-228A-510A-053E-CBB8-J", memiliki beberapa pengeditan mis. &quot;10.5240/1F2A-E1C5-680A-14C6-E76B-I&quot; dan "10.5240/8A35-3BEE-6497-5D12-9E4F-3".

Properti titleEIDR wajib jika editEIDR diberikan.

Lihat Contoh ID/EIDR di bagian contoh feed Tindakan Tonton.

Agensi rating konten

Gunakan nilai dalam tabel ini untuk BroadcastService.contentRating, Movie.contentRating, dan TVSeries.contentRating. Perusahaan rating harus diawali dengan nilai rating. Contoh:

  • Film dengan rating "R" di US harus memiliki nilai Movie.contentRating "MPAA R".
  • Serial TV dengan rating "TV-MA" di AS harus memiliki nilai TVSeries.contentRating "TVPG TV-MA".

Negara Lembaga rating TV Agensi rating film
Albania (AL) Tidak tersedia Tidak tersedia
Angola (AO) Tidak tersedia CCE
Antigua dan Barbuda (AG) Tidak tersedia MPAA
Argentina (AR) INCAA INCAA
Armenia (AM) Tidak tersedia MKRF/RUSSIA
Aruba (AW) Tidak tersedia Tidak tersedia
Australia (AU) TV ACB ACB Film
Austria (AT) FSK FSK
Azerbaijan (AZ) Tidak tersedia MKRF/RUSSIA
Bahrain (BH) Tidak tersedia MPAA
Belarus (BY) Tidak tersedia MKRF/RUSSIA
Belgia (BE) Tidak tersedia MPAA
Belize (BZ) Tidak tersedia Tidak tersedia
Benin (BJ) Tidak tersedia CNC
Bolivia (BO) Tidak tersedia MPAA
Bosnia dan Herzegovina (BA) Tidak tersedia MPAA
Botswana (BW) Tidak tersedia MPAA
Brasil (BR) KELAS KELAS
Burkina Faso (BF) Tidak tersedia CNC
Kamboja (KH) Tidak tersedia Tidak tersedia
Kanada (CA) CA_TV CHVRS
Tanjung Verde (CV) Tidak tersedia CCE
Cile (CL) Tidak tersedia MPAA
Kolombia (CO) Tidak tersedia MPAA
Kosta Rika (CR) Tidak tersedia MPAA
Kroasia (HR) Tidak tersedia Tidak tersedia
Siprus (CY) Tidak tersedia GRFILM
Republik Ceko (CZ) Tidak tersedia CZFILM
Denmark (DK) Tidak tersedia MCCYP
Ekuador (EC) Tidak tersedia MPAA
Mesir (EG) Tidak tersedia MPAA
El Salvador (SV) Tidak tersedia MPAA
Estonia (EE) Tidak tersedia EEFILM
Fiji (FJ) Tidak tersedia Tidak tersedia
Finlandia (FI) Tidak tersedia MEKU
Prancis (FR) CSA CSA
Gabon (GA) Tidak tersedia CNC
Jerman (DE) FSK FSK
Yunani (GR) ESR GRFILM
Guatemala (GT) Tidak tersedia MPAA
Haiti (HT) Tidak tersedia Tidak tersedia
Honduras (HN) Tidak tersedia MPAA
Hong Kong (HK) CA FCO
Hungaria (HU) Tidak tersedia MPAA
Islandia (IS) Tidak tersedia KIJKWIJZER
India (IN) CBFC CBFC
Indonesia (ID) KPI LSF
Irlandia (IE) Tidak tersedia IFCO
Italia (TI) AGCOM AGCOM
Côte d'Ivoire (CI) Tidak tersedia CNC
Jamaika (JM) Tidak tersedia MPAA
Jepang (JP) NA EIRIN
Yordania (JO) Tidak tersedia MPAA
Kazakhstan (KZ) Tidak tersedia MRKF
Korea (KR) KMRB KMRB
Kuwait (KW) Tidak tersedia MPAA
Kirgizstan (KG) Tidak tersedia MKRF/RUSSIA
Laos (LA) Tidak tersedia Tidak tersedia
Latvia (LV) Tidak tersedia NKCLV
Lebanon (LB) Tidak tersedia MPAA
Lituania (LT) Tidak tersedia Tidak tersedia
Luksemburg (LU) Tidak tersedia KIJKWIJZER
Makedonia (MK) Tidak tersedia MPAA
Malaysia (MY) Tidak tersedia FCBM
Mali (ML) Tidak tersedia CNC
Malta (MT) Tidak tersedia MCCAA
Mauritius (MU) Tidak tersedia BBFC
Meksiko (MX) RTC RTC
Moldova (MD) Tidak tersedia Tidak tersedia
Namibia (NA) Tidak tersedia Tidak tersedia
Nepal (NP) Tidak tersedia MPAA
Belanda (NL) KIJKWIJZER KIJKWIJZER
Selandia Baru (NZ) BSA OFLC
Nikaragua (NI) Tidak tersedia MPAA
Niger (NE) Tidak tersedia CNC
Norwegia (NO) Tidak tersedia MEDIETILSYNET
Oman (OM) Tidak tersedia MPAA
Panama (PA) Tidak tersedia MPAA
Papua Nugini (PG) Tidak tersedia MPAA
Paraguay (PY) Tidak tersedia MPAA
Peru (PE) Tidak tersedia MPAA
Filipina (PH) MTRCB MTRCB
Polandia (PL) Tidak tersedia MPAA
Portugal (PT) Tidak tersedia CCE
Qatar (QA) Tidak tersedia MPAA
Rusia (RU) MKRF/RUSSIA MKRF/RUSSIA
Rwanda (RW) Tidak tersedia CNC
Arab Saudi (SA) Tidak tersedia MPAA
Senegal (SN) Tidak tersedia MPAA
Singapura (SG) Tidak tersedia MDA
Slovakia (SK) Tidak tersedia MPAA
Slovenia (SI) Tidak tersedia MPAA
Afrika Selatan (ZA) FPB FPB
Spanyol (ES) SETSI ICAA
Sri Lanka (LK) Tidak tersedia Tidak tersedia
Swedia (SE) Tidak tersedia SMSA
Swiss (CH) FSK FSK
Taiwan (TW) Tidak tersedia MOCTW
Tajikistan (TJ) Tidak tersedia MKRF/RUSSIA
Tanzania (TZ) Tidak tersedia MPAA
Thailand (TH) Tidak tersedia BFVC
Togo (TG) Tidak tersedia CNC
Trinidad dan Tobago (TT) Tidak tersedia Tidak tersedia
Turki (TR) RTÜK ECBMCT
Turkmenistan (TM) Tidak tersedia MKRF/RUSSIA
Uganda (UG) Tidak tersedia MPAA
Ukraina (UA) Tidak tersedia Tidak tersedia
Uni Emirat Arab (AE) Tidak tersedia MPAA
Inggris Raya (GB) BBFC BBFC
Amerika Serikat (AS) TV_PG MPAA
Uruguay (UY) Tidak tersedia MPAA
Uzbekistan (UZ) Tidak tersedia MKRF/RUSSIA
Venezuela (VE) Tidak tersedia RESORTEVIOLENCIA
Vietnam (VN) Tidak tersedia MCST
Zambia (ZM) Tidak tersedia MPAA
Zimbabwe (ZW) Tidak tersedia MPAA

Properti GeoShape

Objek GeoShape berisi salah satu jenis data berikut:

Properti Jenis yang diharapkan Deskripsi
@id URL Wajib - ID wilayah geografis dalam format URI.
@type Teks Wajib - Selalu ditetapkan ke GeoShape.
addressCountry Teks Wajib - Dua huruf ISO Kode negara 3166-1 alpha-2.
postalCode Teks Opsional - Daftar satu atau beberapa kode pos dan/atau kode FSA (area pengurutan maju).
identifier PropertyValue Opsional - A Designated Market Area (DMA), yang merupakan ID wilayah di Amerika Serikat tempat orang menerima saluran dan program televisi yang sama.
identifier.@type Teks Wajib - Selalu ditetapkan ke PropertyValue.
identifier.propertyID Teks Wajib - Selalu ditetapkan ke DMA_ID.
identifier.value Teks Wajib - Kode DMA untuk wilayah.

Contoh objek GeoShape yang berisi daftar kode pos:

{
  "@type": "GeoShape",
  "@id": "http://example.com/area1",
  "addressCountry": "US",
  "postalCode": [
    "94118",
    "94119"
  ]
}

Contoh objek GeoShape yang berisi kombinasi FSA (area pengurutan maju) dan kode pos:

{
  "@type": "GeoShape",
  "@id": "http://example.com/area2",
  "addressCountry": "CA",
  "postalCode": [
    "1A1",
    "K1A",
    "K1AOB1"
  ]
}

Contoh objek GeoShape yang berisi ID DMA:

{
  "@type": "GeoShape",
  "@id": "http://example.com/area3",
  "addressCountry": "US",
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "DMA_ID",
      "value": "501"
    }
  ]
}