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:
|
target.additionalProperty |
PropertyValue | Wajib jika berlaku - Daftar pasangan nilai properti untuk
mewakili properti tambahan deep link. Hal ini dapat mencakup
hal berikut:
|
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
|
actionAccessibilityRequirement.availabilityStarts |
Tanggal | Wajib - Tanggal tersedianya tindakan, dalam format ISO 8601 (termasuk zona waktu).
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).
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.
|
actionAccessibilityRequirement.expectsAcceptanceOf |
Penawaran | Wajib jika konten memerlukan pembelian - Detail
penawaran yang terkait dengan konten. Berikan informasi harga untuk
kasus berikut:
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:
|
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.
|
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:
|
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"
}
]
}