Bu bölümde, İzleme İşlemleri'nin ortak özellikleri hakkında ayrıntılı bilgi verilmektedir.
İşlem işaretleme özellikleri
Mülk | Beklenen tür | Açıklama |
---|---|---|
@type |
Metin | Zorunlu: Her zaman WatchAction olarak ayarlayın. |
target |
EntryPoint | Zorunlu: Çeşitli Google platformlarına derin bağlantıların eşlemesini sağlayan bir hedef nesne. |
target.@type |
Metin | Zorunlu: Her zaman EntryPoint olarak ayarlayın. |
target.urlTemplate |
URL | Zorunlu: Kullanıcıları uygulamanıza veya platformunuza yönlendiren ve içeriğin oynatılmasını başlatan bir derin bağlantı. |
target.inLanguage |
Metin | İsteğe bağlı: Dizinin BCP 47 biçimindeki orijinal dili. |
target.actionPlatform |
Metin | Zorunlu: urlTemplate ile eşlenen platformlar. Medya İşlemleri aşağıdaki özellikleri destekler:
|
target.additionalProperty |
PropertyValue | Geçerliyse zorunlu: Derin bağlantının ek özelliklerini temsil eden özellik-değer çiftlerinin listesi. Bu bilgiler arasında şunlar yer alabilir:
|
actionAccessibilityRequirement |
ActionAccessSpecification | Zorunlu: İçeriğin erişim şartını açıklayan bir Action access specification object. Action Access Specification Properties bölümüne bakın. |
İşlem işaretlemesiyle ilgili sayfalar
Bu mülklerle ilgili konular için aşağıdaki sayfalara göz atın:
İşlem erişimi spesifikasyon özellikleri
Mülk | Beklenen tür | Açıklama |
---|---|---|
actionAccessibilityRequirement.@type |
Metin | Zorunlu: Her zaman ActionAccessSpecification olarak ayarlayın. |
actionAccessibilityRequirement.category |
Metin | Zorunlu: İçeriğe erişmek için gereken koşul. 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 (saat dilimi dahil) ISO 8601 biçiminde.
İlgili öğenin, feed'de availabilityStarts tarihinden en az 7 gün önce sağlanması gerekir. Bu sayede, içeriğin Google platformlarında zamanında gösterilme olasılığı artar. |
actionAccessibilityRequirement.availabilityEnds |
Tarih | Zorunlu: İşlemin artık kullanılamayacağı tarih (saat dilimi dahil) ISO 8601 biçiminde.
availabilityEnds tarihine yönelik güncellemelerin, availabilityEnds tarihinden en az 7 gün önce feed'de yapılması gerekir. Bu, içeriğin Google platformlarında gösterilmesinin availabilityEnds tarihinde durdurulma 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 |
Ülke, Şehir, Eyalet veya GeoShape | Varsa zorunlu: İç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 | Geçerliyse zorunlu: Kullanıcıların içeriğe erişmek için ihtiyaç duyduğu abonelikle ilgili ayrıntılar. Medya aboneliği özellikleri bölümüne bakın.
|
actionAccessibilityRequirement.expectsAcceptanceOf |
Teklif | İçerik satın alma işlemi gerektiriyorsa zorunludur: İçerikle ilişkili teklifin ayrıntıları. Aşağıdaki durumlarda fiyat bilgilerini sağlayın:
Offer nesnesini tamamen kaldırın ve ActionAccessSpecification nesnesindeki category değerini free olarak ayarlayın. Teklif özellikleri konusuna bakın.
|
actionAccessibilityRequirement.additionalProperty |
PropertyValue | Geçerliyse zorunlu: Deneyimde gösterilecek abonelik paketine referans. |
actionAccessibilityRequirement.additionalProperty.name |
Metin | Zorunlu: Her zaman "DisplaySubscriptionIdentifier" olarak ayarlanır. |
actionAccessibilityRequirement.additionalProperty.value |
Metin | Zorunlu: Tüzel kişi için gösterilecek requiresSubscription.@id .
|
Medya aboneliği özellikleri
actionAccessibilityRequirement.category
, subscription
veya externalSubscription
ise gereklidir.
Mülk | Beklenen tür | Açıklama |
---|---|---|
requiresSubscription.@type |
Metin | Zorunlu: Her zaman MediaSubscription olarak 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 zorunlu
-
Bu abonelik için, medya kataloğunuzdaki bir içerik grubuna erişimi temsil eden benzersiz bir dize.
|
requiresSubscription.authenticator |
Kuruluş | category değeri externalsubscription ise zorunludur: 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 ayarlayın. |
requiresSubscription.authenticator.name |
Metin | category ise zorunluexternalsubscription : Kimlik doğrulama hizmetinin adı. TVE sağlayıcıları için TVE olarak ayarlayın. |
requiresSubscription.commonTier |
Boole | Geçerliyse zorunlu: Kategori "abonelik" olarak ayarlanmışsa bu özellik zorunludur. commonTier hakkında daha fazla bilgiyi ortak katman koşulları dokümanında bulabilirsiniz. |
Entitlement API Gereksinimleri
actionAccessibilityRequirement.category
, subscription
veya externalSubscription
ise ve abonelik teklifiniz birden fazla paket ya da katman içeriyorsa veya eklenti desteği varsa yetkilendirme API'si gereklidir. Aboneliğiniz tek katmanlıysa ve kataloğunuzdaki tüm içeriklere erişim sağlıyorsa bu bilgiyi eklemeyin.
- A Şirketi, abone olan kullanıcılara mevcut tüm içeriklere erişim izni veren tek bir abonelik teklifine sahiptir: Hak Kimliği / API gerekli değildir.
- B Şirketi'nin bazı içeriklere erişim sağlayan bir temel aboneliği ve premium içeriklere erişim sağlayan bir premium aboneliği var: Hak Kimliği / API gereklidir.
- C şirketi, bazı içeriklere erişim sağlayan temel bir aboneliğe ve üçüncü taraf içeriklerine erişim sağlayan eklenti paketlerine sahiptir: Hak Tanımlayıcı / 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 ayarlayın. |
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 teklifinde bulunan 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 İşlemi feed'leri, bir öğenin net bir şekilde tanımlanmasına 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ştirilmesi sürecini hızlandırmaya yardımcı olabilir. Bu tanımlayıcıların çoğu, çeşitli öğe türlerinde identifier
özelliği kullanılarak feed'e eklenebilse de EIDR'lerin kendi temsili özelliği vardır. Bu iki durum aşağıda ele alınmıştır.
Tanımlayıcı özellikleri
Mülk | Beklenen tür | Açıklama |
---|---|---|
identifier |
Metin | Şiddetle Tavsiye Edilir: Genellikle harici olan ve belirli bir öğeyi net bir şekilde tanımlayan 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, identifier özelliğinin kabul edilen tanımlayıcıları ve alt özellikleri listelenmektedir. İzleme İşlemleri feed'i örnekleri bölümündeki Tanımlayıcı/EIDR örneği'ne bakın. |
Mülk | Beklenen tür | Açıklama |
---|---|---|
@type |
Metin | Zorunlu: Her zaman PropertyValue olarak ayarlayın. |
propertyID |
Metin | Gerekli: Aşağıdaki kimlik türlerini destekliyoruz:
|
value |
Metin | Zorunlu: Belirtilen kimlik sisteminin değeri. |
EIDR özellikleri
EIDR (The Entertainment Identifier Registry'nin kısaltması), sinema filmleri ve televizyon programları da dahil olmak üzere çok çeşitli medya içerikleri için global olarak benzersiz bir tanımlayıcı sistemidir. Tanımlama sistemi, bir tanımlayıcıyı üst düzey başlıklar, düzenlemeler ve daha fazlasıyla ilişkili bir meta veri kaydına dönüştürür. Aşağıdaki tabloda, EIDR ile ilişkili özellikler ve bunların kullanımları listelenmektedir.
Mülk | Beklenen tür | Açıklama |
---|---|---|
titleEIDR |
Metin | Şiddetle Tavsiye Edilir: EIDR (Entertainment Identifier Registry) tanımlayıcısı, en genel/soyut düzeyde bir film veya televizyon yapımını temsil eder. Bu özellik TVSeries, TVSeason, TVEpisode ve Movie öğe spesifikasyon sayfalarında kullanılabilir. Örneğin, "Hayalet Avcıları" olarak bilinen sinema filminin titleEIDR'si "10.5240/7EC7-228A-510A-053E-CBB8-J"dir. İzleme işlemleri feed'i örnekleri bölümündeki Tanımlayıcı/EIDR örneği'ne bakın. |
editEIDR |
Metin | Şiddetle Tavsiye Edilir: EIDR (Entertainment Identifier Registry) tanımlayıcısı, bir 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, "10.5240/7EC7-228A-510A-053E-CBB8-J" titleEIDR'sine sahip "Hayalet Avcıları" adlı sinema filminin "10.5240/1F2A-E1C5-680A-14C6-E76B-I" ve "10.5240/8A35-3BEE-6497-5D12-9E4F-3" gibi çeşitli düzenlemeleri vardır. titleEIDR özelliği, editEIDR sağlandığında zorunludur.İzleme İşlemleri feed'i örnekleri bölümündeki Tanımlayıcı/EIDR örneği'ne bakın. |
İçerik derecelendirme kuruluşları
BroadcastService.contentRating
, Movie.contentRating
ve TVSeries.contentRating
için bu tablodaki değerleri kullanın. Derecelendirme değeri, derecelendirme kuruluşunun adıyla başlamalıdır. Örnekler:
- ABD'de "R" derecelendirmesi alan bir filmin
Movie.contentRating
değeri "MPAA R" olmalıdır. - ABD'de "TV-MA" olarak derecelendirilen bir TV dizisinin
TVSeries.contentRating
değeri "TV_PG TV-MA" olmalıdır.
Ülke | TV derecelendirme kuruluşu | Film derecelendirme kurumu |
---|---|---|
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 Movies |
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 |
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 (örneğin, ABD, Kanada veya diğer posta kodları)
- Kanada'daki posta kodu bölgelerinin listesi
- Tanımlanmış Pazar Alanı (TPA) Kimliği: ABD'de insanların aynı televizyon kanallarını ve programlarını aldığı bir bölgenin tanımlayıcısı.
Mülk | Beklenen tür | Açıklama |
---|---|---|
@id |
URL | Zorunlu: URI biçiminde coğrafi bölgenin tanımlayıcısı. |
@type |
Metin | Zorunlu: Her zaman GeoShape olarak ayarlayın. |
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) kodu listesi. |
identifier |
PropertyValue | İsteğe bağlı: ABD'de insanları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 ayarlayın. |
identifier.propertyID |
Metin | Zorunlu: Her zaman DMA_ID olarak ayarlayın. |
identifier.value |
Metin | Zorunlu: Bölgenin DMA kodu. |
Posta kodu listesi 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 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"
}
]
}