Bu bölümde, İzleme İşlemleri'nin genel özellikleriyle ilgili ayrıntılar yer almaktadır.
İşlem işaretleme özellikleri
Özellik | Beklenen tür | Açıklama |
---|---|---|
@type |
Metin | Zorunlu: Her zaman WatchAction değerine ayarlanır. |
target |
EntryPoint | Gerekli: Şu özelliklere sahip bir hedef nesne: eşlemeyi sağlayan derin bağlantılarıyla çeşitli Google platformlarının bağlantılarını içerir. |
target.@type |
Metin | Zorunlu: Her zaman EntryPoint değerine ayarlanır. |
target.urlTemplate |
URL | Zorunlu - A derin bağlantıyı tıklayın. Bu bağlantı, kullanıcıları uygulamanıza veya platformunuza yönlendiren içeriği oynatır. |
target.inLanguage |
Metin | İsteğe bağlı: Dizinin orijinal dili BCP 47 biçimindedir. |
target.actionPlatform |
Metin | Zorunlu: Eşlenen platformlar
urlTemplate . Medya İşlemleri şunları destekler:
|
target.additionalProperty |
PropertyValue | Varsa gerekli:
derin bağlantının ek özelliklerini temsil eder. Bu,
takip etmek için:
|
actionAccessibilityRequirement |
ActionAccessSpecification | Zorunlu: İşlem şunun erişim gereksinimini açıklayan bir erişim özelliği nesnesi: daha iyi olur. Bkz. İşlem Spesifikasyon Özellikleri'ne erişin. |
İşlem işaretleme ile ilgili sayfalar
Bu tesislerle ilgili konular için aşağıdaki sayfalara göz atın:
İşlem erişimi spesifikasyonu özellikleri
Özellik | Beklenen tür | Açıklama |
---|---|---|
actionAccessibilityRequirement.@type |
Metin | Zorunlu: Her zaman ActionAccessSpecification değerine ayarlanır. |
actionAccessibilityRequirement.category |
Metin | Zorunlu: İçerik için bir erişim gereksinimidir. Daha fazla bkz. Ödeme duvarı türü. Bir öğe bir içerik grubunu temsil ediyorsa
Şuna en az kısıtlayıcı erişim şartı:
|
actionAccessibilityRequirement.availabilityStarts |
Tarih | Zorunlu: İşlemin sunulacağı tarihten sonra ISO 8601 biçimi (saat dilimi dahil).
İlgili varlığın, feed'de kullanıma sunulma tarihinden en az 7 gün önce. Bu da Google platformlarında zamanında gösterilme olasılığını artırır. |
actionAccessibilityRequirement.availabilityEnds |
Tarih | Zorunlu: İşlemin artık kullanılamadığı tarih.
ISO'da
8601 biçimi (saat dilimi dahil).
availabilityEnds tarihindeki tüm güncellemelerin yapılması gerekir. onay kutusunu işaretleyin. Bu içeriğin Google'da görünme şansını artırır. kullanıma sunulacak. |
actionAccessibilityRequirement.eligibleRegion |
Ülke, Şehir, Eyalet, GeoShape veya Metin | Zorunlu: İçeriğin kullanıma sunulduğu bölgeler. Şunu kullanın:
İçerik dünya genelinde kullanıma sunuluyorsa EARTH özel dizesi. |
actionAccessibilityRequirement.ineligibleRegion |
Ülke, Şehir, Eyalet veya GeoShape | Geçerliyse gerekli: İçeriğin bulunduğu bölgeler
kısıtlanmış durumda. İçeriğin aşağıdaki durumlarda olması halinde bu özelliği sağlamanız gerekmez:
eligibleRegion içinde her yerden erişilebilir. |
actionAccessibilityRequirement.requiresSubscription |
MediaSubscription | Varsa gerekli - abonelik satın almalarıdır. Görüntüleyin Medya aboneliği özellikleri.
|
actionAccessibilityRequirement.expectsAcceptanceOf |
Teklif | İçeriğin satın alınması gerekiyorsa gereklidir -
içerikle ilişkili tekliftir. Şu ürün için fiyat bilgilerini sağlayın:
şu durumlardan biridir:
Offer nesnesini tamamen kaldırın ve ActionAccessSpecification nesnesindeki category öğesini free olarak ayarlayın. Görüntüleyin
Teklif mülkleri.
|
Medya aboneliği özellikleri
actionAccessibilityRequirement.category
şu durumda gereklidir:
subscription
veya externalSubscription
.
Özellik | Beklenen tür | Açıklama |
---|---|---|
requiresSubscription.@type |
Metin | Zorunlu: Her zaman MediaSubscription olarak ayarlanır |
requiresSubscription.@id |
URL | Gerekli: Aboneliğin benzersiz kimliği. İçerik farklı abonelikler yoluyla erişilebilir; her abonelik benzersiz bir kimlik. |
requiresSubscription.name |
Metin | Gerekli: Aboneliğin adı. Aşağıdakilere dikkat edin:
|
requiresSubscription.sameAs |
URL | Aboneliğin açıklandığı sayfa. |
requiresSubscription.identifier |
Metin | category değeri subscription ise VE
commonTier değeri: false
-
Bu aboneliğe ait, medya kataloğunuzdaki bir içerik grubuna erişimi temsil eden benzersiz bir dize.
|
requiresSubscription.authenticator |
Kuruluş | category
externalsubscription -
Harici sağlayıcının kimlik doğrulayıcı ayrıntıları. |
requiresSubscription.authenticator.@type |
Metin | category
externalsubscription - Her zaman şuna ayarla:
Organization . |
requiresSubscription.authenticator.name |
Metin | category
externalsubscription : Kimlik doğrulamanın adı
geliştirmenizi sağlar. TVE sağlayıcıları için bunu TVE olarak ayarlayın. |
requiresSubscription.commonTier |
Boole | Geçerliyse gereklidir - Kategori şu şekilde ayarlanmışsa gereklidir: abonelik. CommonTier hakkında daha fazla bilgiyi şuradan edinebilirsiniz: genel katman koşulları belgelerinden birini kullanın. |
Yararlanma Hakkı API'sı Şartları
entitlement API
actionAccessibilityRequirement.category
subscription
veya
externalSubscription
ve abonelik teklifinizde birden fazla
paket veya katman ya da eklenti desteğine sahip. Örneğin,
abonelik tek katmanlıdır ve kataloğunuzdaki tüm içeriklere erişim sunar.
- A şirketinin, abone olan kullanıcılara tüm mevcut içeriğe erişim: Yararlanma Hakkı Tanımlayıcısı / API'si değildir zorunlu
- B şirketinin bazı içeriklere erişim sağlayan temel bir aboneliği premium içeriğe erişim sağlayan premium abonelik: Yararlanma Hakkı Tanımlayıcısı / API gereklidir
- C şirketinin bazı içeriklere erişim sağlayan temel bir aboneliği üçüncü taraf içeriklerine erişim sağlayan paketler ekleme: Yararlanma Hakkı Tanımlayıcısı / API gereklidir
Medya aboneliğiyle ilgili sayfalar
Bu tesislerle ilgili konular için aşağıdaki sayfalara göz atın:
Teklif özellikleri
Özellik | Beklenen tür | Açıklama |
---|---|---|
expectsAcceptanceOf.@type |
Metin | Zorunlu: Her zaman Offer değerine ayarlanır. |
expectsAcceptanceOf.price |
Number | Zorunlu: İçeriğin satın alma fiyatı. Fiyat sıfır olmayan bir pozitif değer olmalıdır. Fiyatı 0, 00 olan varlıklar için lütfen kategoriyi "ücretsiz" olarak belirtin. |
expectsAcceptanceOf.priceCurrency |
Metin | Zorunlu: Fiyatın 3 harfli para birimi ISO 4217 biçimindedir. |
expectsAcceptanceOf.seller |
Kuruluş | İçerik satın alma imkanı sunan kuruluş. |
expectsAcceptanceOf.seller.@type |
Metin | Her zaman Organization seçeneğine ayarla. |
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ına erişebilir. |
Teklifle ilgili sayfa
Bu tesislerle ilgili konular için aşağıdaki sayfalara göz atın:
Tanımlayıcılar
Medya İşlemi feed'leri, bir reklamın tespit edilmesine yardımcı olabilecek
açık bir şekilde kullanmanız gerekir. Bu tanımlayıcılar
içeriği ile Google'ın
veri tabanları. Bu tanımlayıcıların çoğu feed'e
Çeşitli varlık türlerinde identifier
mülk var, EIDR'lerin kendi özelliği var
temsil eder. Bunların her ikisi de aşağıda ele alınmaktadır.
Tanımlayıcı özellikleri
Özellik | Beklenen tür | Açıklama |
---|---|---|
identifier |
Metin | Önemle Tavsiye Edilir: Belirli bir öğeyi açık bir şekilde tanımlayan bir tanımlayıcı (genellikle harici bir tanımlayıcı). Birden fazla tanımlayıcıya izin verilir. Bu özellik, tüm İzleme İşlemi öğe türlerinde kullanılabilir. Aşağıdaki tabloda identifier mülkünün kabul edilen tanımlayıcıları ve alt özellikleri listelenmiştir. İzleme İşlemleri feed örnekleri bölümünde Tanımlayıcı/EIDR örneği bölümüne bakın. |
Özellik | Beklenen tür | Açıklama |
---|---|---|
@type |
Metin | Zorunlu: Her zaman PropertyValue değerine ayarlanır. |
propertyID |
Metin | Zorunlu: Aşağıdaki kimlik türleri desteklenir:
|
value |
Metin | Gerekli: Belirtilen kimlik sisteminin değeri. |
EIDR özellikleri
EIDR (The Entertainment Identifier Registry'nin kısaltması), hareketli resimler ve televizyon programları dahil olmak üzere geniş bir medya içeriği yelpazesi için küresel 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şkilendirilmiş 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.
Özellik | Beklenen tür | Açıklama |
---|---|---|
titleEIDR |
Metin | Önemle Tavsiye Edilir: EIDR (Eğlence Tanımlayıcı Kaydı) tanımlayıcısı, en genel/soyut düzeyde bir film veya televizyon eserini temsil eder. Bu özellik TVSeries, TVSeason, TVEpisode ve Movie öğe teknik özellikleri sayfalarında kullanılabilir. Örneğin, "Ghostbusters" olarak bilinen film için titleEIDR "10.5240/7EC7-228A-510A-053E-CBB8-J". İzleme İşlemleri feed örnekleri bölümündeki Tanımlayıcı/EIDR örneği bölümüne bakın. |
editEIDR |
Metin | Önemle Tavsiye Edilir: EIDR (Eğlence Tanımlayıcı Kaydı) tanımlayıcısı, bir film veya televizyon eserinin belirli bir düzenlemeyi/sürümünü temsil eder. Bu özellik, TVEpisode'da ve Film öğesi spesifikasyon sayfalarında kullanılabilir. Örneğin, "Hayalet Avcıları" olarak bilinen sinema adlı kişinin EIDR'si "10.5240/7EC7-228A-510A-053E-CBB8-J" olan, çeşitli düzenlemeler içeriyor, ör. "10.5240/1F2A-E1C5-680A-14C6-E76B-I" ve "10.5240/8A35-3BEE-6497-5D12-9E4F-3". editEIDR sağlandığında titleEIDR özelliği gereklidir.İzleme İşlemleri feed örnekleri bölümünde Tanımlayıcı/EIDR örneği bölümüne bakın. |
İçerik derecelendirme ajansları
BroadcastService.contentRating
, Movie.contentRating
ve TVSeries.contentRating
için bu tablodaki değerleri kullanın. Derecelendirme ajansı, puan değerinin başına eklenmelidir. Örnekler:
- "R" derecelendirmesine sahip bir film ABD'deki
Movie.contentRating
değeri "MPAA R" olmalıdır. - "TV-MA" olarak derecelendirilen bir TV dizisi
TVSeries.contentRating
değeri "TVPG TV-MA" olmalıdır.
Ülke | TV derecelendirme kurumu | 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/RUSSIA |
Aruba (AW) | Kullanılamıyor | Kullanılamıyor |
Avustralya (AU) | ACB TV | ACB Filmleri |
Avusturya (AT) | FSK | FSK |
Azerbaycan (AZ) | Kullanılamıyor | MKRF/RUSSIA |
Bahreyn (BH) | Kullanılamıyor | MPAA |
Beyaz Rusya (BY) | Kullanılamıyor | MKRF/RUSSIA |
Belçika (BE) | Kullanılamıyor | MPAA |
Beliz (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) | SINIFLANDIRMA | SINIFLANDIRMA |
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 |
Fijice (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/RUSSIA |
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 |
Morityus (MU) | Kullanılamıyor | İTŞ |
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/RUSSIA | MKRF/RUSSIA |
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/RUSSIA |
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/RUSSIA |
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) | İTŞ | İTŞ |
Amerika Birleşik Devletleri (US) | TV_PG | MPAA |
Uruguay (UY) | Kullanılamıyor | MPAA |
Özbekistan (UZ) | Kullanılamıyor | MKRF/RUSSIA |
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
Bir GeoShape nesnesi aşağıdaki veri türlerinden birini içerir:
- Posta kodlarının listesi (örneğin, ABD, Kanada veya diğer posta kodları)
- Kanada'da ileriye yönelik sıralama bölgelerinin listesi
- Tanımlanmış Pazar Alanı (TPA) kimliği: ABD'de kullanıcıların aynı televizyon kanallarını ve programları aldığı bir bölgenin tanımlayıcısı.
Özellik | Beklenen tür | Açıklama |
---|---|---|
@id |
URL | Gerekli: URI biçimindeki coğrafi bölge tanımlayıcısı. |
@type |
Metin | Zorunlu: Her zaman GeoShape değerine ayarlanır. |
addressCountry |
Metin | Zorunlu: İki harfli ISO 3166-1 alpha-2 ülke kodu. |
postalCode |
Metin | İsteğe bağlı: Bir veya daha fazla posta kodu ve/veya FSA (yönlendirme sıralama alanı) kodu listesi. |
identifier |
PropertyValue | İsteğe bağlı - A Tanımlanmış Pazar Alanı (TPA) Kimliği: alan adı numarasında bulunan ve müşterilerin aynı televizyon kanalları ve programları. |
identifier.@type |
Metin | Zorunlu: Her zaman PropertyValue değerine ayarlanır. |
identifier.propertyID |
Metin | Zorunlu: Her zaman DMA_ID değerine ayarlanır. |
identifier.value |
Metin | Zorunlu: Bölgenin DMA 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 (yönlendirme sıralama alanı) 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"
}
]
}