Bu bölümde, izleme işlemlerinin ortak özelliklerine dair ayrıntılar sağlanmaktadır.
İşlem işaretleme özellikleri
Mülk | Beklenen tür | Açıklama |
---|---|---|
@type |
Metin | Zorunlu: Her zaman WatchAction olarak ayarlanır. |
target |
EntryPoint | Zorunlu: Çeşitli Google platformlarına yönelik derin bağlantıların haritasını sağlayan bir hedef nesne. |
target.@type |
Metin | Zorunlu: Her zaman EntryPoint olarak ayarlanır. |
target.urlTemplate |
URL | Zorunlu: Kullanıcıları uygulamanıza veya platformunuza yönlendirip içeriğin oynatılmasını başlatan bir derin bağlantı. |
target.inLanguage |
Metin | İsteğe bağlı: Serinin BCP 47 biçimindeki orijinal dili. |
target.actionPlatform |
Metin | Zorunlu: urlTemplate ile eşlenen platformlar. Medya İşlemleri aşağıdakileri destekler:
|
target.additionalProperty |
PropertyValue | Geçerliyse gerekli: Derin bağlantının ek özelliklerini temsil edecek özellik-değer çiftlerinin listesi. Buna şunlar dahildir:
|
actionAccessibilityRequirement |
ActionAccessSpecification | Zorunlu: İçeriğin erişim şartını açıklayan bir İşlem erişim spesifikasyonu nesnesi. İşlem Erişim Spesifikasyonu Özellikleri bölümüne bakın. |
İşlem işaretlemeyle ilgili sayfalar
Bu mülklerle ilgili konular için aşağıdaki sayfalara göz atın:
İşlem erişim spesifikasyonu özellikleri
Mülk | Beklenen tür | Açıklama |
---|---|---|
actionAccessibilityRequirement.@type |
Metin | Zorunlu: Her zaman ActionAccessSpecification olarak ayarlanır. |
actionAccessibilityRequirement.category |
Metin | Zorunlu: İçerik için erişim şartı. Daha fazla bilgi için Ödeme duvarı türü başlıklı makaleyi inceleyin. Bir öğe bir içerik grubunu temsil ediyorsa
|
actionAccessibilityRequirement.availabilityStarts |
Tarih | Zorunlu: İşlemin kullanılabileceği tarih (ISO 8601 biçiminde, saat dilimi dahil).
İlgili öğenin, availabilityStarts tarihinden en az 7 gün önce feed'de sağlanmış olması gerekir. Bu, içeriğin Google platformlarında zamanında gösterilme olasılığını artırır. |
actionAccessibilityRequirement.availabilityEnds |
Tarih | Zorunlu: İşlemin artık kullanılamayacağı tarih (ISO 8601 biçiminde, saat dilimi dahil).
müsaitlik bitiş tarihinde yapılacak güncellemelerin, müsaitlik bitiş tarihinden en az 7 gün önce feed'de yapılması gerekir. Bu, içeriğin availabilityEnds tarihinde Google platformlarında gösterilmesinin sona ermesi olasılığını artırır. |
actionAccessibilityRequirement.eligibleRegion |
Country, City, State, GeoShape veya Text | Zorunlu: İçeriğin kullanılabildiği bölgeler. İçerik dünya genelinde kullanılabiliyorsa EARTH özel dizesini kullanın. |
actionAccessibilityRequirement.ineligibleRegion |
Country, City, State veya GeoShape | Varsa gerekli: İçeriğin kısıtlandığı bölgeler. İçerik eligibleRegion içinde her yerde kullanılabiliyorsa bu özelliği sağlamanız gerekmez. |
actionAccessibilityRequirement.requiresSubscription |
MediaSubscription | Varsa zorunlu: Kullanıcıların içeriğe erişmek için ihtiyaç duyduğu abonelik ayrıntıları. Medya aboneliği mülkleri bölümüne bakın.
|
actionAccessibilityRequirement.expectsAcceptanceOf |
Teklif | İçerik için satın alma işlemi gerekiyorsa zorunludur: İçerikle ilişkili teklifin ayrıntıları. Aşağıdaki durumlar için fiyat bilgilerini sağlayın:
Offer nesnesini tamamen kaldırın ve ActionAccessSpecification nesnesinde category değerini free olarak ayarlayın. Özellik teklifi bölümüne bakın.
|
Medya aboneliği mülkleri
actionAccessibilityRequirement.category
subscription
veya externalSubscription
ise gereklidir.
Mülk | Beklenen tür | Açıklama |
---|---|---|
requiresSubscription.@type |
Metin | Zorunlu: Her zaman MediaSubscription değerine ayarlanır. |
requiresSubscription.@id |
URL | Zorunlu: Aboneliğin benzersiz kimliği. İçeriğe farklı abonelikler üzerinden erişilebiliyorsa her aboneliğin benzersiz bir kimliği olmalıdır. |
requiresSubscription.name |
Metin | Zorunlu: Aboneliğin adı. Aşağıdakilere dikkat edin:
|
requiresSubscription.sameAs |
URL | Aboneliği açıklayan sayfa. |
requiresSubscription.identifier |
Metin | category subscription VE commonTier false ise zorunludur
:
Bu abonelik için medya kataloğunuzdaki bir içerik grubuna erişimi temsil eden benzersiz bir dize.
|
requiresSubscription.authenticator |
Kuruluş | category externalsubscription ise gereklidir: Harici sağlayıcının kimlik doğrulayıcısının ayrıntılarını sağlayan bir kapsayıcı. |
requiresSubscription.authenticator.@type |
Metin | category externalsubscription ise zorunludur. Her zaman Organization olarak ayarlanır. |
requiresSubscription.authenticator.name |
Metin | category externalsubscription ise zorunludur: Kimlik doğrulama hizmetinin adı. TVE sağlayıcıları için TVE olarak ayarlayın. |
requiresSubscription.commonTier |
Boole | Geçerliyse zorunludur: Kategori "abonelik" olarak ayarlanmışsa bu özellik gereklidir. commonTier hakkında daha fazla bilgi edinmek için ortak katman koşulları dokümanlarını inceleyin. |
Entitlements API Şartları
actionAccessibilityRequirement.category
subscription
veya externalSubscription
ise ve abonelik teklifiniz birden fazla paket veya katman içeriyor ya da eklenti desteğine sahipse hak kazanma API'si gereklidir. Aboneliğiniz tek katmanlıysa ve kataloğunuzdaki tüm içeriklere erişim sağlıyorsa bunu eklemeyin.
- A şirketi, abone olan kullanıcılara mevcut tüm içeriklere erişim sağlayan tek bir abonelik teklifi sunar: Hak tanımlayıcısı / API gerekmez
- B şirketi, bazı içeriklere erişim sağlayan bir temel aboneliğe ve premium içeriğe erişim sağlayan bir premium aboneliğe sahiptir: Entitlement Identifier / API gereklidir
- C şirketi, bazı içeriklere erişim sağlayan bir temel aboneliğe ve üçüncü taraf içeriklerine erişim sağlayan eklenti paketlerine sahiptir: Tercih Tanımlayıcısı / API gereklidir
Medya aboneliğiyle ilgili sayfalar
Bu mülklerle ilgili konular için aşağıdaki sayfalara göz atın:
Teklif özellikleri
Mülk | Beklenen tür | Açıklama |
---|---|---|
expectsAcceptanceOf.@type |
Metin | Zorunlu: Her zaman Offer olarak ayarlanır. |
expectsAcceptanceOf.price |
Number | Zorunlu: İçeriğin satın alma fiyatı. Fiyat, sıfır olmayan pozitif bir değer olmalıdır. Fiyatı 0, 00 olan öğeler için lütfen kategoriyi "ücretsiz" olarak belirtin. |
expectsAcceptanceOf.priceCurrency |
Metin | Zorunlu: Fiyatın 3 harfli ISO 4217 biçimindeki para birimi. |
expectsAcceptanceOf.seller |
Kuruluş | İçerik satın alma olanağı sunan kuruluş. |
expectsAcceptanceOf.seller.@type |
Metin | Her zaman Organization olarak ayarlanır. |
expectsAcceptanceOf.seller.name |
Metin | Satıcının adı. |
expectsAcceptanceOf.seller.sameAs |
Metin | Satıcıyı tanımlayan bir web sayfasının URL'si (örneğin, satıcının ana sayfası). |
Teklifle ilgili sayfa
Bu mülklerle ilgili konular için aşağıdaki sayfalara göz atın:
Tanımlayıcılar
Medya işlemi feed'leri, bir öğeyi net bir şekilde tanımlamaya yardımcı olabilecek çeşitli tanımlayıcıları kabul eder. Bu tanımlayıcılar, feed'inizdeki içeriğin Google'ın veritabanlarındaki içerikle eşleştirilme sürecini hızlandırabilir. Bu tanımlayıcıların çoğu, çeşitli varlık türlerinde identifier
özelliği kullanılarak feed'e eklenebilir. Ancak EIDR'lerin kendi temsilci özellikleri vardır. Bu iki konu aşağıda ele alınmıştır.
Tanımlayıcı özellikleri
Mülk | Beklenen tür | Açıklama |
---|---|---|
identifier |
Metin | Yüksek Önerilir: Belirli bir öğeyi açık bir şekilde tanımlayan, genellikle harici bir tanımlayıcı. Birden fazla tanımlayıcıya izin verilir. Bu özellik, tüm İzleme İşlemi varlık türlerinde kullanılabilir. Aşağıdaki tabloda, kabul edilen tanımlayıcılar ve identifier mülkünün alt özellikleri listelenmektedir. İzleme İşlemi feed'i örnekleri bölümündeki Tanımlayıcı/EIDR örneğine bakın. |
Mülk | Beklenen tür | Açıklama |
---|---|---|
@type |
Metin | Zorunlu: Her zaman PropertyValue olarak ayarlanır. |
propertyID |
Metin | Zorunlu: Aşağıdaki kimlik türlerini destekleriz:
|
value |
Metin | Zorunlu: Belirtilen kimlik sisteminin değeri. |
EIDR mülkleri
EIDR (Eğlence Tanımlayıcı Kaydı'nın kısaltması), sinema filmleri ve televizyon programları da dahil olmak üzere çok çeşitli medya içerikleri için dünya genelinde benzersiz bir tanımlayıcı sistemidir. Tanımlama sistemi, bir tanımlayıcıyı üst düzey başlıklarla, düzenlemelerle ve daha fazlasıyla ilişkili bir meta veri kaydına çözer. Aşağıdaki tabloda, EIDR ile ilişkili özellikler ve bunların kullanımları listelenmiştir.
Mülk | Beklenen tür | Açıklama |
---|---|---|
titleEIDR |
Metin | Yüksek Önerilir: EIDR (Eğlence Tanımlayıcıları Kaydı) tanımlayıcısı, en genel/soyut düzeyde bir film veya televizyon eserini temsil eder. Bu mülk, TVSeries, TVSeason, TVEpisode ve Movie öğe spesifikasyonu sayfalarında kullanılabilir. Örneğin, "Ghostbusters" olarak bilinen sinema filminin titleEIDR değeri "10.5240/7EC7-228A-510A-053E-CBB8-J" şeklindedir. İzleme İşlemleri feed'i örnekleri bölümündeki Tanımlayıcı/EIDR örneğine bakın. |
editEIDR |
Metin | Yüksek Önerilir: EIDR (Eğlence Tanımlayıcı Kaydı) tanımlayıcısı, film veya televizyon eserinin belirli bir düzenlemesini/baskısını temsil eder. Bu özellik, TVEpisode ve Movie öğe spesifikasyonu sayfalarında kullanılabilir. Örneğin, "Ghostbusters" olarak bilinen ve titleEIDR değeri "10.5240/7EC7-228A-510A-053E-CBB8-J" olan sinema filminin birkaç düzenlemesi vardır (ör. "10.5240/1F2A-E1C5-680A-14C6-E76B-I" ve "10.5240/8A35-3BEE-6497-5D12-9E4F-3"). titleEIDR mülkü, editEIDR sağlandığında zorunludur.İzleme İşlemleri feed'i örnekleri bölümündeki Tanımlayıcı/EIDR örneğine bakın. |
İçerik derecelendirme kuruluşları
BroadcastService.contentRating
, Movie.contentRating
ve TVSeries.contentRating
için bu tablodaki değerleri kullanın. Derecelendirme kuruluşu, derecelendirme değerinin başına eklenmelidir. Örnekler:
- ABD'de "R" olarak derecelendirilen bir filmin
Movie.contentRating
değeri "MPAA R" olmalıdır. - ABD'de "TV-MA" derecelendirmesine sahip bir TV dizisinin
TVSeries.contentRating
değeri "TV_PG TV-MA" olmalıdır.
Ülke | TV derecelendirme kuruluşu | Film derecelendirme kuruluşu |
---|---|---|
Arnavutluk (AL) | Kullanılamıyor | Kullanılamıyor |
Angola (AO) | Kullanılamıyor | CCE |
Antigua ve Barbuda (AG) | Kullanılamıyor | MPAA |
Arjantin (AR) | INCAA | INCAA |
Ermenistan (AM) | Kullanılamıyor | MKRF/RUSYA |
Aruba (AW) | Kullanılamıyor | Kullanılamıyor |
Avustralya (AU) | ACB TV | ACB Filmler |
Avusturya (AT) | FSK | FSK |
Azerbaycan (AZ) | Kullanılamıyor | MKRF/RUSYA |
Bahreyn (BH) | Kullanılamıyor | MPAA |
Beyaz Rusya (BY) | Kullanılamıyor | MKRF/RUSYA |
Belçika (BE) | Kullanılamıyor | MPAA |
Belize (BZ) | Kullanılamıyor | Kullanılamıyor |
Benin (BJ) | Kullanılamıyor | CNC |
Bolivya (BO) | Kullanılamıyor | MPAA |
Bosna Hersek (BA) | Kullanılamıyor | MPAA |
Botsvana (BW) | Kullanılamıyor | MPAA |
Brezilya (BR) | CLASSIND | CLASSIND |
Burkina Faso (BF) | Kullanılamıyor | CNC |
Kamboçya (KH) | Kullanılamıyor | Kullanılamıyor |
Kanada (CA) | CA_TV | CHVRS |
Yeşil Burun Adaları (CV) | Kullanılamıyor | CCE |
Şili (CL) | Kullanılamıyor | MPAA |
Kolombiya (CO) | Kullanılamıyor | MPAA |
Kosta Rika (CR) | Kullanılamıyor | MPAA |
Hırvatistan (HR) | Kullanılamıyor | Kullanılamıyor |
Güney Kıbrıs Rum Yönetimi (CY) | Kullanılamıyor | GRFILM |
Çekya (CZ) | Kullanılamıyor | CZFILM |
Danimarka (DK) | Kullanılamıyor | MCCYP |
Ekvador (EC) | Kullanılamıyor | MPAA |
Mısır (EG) | Kullanılamıyor | MPAA |
El Salvador (SV) | Kullanılamıyor | MPAA |
Estonya (EE) | Kullanılamıyor | EEFILM |
Fiji (FJ) | Kullanılamıyor | Kullanılamıyor |
Finlandiya (FI) | Kullanılamıyor | MEKU |
Fransa (FR) | CSA | CSA |
Gabon (GA) | Kullanılamıyor | CNC |
Almanya (DE) | FSK | FSK |
Yunanistan (GR) | ESR | GRFILM |
Guatemala (GT) | Kullanılamıyor | MPAA |
Haiti (HT) | Kullanılamıyor | Kullanılamıyor |
Honduras (HN) | Kullanılamıyor | MPAA |
Hong Kong (HK) | CA | FCO |
Macaristan (HU) | Kullanılamıyor | MPAA |
İzlanda (IS) | Kullanılamıyor | KIJKWIJZER |
Hindistan (IN) | CBFC | CBFC |
Endonezya (ID) | KPI | LSF |
İrlanda (IE) | Kullanılamıyor | IFCO |
İtalya (IT) | AGCOM | AGCOM |
Fildişi Sahili (CI) | Kullanılamıyor | CNC |
Jamaika (JM) | Kullanılamıyor | MPAA |
Japonya (JP) | Yok | EIRIN |
Ürdün (JO) | Kullanılamıyor | MPAA |
Kazakistan (KZ) | Kullanılamıyor | MRKF |
Güney Kore (KR) | KMRB | KMRB |
Kuveyt (KW) | Kullanılamıyor | MPAA |
Kırgızistan (KG) | Kullanılamıyor | MKRF/RUSYA |
Laos (LA) | Kullanılamıyor | Kullanılamıyor |
Letonya (LV) | Kullanılamıyor | NKCLV |
Lübnan (LB) | Kullanılamıyor | MPAA |
Litvanya (LT) | Kullanılamıyor | Kullanılamıyor |
Lüksemburg (LU) | Kullanılamıyor | KIJKWIJZER |
Makedonya (MK) | Kullanılamıyor | MPAA |
Malezya (MY) | Kullanılamıyor | FCBM |
Mali (ML) | Kullanılamıyor | CNC |
Malta (MT) | Kullanılamıyor | MCCAA |
Mauritius (MU) | Kullanılamıyor | BBFC |
Meksika (MX) | RTC | RTC |
Moldova (MD) | Kullanılamıyor | Kullanılamıyor |
Namibya (NA) | Kullanılamıyor | Kullanılamıyor |
Nepal (NP) | Kullanılamıyor | MPAA |
Hollanda (NL) | KIJKWIJZER | KIJKWIJZER |
Yeni Zelanda (NZ) | BSA | OFLC |
Nikaragua (NI) | Kullanılamıyor | MPAA |
Nijer (NE) | Kullanılamıyor | CNC |
Norveç (NO) | Kullanılamıyor | MEDIETILSYNET |
Umman (OM) | Kullanılamıyor | MPAA |
Panama (PA) | Kullanılamıyor | MPAA |
Papua Yeni Gine (PG) | Kullanılamıyor | MPAA |
Paraguay (PY) | Kullanılamıyor | MPAA |
Peru (PE) | Kullanılamıyor | MPAA |
Filipinler (PH) | MTRCB | MTRCB |
Polonya (PL) | Kullanılamıyor | MPAA |
Portekiz (PT) | Kullanılamıyor | CCE |
Katar (QA) | Kullanılamıyor | MPAA |
Rusya (RU) | MKRF/RUSYA | MKRF/RUSYA |
Ruanda (RW) | Kullanılamıyor | CNC |
Suudi Arabistan (SA) | Kullanılamıyor | MPAA |
Senegal (SN) | Kullanılamıyor | MPAA |
Singapur (SG) | Kullanılamıyor | MDA |
Slovakya (SK) | Kullanılamıyor | MPAA |
Slovenya (SI) | Kullanılamıyor | MPAA |
Güney Afrika (ZA) | FPB | FPB |
İspanya (ES) | SETSI | ICAA |
Sri Lanka (LK) | Kullanılamıyor | Kullanılamıyor |
İsveç (SE) | Kullanılamıyor | SMSA |
İsviçre (CH) | FSK | FSK |
Tayvan (TW) | Kullanılamıyor | MOCTW |
Tacikistan (TJ) | Kullanılamıyor | MKRF/RUSYA |
Tanzanya (TZ) | Kullanılamıyor | MPAA |
Tayland (TH) | Kullanılamıyor | BFVC |
Togo (TG) | Kullanılamıyor | CNC |
Trinidad ve Tobago (TT) | Kullanılamıyor | Kullanılamıyor |
Türkiye (TR) | RTÜK | ECBMCT |
Türkmenistan (TM) | Kullanılamıyor | MKRF/RUSYA |
Uganda (UG) | Kullanılamıyor | MPAA |
Ukrayna (UA) | Kullanılamıyor | Kullanılamıyor |
Birleşik Arap Emirlikleri (AE) | Kullanılamıyor | MPAA |
İngiltere (GB) | BBFC | BBFC |
Amerika Birleşik Devletleri (US) | TV_PG | MPAA |
Uruguay (UY) | Kullanılamıyor | MPAA |
Özbekistan (UZ) | Kullanılamıyor | MKRF/RUSYA |
Venezuela (VE) | Kullanılamıyor | RESORTEVIOLENCIA |
Vietnam (VN) | Kullanılamıyor | MCST |
Zambiya (ZM) | Kullanılamıyor | MPAA |
Zimbabve (ZW) | Kullanılamıyor | MPAA |
GeoShape özellikleri
GeoShape nesnesi aşağıdaki veri türlerinden birini içerir:
- Posta kodları listesi (ör. ABD, Kanada veya diğer posta kodları)
- Kanada'daki yönlendirme ayırma bölgelerinin listesi
- Tanımlanmış Pazar Alanı (DMA) Kimliği: ABD'de kullanıcıların aynı televizyon kanallarını ve programlarını aldığı bir bölgenin tanımlayıcısıdır.
Mülk | Beklenen tür | Açıklama |
---|---|---|
@id |
URL | Zorunlu: Coğrafi bölgenin URI biçimindeki tanımlayıcısıdır. |
@type |
Metin | Zorunlu: Her zaman GeoShape olarak ayarlanır. |
addressCountry |
Metin | Zorunlu: İki harfli ISO 3166-1 alfa-2 ülke kodu. |
postalCode |
Metin | İsteğe bağlı: Bir veya daha fazla posta kodu ve/veya FSA (adres sıralama bölgesi) kodunun listesi. |
identifier |
PropertyValue | İsteğe bağlı: ABD'de kullanıcıların aynı televizyon kanallarını ve programlarını aldığı bir bölgenin tanımlayıcısı olan Tanımlanmış Pazar Alanı (TPA) kimliği. |
identifier.@type |
Metin | Zorunlu: Her zaman PropertyValue olarak ayarlanır. |
identifier.propertyID |
Metin | Zorunlu: Her zaman DMA_ID olarak ayarlanır. |
identifier.value |
Metin | Zorunlu: Bölgenin TPA kodu. |
Posta kodlarının listesini içeren GeoShape
nesnesi örneği:
{
"@type": "GeoShape",
"@id": "http://example.com/area1",
"addressCountry": "US",
"postalCode": [
"94118",
"94119"
]
}
FSA (adres sıralama bölgesi) ve posta kodlarının bir kombinasyonunu içeren GeoShape
nesnesi örneği:
{
"@type": "GeoShape",
"@id": "http://example.com/area2",
"addressCountry": "CA",
"postalCode": [
"1A1",
"K1A",
"K1AOB1"
]
}
DMA kimliği içeren GeoShape
nesnesi örneği:
{
"@type": "GeoShape",
"@id": "http://example.com/area3",
"addressCountry": "US",
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "DMA_ID",
"value": "501"
}
]
}