Tindakan Menonton properti umum

Bagian ini memberikan detail properti umum Watch Actions.

Properti markup tindakan

Properti Jenis yang diharapkan Deskripsi
@type Teks Wajib - Selalu ditetapkan ke WatchAction.
target EntryPoint Wajib - Objek target yang menyediakan pemetaan deep link ke berbagai platform Google.
target.@type Teks Wajib - Selalu ditetapkan ke EntryPoint.
target.urlTemplate URL Wajib - Deep link yang mengarahkan pengguna ke aplikasi atau platform Anda dan memulai pemutaran konten.
target.inLanguage Teks Opsional - Bahasa asli serial dalam format BCP 47.
target.actionPlatform Teks Wajib - Platform yang dipetakan ke urlTemplate. Media Actions mendukung hal berikut:
  • 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 dan PlayGuide di aplikasi Android.
  • http://schema.org/AndroidTVPlatform: Platform Android TV di aplikasi Android TV.
  • http://schema.org/IOSPlatform: Platform penelusuran di aplikasi iOS.
  • http://schema.googleapis.com/GoogleVideoCast: Platform Cast dan Home di perangkat Chromecast.
  • http://schema.googleapis.com/GoogleAudioCast: Platform Cast dan Home di perangkat Chromecast (khusus Tindakan Dengarkan).
Lihat bagian Jenis platform untuk mengetahui persyaratan.
target.additionalProperty PropertyValue Wajib jika berlaku - Daftar pasangan nilai properti untuk mewakili properti tambahan deep link. Hal ini dapat mencakup hal berikut:
  • contentLanguage: Bahasa siaran (dub), dalam format BCP 47. Jika konten disulih suara dalam bahasa lain, properti ini diperlukan. Gunakan array untuk beberapa kode bahasa.
  • subtitleLanguage: Bahasa subtitel atau teks, dalam format BCP 47. Gunakan array untuk beberapa kode bahasa.
  • cameraAngle: Sudut kamera untuk konten; misalnya, "Setinggi Mata" dan "Sudut Tinggi". Jika konten tersedia dalam sudut kamera yang berbeda, properti ini diperlukan. Gunakan array untuk beberapa sudut kamera.
  • videoFormat: Format file yang digunakan untuk menyimpan data video digital; misalnya, "SD" untuk standar-definisi dan "HD" untuk definisi tinggi. Format video yang valid mencakup SD, HD, 2K, 4K, dan 8K. Gunakan array untuk beberapa format video.
Lihat contoh additionalProperty.
actionAccessibilityRequirement ActionAccessSpecification Wajib - Objek spesifikasi akses Action yang menjelaskan persyaratan akses konten. Lihat Properti Spesifikasi Akses Action.

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 informasi selengkapnya, lihat Jenis paywall.

Jika entitas mewakili grup konten, Anda harus menetapkan category ke persyaratan akses yang paling tidak ketat untuk kontennya. Misalnya, jika TVSeries memiliki beberapa konten TVEpisode yang disetel ke nologinrequired dan beberapa yang disetel ke subscription, tetapkan TVSeries ini ke nologinrequired.
actionAccessibilityRequirement.availabilityStarts Date

Wajib - Tanggal batas tersedianya tindakan, dalam format ISO 8601 (termasuk zona waktu).

  • Tanggal dapat ditetapkan di masa mendatang.

Entitas yang sesuai harus diberikan dalam feed setidaknya 7 hari sebelum tanggal availabilityStarts-nya. Hal ini akan meningkatkan peluang konten muncul di platform Google tepat waktu.

actionAccessibilityRequirement.availabilityEnds Date Wajib - Tanggal batas tersedianya tindakan, dalam format ISO 8601 (termasuk zona waktu).
  • 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.

Pembaruan pada tanggal availabilityEnds harus dilakukan di feed setidaknya 7 hari sebelum tanggal availabilityEnds. Tindakan ini akan meningkatkan peluang konten berhenti muncul di platform Google pada tanggal availabilityEnds.

actionAccessibilityRequirement.eligibleRegion Country, City, State, GeoShape, atau Text Wajib - Wilayah tempat konten tersedia. Gunakan string khusus EARTH jika konten tersedia secara global.
actionAccessibilityRequirement.ineligibleRegion Country, City, State, atau GeoShape Wajib jika berlaku - Wilayah tempat konten dibatasi. Anda tidak perlu memberikan properti ini jika konten tersedia di mana saja dalam eligibleRegion.
actionAccessibilityRequirement.requiresSubscription MediaSubscription

Wajib jika berlaku - Detail langganan yang diperlukan 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 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 atau externalsubscription)
Jika harganya 0,00, hapus objek Offer sepenuhnya dan tetapkan category dari objek ActionAccessSpecification ke free. Lihat Properti penawaran.

Properti langganan media

Wajib 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 berikut:
  • Jika konten dapat diakses melalui 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 PKG1a, gunakan PKG1.
  • Untuk Penyedia TVE, ini adalah nama pengautentikasi yang terdaftar dengan pengautentikasi TVE Anda. Ini adalah string yang secara unik mengidentifikasi nama layanan Anda dengan Pengautentikasi TVE.
requiresSubscription.sameAs URL Halaman yang menjelaskan langganan.
requiresSubscription.identifier Teks Wajib jika category adalah subscription DAN commonTier adalah false - String unik untuk langganan ini yang mewakili akses ke grup 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:basic, example.com:premium, example.com:sports
  • Properti ini akan sama dengan ID hak jika Anda menyediakan API hak
requiresSubscription.authenticator Organisasi Wajib jika category adalah externalsubscription - Penampung yang memberikan detail pengautentikasi penyedia eksternal.
requiresSubscription.authenticator.@type Teks Wajib jika category adalah externalsubscription - Selalu tetapkan ke Organization.
requiresSubscription.authenticator.name Teks Wajib jika category adalah externalsubscription - Nama layanan autentikasi. Untuk penyedia TVE, tetapkan ke TVE
requiresSubscription.commonTier Boolean Wajib jika berlaku - Ini diperlukan jika kategori ditetapkan ke langganan. Baca selengkapnya tentang commonTier dalam dokumentasi persyaratan tingkat umum.

Persyaratan Entitlements API

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

  • Perusahaan A memiliki satu penawaran langganan yang memberi pengguna yang berlangganan akses ke semua konten yang tersedia: ID Hak / API tidak diperlukan
  • Perusahaan B memiliki langganan dasar yang memberikan akses ke beberapa konten dan langganan premium yang memberikan akses ke konten premium: ID Hak / API diperlukan
  • Perusahaan C memiliki langganan dasar yang memberikan akses ke beberapa konten dan paket add-on yang memberikan akses ke konten pihak ketiga: ID Hak / API diperlukan

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 yang bukan nol. Untuk entitas dengan harga 0,00, tentukan kategori sebagai `gratis`.
expectsAcceptanceOf.priceCurrency Teks Wajib - Mata uang harga dalam format ISO 4217 3 huruf.
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, halaman beranda penjual.

Halaman terkait penawaran

Lihat halaman berikut untuk topik yang terkait dengan properti ini:

Pengenal

Feed Action Media menerima berbagai ID yang dapat membantu mengidentifikasi entity dengan cara yang tidak ambigu. ID ini dapat membantu mempercepat proses rekonsiliasi konten di feed Anda dengan konten di database Google. Meskipun sebagian besar ID ini dapat ditambahkan ke feed menggunakan properti identifier pada berbagai jenis entity, EIDR memiliki properti representatifnya sendiri. Kedua hal ini dibahas di bawah.

Properti ID

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

Properti ini tersedia di semua jenis entity Watch Action.

Tabel di bawah mencantumkan ID dan sub-properti properti identifier yang diterima. Lihat Contoh ID/EIDR di bagian contoh feed Watch Action.
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).
    • . Hal ini tidak berlaku untuk entitas Organization dan 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 Japan VIPTimes (Nihon Tarento Meikan) untuk talenta Jepang.
  • DMA_ID: Kode area pemasaran yang ditetapkan Amerika Serikat, yang digunakan dalam objek GeoShape.
  • _PARTNER_ID_: Properti ini harus berisi string "_PARTNER_ID_", nilainya 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 (singkatan dari Entertainment Identifier Registry), adalah sistem ID unik global untuk berbagai konten media, termasuk film dan program televisi. Sistem identifikasi me-resolve ID ke data metadata yang terkait dengan judul, pengeditan, dan lainnya di tingkat teratas. Tabel berikut mencantumkan properti yang terkait dengan EIDR dan penggunaannya.

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

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

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

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

Properti ini tersedia di halaman spesifikasi entity TVEpisode dan Movie.

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

Properti titleEIDR diperlukan jika editEIDR diberikan.

Lihat Contoh ID/EIDR di bagian contoh feed Watch Actions.

Lembaga rating konten

Gunakan nilai dalam tabel ini untuk BroadcastService.contentRating, Movie.contentRating, dan TVSeries.contentRating. Lembaga pemeringkat harus ditambahkan di awal nilai rating. Contoh:

  • Film yang diberi rating "R" di Amerika Serikat harus memiliki nilai Movie.contentRating "MPAA R".
  • Serial TV yang diberi rating "TV-MA" di Amerika Serikat harus memiliki nilai TVSeries.contentRating "TV_PG TV-MA".

Negara Lembaga rating TV Lembaga 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) ACB TV ACB Movies
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) CLASSIND CLASSIND
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 - Kode negara ISO 3166-1 alpha-2 dua huruf.
postalCode Teks Opsional - Daftar satu atau beberapa kode pos dan/atau kode FSA (forward sortation area).
identifier PropertyValue Opsional - ID 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 (forward sortation area) 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"
    }
  ]
}