Halaman ini diterjemahkan oleh Cloud Translation API.

Tonton Tindakan' properti umum

Bagian ini memberikan detail tentang properti umum Tindakan Tonton.

Properti markup tindakan

Properti	Jenis yang diharapkan	Deskripsi
`@type`	Teks	Wajib - Selalu tetapkan ke `WatchAction`.
`target`	Titik Entri	Wajib - Objek target yang menyediakan pemetaan deep link ke berbagai platform Google.
`target.@type`	Teks	Wajib - Selalu tetapkan 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 seri dalam format BCP 47.
`target.actionPlatform`	Teks	Wajib - Platform yang dipetakan ke `urlTemplate`. Tindakan Media mendukung hal-hal berikut: `http://schema.org/DesktopWebPlatform`: Platform penelusuran di browser web desktop. `http://schema.org/MobileWebPlatform`: Platform penelusuran pada 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 Dengarkan Tindakan). 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 (sulih suara), dalam format BCP 47. Jika konten disulihsuarakan dalam bahasa lain, properti ini wajib diisi. Menggunakan array untuk beberapa kode bahasa. `subtitleLanguage`: Bahasa subtitel atau teks, dalam format BCP 47. Menggunakan array untuk beberapa kode bahasa. `cameraAngle`: Sudut kamera untuk konten; misalnya, "Level Mata" dan "Sudut Tinggi". Jika konten tersedia di berbagai sudut kamera, properti ini bersifat wajib. Menggunakan array untuk beberapa sudut kamera. `videoFormat`: Format file yang digunakan untuk menyimpan tanggal video digital; misalnya, "SD" untuk definisi standar dan "HD" untuk definisi tinggi. Format video yang valid termasuk SD, HD, 2K, 4K, dan 8K. Menggunakan array untuk beberapa format video. Lihat contoh additionalProperty.
`actionAccessibilityRequirement`	Spesifikasi ActionAccess	Wajib - Objek spesifikasi akses tindakan yang menjelaskan persyaratan akses konten. Lihat Properti Spesifikasi Akses Tindakan.

Halaman terkait markup tindakan

Lihat halaman berikut untuk topik yang terkait dengan properti ini:

Properti spesifikasi akses tindakan

Properti	Jenis yang diharapkan	Deskripsi
`actionAccessibilityRequirement.@type`	Teks	Wajib - Selalu tetapkan ke `ActionAccessSpecification`.
`actionAccessibilityRequirement.category`	Teks	Wajib - Persyaratan akses untuk konten. Untuk informasi selengkapnya, lihat Jenis penghalang konten berbayar. Jika suatu entity mewakili sekelompok konten, Anda harus menetapkan `category` ke persyaratan akses yang paling ketat dari kontennya. Misalnya, jika `TVSeries` memiliki beberapa konten `TVEpisode` yang disetel ke `nologinrequired` dan beberapa konten yang disetel ke `subscription`, setel `TVSeries` ini ke `nologinrequired`.
`actionAccessibilityRequirement.availabilityStarts`	Tanggal	Wajib - Tanggal tersedianya tindakan, dalam format ISO 8601 (termasuk zona waktu). Tanggal dapat ditetapkan di masa mendatang. Entitas yang sesuai harus disediakan di feed setidaknya 7 hari sebelum tanggal availabilityStarts-nya. Tindakan ini akan meningkatkan peluang konten muncul di platform Google secara tepat waktu.
`actionAccessibilityRequirement.availabilityEnds`	Tanggal	Wajib - Tanggal batas waktu tindakan tidak tersedia, dalam format ISO 8601 (termasuk zona waktu). Harus sama atau lebih besar dari 72 jam setelah `availabilityStarts`. Jika konten selalu tersedia setelah dipublikasikan, tetapkan tanggal ini ke 20 tahun dari tanggal saat ini. Setiap update pada tanggal availabilityEnds harus dibuat di feed minimal 7 hari sebelum tanggal availabilityEnds. Hal ini akan meningkatkan peluang munculnya konten yang berhenti muncul di platform Google 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 dibatasi. Anda tidak perlu memberikan properti ini jika konten tersedia di mana saja dalam `eligibleRegion`.
`actionAccessibilityRequirement.requiresSubscription`	Langganan Media	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 tetapkan 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 diisi - Nama langganan. Perhatikan hal berikut: Jika konten dapat diakses melalui langganan yang berbeda, nama ini harus cocok dengan nama dalam 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. String ini adalah string yang secara unik mengidentifikasi nama layanan Anda dengan Authenticator 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 sekelompok konten dalam 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 Anda jika Anda menyediakan API hak
`requiresSubscription.authenticator`	Organisasi	Wajib jika `category` adalah `externalsubscription` - Container yang menyediakan 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, setel ke TVE
`requiresSubscription.commonTier`	Boolean	Wajib jika berlaku - Wajib diisi jika kategori ditetapkan ke langganan. Baca lebih lanjut commonTier dalam dokumentasi persyaratan tingkat umum.

Persyaratan API Hak

API hak diperlukan jika actionAccessibilityRequirement.category adalah subscription atau externalSubscription dan penawaran langganan Anda mencakup beberapa paket atau tingkat atau memiliki dukungan add-on. Jangan sertakan ini jika langganan Anda 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 wajib
Perusahaan B memiliki langganan dasar yang menyediakan akses ke beberapa konten dan langganan premium yang menyediakan akses ke konten premium: ID Hak/API diperlukan
Perusahaan C memiliki langganan dasar yang menyediakan akses ke beberapa konten dan paket tambahan yang menyediakan akses ke konten pihak ketiga: ID Hak / API diperlukan

Halaman terkait langganan media

Lihat halaman berikut untuk topik yang terkait dengan properti ini:

Properti penawaran

Properti	Jenis yang diharapkan	Deskripsi
`expectsAcceptanceOf.@type`	Teks	Wajib - Selalu tetapkan ke `Offer`.
`expectsAcceptanceOf.price`	Number	Wajib diisi - 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 format ISO 4217 3 huruf.
`expectsAcceptanceOf.seller`	Organisasi	Organisasi yang menawarkan pembelian konten.
`expectsAcceptanceOf.seller.@type`	Teks	Selalu tetapkan 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 (ID)

Feed Media Action menerima berbagai ID yang dapat membantu mengidentifikasi entitas 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. Keduanya dibahas di bawah ini.

Properti ID

Properti	Jenis yang diharapkan	Deskripsi
`identifier`	Teks	Sangat Direkomendasikan - ID yang biasanya merupakan ID eksternal, yang secara jelas mengidentifikasi entitas tertentu. Beberapa ID diizinkan. Properti ini tersedia di semua jenis entitas Tindakan Tonton. Tabel di bawah mencantumkan ID dan sub-properti yang diterima dari properti `identifier`. Lihat Contoh ID/EIDR di bagian contoh feed Tindakan Tonton.

Properti	Jenis yang diharapkan	Deskripsi
`@type`	Teks	Wajib - Selalu tetapkan ke `PropertyValue`.
`propertyID`	Teks	Wajib - Kami mendukung jenis ID berikut: `TMS_ROOT_ID`: ID Rootnote (TMS) (misalnya, 15829). . 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`: Kode area pemasaran khusus AS, yang digunakan di objek GeoShape. `_PARTNER_ID_`: Properti ini harus berisi string "_PARTNER_ID_", nilainya harus berupa ID unik yang digunakan oleh penyedia layanan, baik secara internal maupun 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 The Entertainment Identifier Registry) adalah sistem ID unik secara global untuk berbagai konten media, termasuk film, dan program televisi. Sistem identifikasi menyelesaikan ID ke data metadata yang terkait dengan judul level teratas, hasil edit, dan lainnya. Tabel berikut mencantumkan properti yang terkait dengan EIDR dan penggunaannya.

Properti	Jenis yang diharapkan	Deskripsi
`titleEIDR`	Teks	Sangat Direkomendasikan - ID EIDR (Hiburan Identifier Registry) mewakili, pada tingkat yang paling umum/abstrak, karya film atau televisi. Properti ini tersedia pada halaman spesifikasi entitas TVSeries, TVSeason, TVEpisode, dan Film. Misalnya, titleEIDR untuk film yang dikenal sebagai "Ghostbusters" adalah "10.5240/7EC7-228A-510A-053E-CBB8-J". Lihat contoh feed ID/EIDR{/1
`editEIDR`	Teks	Sangat Direkomendasikan - ID EIDR (Hiburan Identifier Registry) mewakili pengeditan/edisi tertentu untuk karya film atau televisi. Properti ini berkaitan dengan kemampuan untuk melihat video.

Agensi rating konten

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

Film dengan rating "R" di Amerika Serikat harus memiliki nilai Movie.contentRating "MPAA R".
Serial TV dengan rating "TV-MA" di Amerika Serikat 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)	AAIN	AAIN
Armenia (AM)	Tidak tersedia	MKRF/RUSIA
Aruba (AW)	Tidak tersedia	Tidak tersedia
Australia (AU)	TV ACB	Film ACB
Austria (AT)	FSK	FSK
Azerbaijan (AZ)	Tidak tersedia	MKRF/RUSIA
Bahrain (BH)	Tidak tersedia	MPAA
Belarus (BY)	Tidak tersedia	MKRF/RUSIA
Belgia (BE)	Tidak tersedia	MPAA
Belize (BZ)	Tidak tersedia	Tidak tersedia
Benin	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)	TV_CA	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)	Spanyol	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 (IT)	AGCOM	AGCOM
Côte d’Ivoire (CI)	Tidak tersedia	CNC
Jamaika (JM)	Tidak tersedia	MPAA
Jepang (JP)	TA	IRIN
Yordania (JO)	Tidak tersedia	MPAA
Kazakhstan (KZ)	Tidak tersedia	MRKF
Korea (KR)	KMRB	KMRB
Kuwait (KW)	Tidak tersedia	MPAA
Kirgizstan (KG)	Tidak tersedia	MKRF/RUSIA
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 (Amerika Utara)	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	MEDIETILSIYNET
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/RUSIA	MKRF/RUSIA
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]	FPB [FPB]
Spanyol (ES)	SETSI	ICAA
Sri Lanka (LK)	Tidak tersedia	Tidak tersedia
Swedia (SE)	Tidak tersedia	SMS
Swiss (CH)	FSK	FSK
Taiwan (TW)	Tidak tersedia	MOCTW
Tajikistan (TJ)	Tidak tersedia	MKRF/RUSIA
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/RUSIA
Uganda (UG)	Tidak tersedia	MPAA
Ukraina (UA)	Tidak tersedia	Tidak tersedia
Uni Emirat Arab (AE)	Tidak tersedia	MPAA
Inggris (GB)	BBFC	BBFC
Amerika Serikat (AS)	TV_PG	MPAA
Uruguay (UY)	Tidak tersedia	MPAA
Uzbekistan (UZ)	Tidak tersedia	MKRF/RUSIA
Venezuela (VE)	Tidak tersedia	URUTKAN ULANG
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:

Daftar kode pos (misalnya, AS, Kanada, atau kode pos lainnya)
Daftar area pengurutan penerusan Kanada
Designated Market Area (DMA) ID - ID wilayah di Amerika Serikat tempat orang menerima saluran dan program televisi yang sama.

Properti	Jenis yang diharapkan	Deskripsi
`@id`	URL	Wajib - ID wilayah geografis dalam format URI.
`@type`	Teks	Wajib - Selalu tetapkan ke `GeoShape`.
`addressCountry`	Teks	Wajib - Dua huruf kode negara ISO 3166-1 alpha-2.
`postalCode`	Teks	Opsional - Daftar satu atau beberapa kode pos dan/atau kode FSA (area pengurutan).
`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 tetapkan ke `PropertyValue`.
`identifier.propertyID`	Teks	Wajib - Selalu tetapkan 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 depan) 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"
    }
  ]
}