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:
|
target.additionalProperty |
PropertyValue | Wajib jika berlaku - Daftar pasangan nilai properti untuk
mewakili properti tambahan deep link. Hal ini dapat mencakup
hal berikut:
|
actionAccessibilityRequirement |
ActionAccessSpecification | Wajib - Objek spesifikasi akses Action yang menjelaskan persyaratan akses konten. Lihat Properti Spesifikasi Akses Action. |
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 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
|
actionAccessibilityRequirement.availabilityStarts |
Date | Wajib - Tanggal batas tersedianya tindakan, dalam format ISO 8601 (termasuk zona waktu).
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).
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.
|
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 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:
|
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.
|
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
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 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:
|
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:
- Daftar kode pos (misalnya, kode pos Amerika Serikat, Kanada, atau lainnya)
- Daftar area penyortiran maju Kanada
- ID Designated Market Area (DMA) - 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 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"
}
]
}